1*b1cdbd2cSJim Jagielski /************************************************************** 2*b1cdbd2cSJim Jagielski * 3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 5*b1cdbd2cSJim Jagielski * distributed with this work for additional information 6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 10*b1cdbd2cSJim Jagielski * 11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 12*b1cdbd2cSJim Jagielski * 13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 18*b1cdbd2cSJim Jagielski * under the License. 19*b1cdbd2cSJim Jagielski * 20*b1cdbd2cSJim Jagielski *************************************************************/ 21*b1cdbd2cSJim Jagielski 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim Jagielski #ifndef INCLUDED_unotools_DYNAMICMENUOPTIONS_HXX 24*b1cdbd2cSJim Jagielski #define INCLUDED_unotools_DYNAMICMENUOPTIONS_HXX 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 27*b1cdbd2cSJim Jagielski // includes 28*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 29*b1cdbd2cSJim Jagielski 30*b1cdbd2cSJim Jagielski #include "unotools/unotoolsdllapi.h" 31*b1cdbd2cSJim Jagielski #include <sal/types.h> 32*b1cdbd2cSJim Jagielski #include <osl/mutex.hxx> 33*b1cdbd2cSJim Jagielski #include <com/sun/star/uno/Sequence.h> 34*b1cdbd2cSJim Jagielski #include <com/sun/star/beans/PropertyValue.hpp> 35*b1cdbd2cSJim Jagielski #include <unotools/options.hxx> 36*b1cdbd2cSJim Jagielski 37*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 38*b1cdbd2cSJim Jagielski // types, enums, ... 39*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 40*b1cdbd2cSJim Jagielski 41*b1cdbd2cSJim Jagielski /*-************************************************************************************************************//** 42*b1cdbd2cSJim Jagielski @descr The method GetList() returns a list of property values. 43*b1cdbd2cSJim Jagielski Use follow defines to seperate values by names. 44*b1cdbd2cSJim Jagielski *//*-*************************************************************************************************************/ 45*b1cdbd2cSJim Jagielski #define DYNAMICMENU_PROPERTYNAME_URL ::rtl::OUString(RTL_CONSTASCII_USTRINGPARAM("URL" )) 46*b1cdbd2cSJim Jagielski #define DYNAMICMENU_PROPERTYNAME_TITLE ::rtl::OUString(RTL_CONSTASCII_USTRINGPARAM("Title" )) 47*b1cdbd2cSJim Jagielski #define DYNAMICMENU_PROPERTYNAME_IMAGEIDENTIFIER ::rtl::OUString(RTL_CONSTASCII_USTRINGPARAM("ImageIdentifier" )) 48*b1cdbd2cSJim Jagielski #define DYNAMICMENU_PROPERTYNAME_TARGETNAME ::rtl::OUString(RTL_CONSTASCII_USTRINGPARAM("TargetName" )) 49*b1cdbd2cSJim Jagielski 50*b1cdbd2cSJim Jagielski /*-************************************************************************************************************//** 51*b1cdbd2cSJim Jagielski @descr You can use these enum values to specify right menu if you call our interface methods. 52*b1cdbd2cSJim Jagielski *//*-*************************************************************************************************************/ 53*b1cdbd2cSJim Jagielski enum EDynamicMenuType 54*b1cdbd2cSJim Jagielski { 55*b1cdbd2cSJim Jagielski E_NEWMENU = 0, 56*b1cdbd2cSJim Jagielski E_WIZARDMENU = 1, 57*b1cdbd2cSJim Jagielski E_HELPBOOKMARKS = 2 58*b1cdbd2cSJim Jagielski }; 59*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 60*b1cdbd2cSJim Jagielski // forward declarations 61*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 62*b1cdbd2cSJim Jagielski 63*b1cdbd2cSJim Jagielski /*-************************************************************************************************************//** 64*b1cdbd2cSJim Jagielski @short forward declaration to our private date container implementation 65*b1cdbd2cSJim Jagielski @descr We use these class as internal member to support small memory requirements. 66*b1cdbd2cSJim Jagielski You can create the container if it is neccessary. The class which use these mechanism 67*b1cdbd2cSJim Jagielski is faster and smaller then a complete implementation! 68*b1cdbd2cSJim Jagielski *//*-*************************************************************************************************************/ 69*b1cdbd2cSJim Jagielski 70*b1cdbd2cSJim Jagielski class SvtDynamicMenuOptions_Impl; 71*b1cdbd2cSJim Jagielski 72*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 73*b1cdbd2cSJim Jagielski // declarations 74*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________ 75*b1cdbd2cSJim Jagielski 76*b1cdbd2cSJim Jagielski /*-************************************************************************************************************//** 77*b1cdbd2cSJim Jagielski @short collect informations about dynamic menus 78*b1cdbd2cSJim Jagielski @descr Make it possible to configure dynamic menu structures of menus like "new" or "wizard". 79*b1cdbd2cSJim Jagielski 80*b1cdbd2cSJim Jagielski @implements - 81*b1cdbd2cSJim Jagielski @base - 82*b1cdbd2cSJim Jagielski 83*b1cdbd2cSJim Jagielski @devstatus ready to use 84*b1cdbd2cSJim Jagielski *//*-*************************************************************************************************************/ 85*b1cdbd2cSJim Jagielski 86*b1cdbd2cSJim Jagielski class UNOTOOLS_DLLPUBLIC SvtDynamicMenuOptions: public utl::detail::Options 87*b1cdbd2cSJim Jagielski { 88*b1cdbd2cSJim Jagielski //------------------------------------------------------------------------------------------------------------- 89*b1cdbd2cSJim Jagielski // public methods 90*b1cdbd2cSJim Jagielski //------------------------------------------------------------------------------------------------------------- 91*b1cdbd2cSJim Jagielski 92*b1cdbd2cSJim Jagielski public: 93*b1cdbd2cSJim Jagielski 94*b1cdbd2cSJim Jagielski //--------------------------------------------------------------------------------------------------------- 95*b1cdbd2cSJim Jagielski // constructor / destructor 96*b1cdbd2cSJim Jagielski //--------------------------------------------------------------------------------------------------------- 97*b1cdbd2cSJim Jagielski 98*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//** 99*b1cdbd2cSJim Jagielski @short standard constructor and destructor 100*b1cdbd2cSJim Jagielski @descr This will initialize an instance with default values. 101*b1cdbd2cSJim Jagielski We implement these class with a refcount mechanism! Every instance of this class increase it 102*b1cdbd2cSJim Jagielski at create and decrease it at delete time - but all instances use the same data container! 103*b1cdbd2cSJim Jagielski He is implemented as a static member ... 104*b1cdbd2cSJim Jagielski 105*b1cdbd2cSJim Jagielski @seealso member m_nRefCount 106*b1cdbd2cSJim Jagielski @seealso member m_pDataContainer 107*b1cdbd2cSJim Jagielski 108*b1cdbd2cSJim Jagielski @param - 109*b1cdbd2cSJim Jagielski @return - 110*b1cdbd2cSJim Jagielski 111*b1cdbd2cSJim Jagielski @onerror - 112*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/ 113*b1cdbd2cSJim Jagielski 114*b1cdbd2cSJim Jagielski SvtDynamicMenuOptions(); 115*b1cdbd2cSJim Jagielski virtual ~SvtDynamicMenuOptions(); 116*b1cdbd2cSJim Jagielski 117*b1cdbd2cSJim Jagielski //--------------------------------------------------------------------------------------------------------- 118*b1cdbd2cSJim Jagielski // interface 119*b1cdbd2cSJim Jagielski //--------------------------------------------------------------------------------------------------------- 120*b1cdbd2cSJim Jagielski 121*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//** 122*b1cdbd2cSJim Jagielski @short clear complete sepcified list 123*b1cdbd2cSJim Jagielski @descr Call this methods to clear the whole list. 124*b1cdbd2cSJim Jagielski To fill it again use AppendItem(). 125*b1cdbd2cSJim Jagielski 126*b1cdbd2cSJim Jagielski @seealso - 127*b1cdbd2cSJim Jagielski 128*b1cdbd2cSJim Jagielski @param "eMenu" select right menu to clear. 129*b1cdbd2cSJim Jagielski @return - 130*b1cdbd2cSJim Jagielski 131*b1cdbd2cSJim Jagielski @onerror - 132*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/ 133*b1cdbd2cSJim Jagielski 134*b1cdbd2cSJim Jagielski void Clear( EDynamicMenuType eMenu ); 135*b1cdbd2cSJim Jagielski 136*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//** 137*b1cdbd2cSJim Jagielski @short return complete specified list 138*b1cdbd2cSJim Jagielski @descr Call it to get all entries of an dynamic menu. 139*b1cdbd2cSJim Jagielski We return a list of all nodes with his names and properties. 140*b1cdbd2cSJim Jagielski 141*b1cdbd2cSJim Jagielski @seealso - 142*b1cdbd2cSJim Jagielski 143*b1cdbd2cSJim Jagielski @param "eMenu" select right menu. 144*b1cdbd2cSJim Jagielski @return A list of menu items is returned. 145*b1cdbd2cSJim Jagielski 146*b1cdbd2cSJim Jagielski @onerror We return an empty list. 147*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/ 148*b1cdbd2cSJim Jagielski 149*b1cdbd2cSJim Jagielski ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > > GetMenu( EDynamicMenuType eMenu ) const; 150*b1cdbd2cSJim Jagielski 151*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//** 152*b1cdbd2cSJim Jagielski @short append a new item to specified menu 153*b1cdbd2cSJim Jagielski @descr You can append items to a menu only - removing isn't allowed for a special item! 154*b1cdbd2cSJim Jagielski We support a nothing or all mechanism only! Clear all or append something ... 155*b1cdbd2cSJim Jagielski 156*b1cdbd2cSJim Jagielski @seealso method Clear() 157*b1cdbd2cSJim Jagielski 158*b1cdbd2cSJim Jagielski @param "eMenu" select right menu. 159*b1cdbd2cSJim Jagielski @param "sURL" URL for dispatch 160*b1cdbd2cSJim Jagielski @param "sTitle" label of menu entry 161*b1cdbd2cSJim Jagielski @param "sImageIdentifier" icon identifier 162*b1cdbd2cSJim Jagielski @param "sTargetName" target for dispatch 163*b1cdbd2cSJim Jagielski @return - 164*b1cdbd2cSJim Jagielski 165*b1cdbd2cSJim Jagielski @onerror - 166*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/ 167*b1cdbd2cSJim Jagielski 168*b1cdbd2cSJim Jagielski void AppendItem( EDynamicMenuType eMenu , 169*b1cdbd2cSJim Jagielski const ::rtl::OUString& sURL , 170*b1cdbd2cSJim Jagielski const ::rtl::OUString& sTitle , 171*b1cdbd2cSJim Jagielski const ::rtl::OUString& sImageIdentifier , 172*b1cdbd2cSJim Jagielski const ::rtl::OUString& sTargetName ); 173*b1cdbd2cSJim Jagielski 174*b1cdbd2cSJim Jagielski //------------------------------------------------------------------------------------------------------------- 175*b1cdbd2cSJim Jagielski // private methods 176*b1cdbd2cSJim Jagielski //------------------------------------------------------------------------------------------------------------- 177*b1cdbd2cSJim Jagielski 178*b1cdbd2cSJim Jagielski private: 179*b1cdbd2cSJim Jagielski 180*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//** 181*b1cdbd2cSJim Jagielski @short return a reference to a static mutex 182*b1cdbd2cSJim Jagielski @descr These class is partially threadsafe (for de-/initialization only). 183*b1cdbd2cSJim Jagielski All access methods are'nt safe! 184*b1cdbd2cSJim Jagielski We create a static mutex only for one ime and use at different times. 185*b1cdbd2cSJim Jagielski 186*b1cdbd2cSJim Jagielski @seealso - 187*b1cdbd2cSJim Jagielski 188*b1cdbd2cSJim Jagielski @param - 189*b1cdbd2cSJim Jagielski @return A reference to a static mutex member. 190*b1cdbd2cSJim Jagielski 191*b1cdbd2cSJim Jagielski @onerror - 192*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/ 193*b1cdbd2cSJim Jagielski 194*b1cdbd2cSJim Jagielski UNOTOOLS_DLLPRIVATE static ::osl::Mutex& GetOwnStaticMutex(); 195*b1cdbd2cSJim Jagielski 196*b1cdbd2cSJim Jagielski //------------------------------------------------------------------------------------------------------------- 197*b1cdbd2cSJim Jagielski // private member 198*b1cdbd2cSJim Jagielski //------------------------------------------------------------------------------------------------------------- 199*b1cdbd2cSJim Jagielski 200*b1cdbd2cSJim Jagielski private: 201*b1cdbd2cSJim Jagielski 202*b1cdbd2cSJim Jagielski /*Attention 203*b1cdbd2cSJim Jagielski 204*b1cdbd2cSJim Jagielski Don't initialize these static member in these header! 205*b1cdbd2cSJim Jagielski a) Double dfined symbols will be detected ... 206*b1cdbd2cSJim Jagielski b) and unresolved externals exist at linking time. 207*b1cdbd2cSJim Jagielski Do it in your source only. 208*b1cdbd2cSJim Jagielski */ 209*b1cdbd2cSJim Jagielski 210*b1cdbd2cSJim Jagielski static SvtDynamicMenuOptions_Impl* m_pDataContainer ; /// impl. data container as dynamic pointer for smaller memory requirements! 211*b1cdbd2cSJim Jagielski static sal_Int32 m_nRefCount ; /// internal ref count mechanism 212*b1cdbd2cSJim Jagielski 213*b1cdbd2cSJim Jagielski }; // class SvtDynamicMenuOptions 214*b1cdbd2cSJim Jagielski 215*b1cdbd2cSJim Jagielski #endif // #ifndef INCLUDED_unotools_DYNAMICMENUOPTIONS_HXX 216