LCOV - code coverage report
Current view: top level - include/framework - addonsoptions.hxx (source / functions) Hit Total Coverage
Test: commit e02a6cb2c3e2b23b203b422e4e0680877f232636 Lines: 0 3 0.0 %
Date: 2014-04-14 Functions: 0 10 0.0 %
Legend: Lines: hit not hit

          Line data    Source code
       1             : /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
       2             : /*
       3             :  * This file is part of the LibreOffice project.
       4             :  *
       5             :  * This Source Code Form is subject to the terms of the Mozilla Public
       6             :  * License, v. 2.0. If a copy of the MPL was not distributed with this
       7             :  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
       8             :  *
       9             :  * This file incorporates work covered by the following license notice:
      10             :  *
      11             :  *   Licensed to the Apache Software Foundation (ASF) under one or more
      12             :  *   contributor license agreements. See the NOTICE file distributed
      13             :  *   with this work for additional information regarding copyright
      14             :  *   ownership. The ASF licenses this file to you under the Apache
      15             :  *   License, Version 2.0 (the "License"); you may not use this file
      16             :  *   except in compliance with the License. You may obtain a copy of
      17             :  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
      18             :  */
      19             : #ifndef INCLUDED_FRAMEWORK_ADDONSOPTIONS_HXX
      20             : #define INCLUDED_FRAMEWORK_ADDONSOPTIONS_HXX
      21             : 
      22             : #include <sal/types.h>
      23             : #include <osl/mutex.hxx>
      24             : #include <vcl/image.hxx>
      25             : #include <vcl/bitmap.hxx>
      26             : #include <vcl/svapp.hxx>
      27             : #include <com/sun/star/uno/Sequence.h>
      28             : #include <com/sun/star/beans/PropertyValue.hpp>
      29             : #include <framework/fwedllapi.h>
      30             : 
      31             : //  types, enums, ...
      32             : 
      33             : 
      34             : /*-************************************************************************************************************
      35             :     @descr          The method GetAddonsMenu() returns a list of property values.
      36             :                     Use follow defines to separate values by names.
      37             : *//*-*************************************************************************************************************/
      38             : #define ADDONSMENUITEM_STRING_URL                       "URL"
      39             : #define ADDONSMENUITEM_STRING_TITLE                     "Title"
      40             : #define ADDONSMENUITEM_STRING_TARGET                    "Target"
      41             : #define ADDONSMENUITEM_STRING_IMAGEIDENTIFIER           "ImageIdentifier"
      42             : #define ADDONSMENUITEM_STRING_CONTEXT                   "Context"
      43             : #define ADDONSMENUITEM_STRING_SUBMENU                   "Submenu"
      44             : #define ADDONSMENUITEM_STRING_CONTROLTYPE               "ControlType"
      45             : #define ADDONSMENUITEM_STRING_WIDTH                     "Width"
      46             : 
      47             : #define STATUSBARITEM_STRING_ALIGN                      "Alignment"
      48             : #define STATUSBARITEM_STRING_AUTOSIZE                   "AutoSize"
      49             : #define STATUSBARITEM_STRING_OWNERDRAW                  "OwnerDraw"
      50             : 
      51             : #define ADDONSMENUITEM_URL_LEN                          3
      52             : #define ADDONSMENUITEM_TITLE_LEN                        5
      53             : #define ADDONSMENUITEM_TARGET_LEN                       6
      54             : #define ADDONSMENUITEM_SUBMENU_LEN                      7
      55             : #define ADDONSMENUITEM_CONTEXT_LEN                      7
      56             : #define ADDONSMENUITEM_IMAGEIDENTIFIER_LEN              15
      57             : 
      58             : #define ADDONSMENUITEM_PROPERTYNAME_URL                 OUString(ADDONSMENUITEM_STRING_URL             )
      59             : #define ADDONSMENUITEM_PROPERTYNAME_TITLE               OUString(ADDONSMENUITEM_STRING_TITLE           )
      60             : #define ADDONSMENUITEM_PROPERTYNAME_TARGET              OUString(ADDONSMENUITEM_STRING_TARGET          )
      61             : #define ADDONSMENUITEM_PROPERTYNAME_IMAGEIDENTIFIER     OUString(ADDONSMENUITEM_STRING_IMAGEIDENTIFIER )
      62             : #define ADDONSMENUITEM_PROPERTYNAME_CONTEXT             OUString(ADDONSMENUITEM_STRING_CONTEXT         )
      63             : #define ADDONSMENUITEM_PROPERTYNAME_SUBMENU             OUString(ADDONSMENUITEM_STRING_SUBMENU         )
      64             : #define ADDONSMENUITEM_PROPERTYNAME_CONTROLTYPE         OUString(ADDONSMENUITEM_STRING_CONTROLTYPE     )
      65             : #define ADDONSMENUITEM_PROPERTYNAME_WIDTH               OUString(ADDONSMENUITEM_STRING_WIDTH           )
      66             : 
      67             : #define STATUSBARITEM_PROPERTYNAME_ALIGN                OUString(STATUSBARITEM_STRING_ALIGN            )
      68             : #define STATUSBARITEM_PROPERTYNAME_AUTOSIZE             OUString(STATUSBARITEM_STRING_AUTOSIZE         )
      69             : #define STATUSBARITEM_PROPERTYNAME_OWNERDRAW            OUString(STATUSBARITEM_STRING_OWNERDRAW        )
      70             : 
      71             : #define ADDONSPOPUPMENU_URL_PREFIX_STR                  "private:menu/Addon"
      72             : 
      73             : #define ADDONSPOPUPMENU_URL_PREFIX                      OUString( ADDONSPOPUPMENU_URL_PREFIX_STR )
      74             : 
      75             : namespace framework
      76             : {
      77             : 
      78             : typedef ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > > MergeMenuDefinition;
      79             : 
      80           0 : struct FWE_DLLPUBLIC MergeMenuInstruction
      81             : {
      82             :     OUString     aMergePoint;
      83             :     OUString     aMergeCommand;
      84             :     OUString     aMergeCommandParameter;
      85             :     OUString     aMergeFallback;
      86             :     OUString     aMergeContext;
      87             :     ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > > aMergeMenu;
      88             : };
      89             : typedef ::std::vector< MergeMenuInstruction > MergeMenuInstructionContainer;
      90             : 
      91           0 : struct FWE_DLLPUBLIC MergeToolbarInstruction
      92             : {
      93             :     OUString     aMergeToolbar;
      94             :     OUString     aMergePoint;
      95             :     OUString     aMergeCommand;
      96             :     OUString     aMergeCommandParameter;
      97             :     OUString     aMergeFallback;
      98             :     OUString     aMergeContext;
      99             :     ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > > aMergeToolbarItems;
     100             : };
     101             : 
     102             : typedef ::std::vector< MergeToolbarInstruction > MergeToolbarInstructionContainer;
     103             : 
     104           0 : struct FWE_DLLPUBLIC MergeStatusbarInstruction
     105             : {
     106             :     ::rtl::OUString     aMergePoint;
     107             :     ::rtl::OUString     aMergeCommand;
     108             :     ::rtl::OUString     aMergeCommandParameter;
     109             :     ::rtl::OUString     aMergeFallback;
     110             :     ::rtl::OUString     aMergeContext;
     111             :     ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > > aMergeStatusbarItems;
     112             : };
     113             : 
     114             : typedef ::std::vector< MergeStatusbarInstruction > MergeStatusbarInstructionContainer;
     115             : 
     116             : 
     117             : //  forward declarations
     118             : 
     119             : 
     120             : /*-************************************************************************************************************
     121             :     @short          forward declaration to our private date container implementation
     122             :     @descr          We use these class as internal member to support small memory requirements.
     123             :                     You can create the container if it is necessary. The class which use these mechanism
     124             :                     is faster and smaller then a complete implementation!
     125             : *//*-*************************************************************************************************************/
     126             : 
     127             : class AddonsOptions_Impl;
     128             : 
     129             : /*-************************************************************************************************************
     130             :     @short          collect information about menu features
     131             :     @devstatus      ready to use
     132             : *//*-*************************************************************************************************************/
     133             : 
     134             : class FWE_DLLPUBLIC AddonsOptions
     135             : {
     136             : 
     137             :     //  public methods
     138             : 
     139             : 
     140             :     public:
     141             : 
     142             :         //  constructor / destructor
     143             : 
     144             : 
     145             :         /*-****************************************************************************************************
     146             :             @short      standard constructor and destructor
     147             :             @descr      This will initialize an instance with default values.
     148             :                         We implement these class with a refcount mechanism! Every instance of this class increase it
     149             :                         at create and decrease it at delete time - but all instances use the same data container!
     150             :                         He is implemented as a static member ...
     151             : 
     152             :             @seealso    member m_nRefCount
     153             :             @seealso    member m_pDataContainer
     154             :         *//*-*****************************************************************************************************/
     155             : 
     156             :          AddonsOptions();
     157             :         ~AddonsOptions();
     158             : 
     159             : 
     160             :         //  interface
     161             : 
     162             : 
     163             :         /*-****************************************************************************************************
     164             :             @short      clears completely the addons menu
     165             :             @descr      Call this methods to clear the addons menu
     166             :                         To fill it again use AppendItem().
     167             :             @param      "eMenu" select right menu to clear.
     168             :         *//*-*****************************************************************************************************/
     169             : 
     170             :         void Clear();
     171             : 
     172             :         /*-****************************************************************************************************
     173             :             @short      returns if an addons menu is available
     174             :             @descr      Call to retrieve if a addons menu is available
     175             : 
     176             : 
     177             :             @return     true if there is a menu otherwise false
     178             :         *//*-*****************************************************************************************************/
     179             : 
     180             :         bool    HasAddonsMenu() const;
     181             : 
     182             :         /*-****************************************************************************************************
     183             :             @short      returns number of addons toolbars
     184             :             @descr      Call to retrieve the number of addons toolbars
     185             : 
     186             : 
     187             :             @return     number of addons toolbars
     188             :         *//*-*****************************************************************************************************/
     189             :         sal_Int32   GetAddonsToolBarCount() const ;
     190             : 
     191             :         /*-****************************************************************************************************
     192             :             @short      returns the  complete addons menu
     193             :             @descr      Call it to get all entries of the addon menu.
     194             :                         We return a list of all nodes with his names and properties.
     195             :             @return     A list of menu items is returned.
     196             : 
     197             :             @onerror    We return an empty list.
     198             :         *//*-*****************************************************************************************************/
     199             : 
     200             :         const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > >& GetAddonsMenu() const;
     201             : 
     202             :         /*-****************************************************************************************************
     203             :             @short      Gets the menu bar part of all addon components registered
     204             :             @return     A complete
     205             : 
     206             :             @onerror    We return sal_False
     207             :         *//*-*****************************************************************************************************/
     208             : 
     209             :         const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > >& GetAddonsMenuBarPart() const;
     210             : 
     211             :         /*-****************************************************************************************************
     212             :             @short      Gets a toolbar part of an single addon
     213             :             @return     A complete
     214             : 
     215             :             @onerror    We return sal_False
     216             :         *//*-*****************************************************************************************************/
     217             : 
     218             :         const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > >& GetAddonsToolBarPart( sal_uInt32 nIndex ) const;
     219             : 
     220             :         /*-****************************************************************************************************
     221             :             @short      Gets a unique toolbar resource name of an single addon
     222             :             @return     A complete
     223             : 
     224             :             @onerror    We return sal_False
     225             :         *//*-*****************************************************************************************************/
     226             : 
     227             :         const OUString GetAddonsToolbarResourceName( sal_uInt32 nIndex ) const;
     228             : 
     229             :         /*-****************************************************************************************************
     230             :             @short      Retrieves all available merge instructions for the Office menu bar
     231             :             @return     The filled MergeMenuDefinitionContaier
     232             : 
     233             :             @onerror    We return sal_False
     234             :         *//*-*****************************************************************************************************/
     235             : 
     236             :         const MergeMenuInstructionContainer& GetMergeMenuInstructions() const;
     237             : 
     238             :         /*-****************************************************************************************************
     239             :             @short      Retrieves all available merge instructions for a single toolbar
     240             :             @return     The filled
     241             : 
     242             :             @onerror    We return sal_False
     243             :         *//*-*****************************************************************************************************/
     244             :         bool GetMergeToolbarInstructions( const OUString& rToolbarName, MergeToolbarInstructionContainer& rToolbar ) const;
     245             : 
     246             :         /*-****************************************************************************************************
     247             :             @short      Gets the Add-On help menu part of all addon components registered
     248             :             @return     A complete
     249             : 
     250             :             @onerror    We return sal_False
     251             :         *//*-*****************************************************************************************************/
     252             :         const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > >& GetAddonsHelpMenu() const;
     253             : 
     254             :         const MergeStatusbarInstructionContainer& GetMergeStatusbarInstructions() const;
     255             : 
     256             :         /*-****************************************************************************************************
     257             :             @short      Retrieve an image for a command URL which is defined inside the addon menu configuration
     258             :             @descr      Call it to retrieve an image for a command URL which is defined inside the addon menu configuration
     259             :             @return     An image which was defined in the configuration for the menu item. The image can be empty
     260             :                         no bitmap was defined for the request image properties.
     261             : 
     262             :             @onerror    An empty image
     263             :         *//*-*****************************************************************************************************/
     264             : 
     265             :         Image GetImageFromURL( const OUString& aURL, bool bBig, bool bNoScale ) const;
     266             :         Image GetImageFromURL( const OUString& aURL, bool bBig ) const;
     267             : 
     268             : 
     269             :     //  private methods
     270             : 
     271             : 
     272             :         /*-****************************************************************************************************
     273             :             @short      return a reference to a static mutex
     274             :             @descr      These class is partially threadsafe (for de-/initialization only).
     275             :                         All access methods are'nt safe!
     276             :                         We create a static mutex only for one ime and use at different times.
     277             :             @return     A reference to a static mutex member.
     278             :         *//*-*****************************************************************************************************/
     279             : 
     280             :         static ::osl::Mutex& GetOwnStaticMutex();
     281             : 
     282             :         /*-****************************************************************************************************
     283             :             @short      return a reference to a static mutex
     284             :             @descr      These class is partially threadsafe (for de-/initialization only).
     285             :                         All access methods are'nt safe!
     286             :                         We create a static mutex only for one ime and use at different times.
     287             :             @return     A reference to a static mutex member.
     288             :         *//*-*****************************************************************************************************/
     289             :         DECL_STATIC_LINK( AddonsOptions, Notify, void* );
     290             : 
     291             : 
     292             :     //  private member
     293             : 
     294             : 
     295             :     private:
     296             : 
     297             :         /*Attention
     298             : 
     299             :             Don't initialize these static member in these header!
     300             :             a) Double dfined symbols will be detected ...
     301             :             b) and unresolved externals exist at linking time.
     302             :             Do it in your source only.
     303             :          */
     304             : 
     305             :         static AddonsOptions_Impl*  m_pDataContainer    ;
     306             :         static sal_Int32            m_nRefCount         ;
     307             : 
     308             : };      // class SvtMenuOptions
     309             : 
     310             : }
     311             : 
     312             : #endif // INCLUDED_FRAMEWORK_ADDONSOPTIONS_HXX
     313             : 
     314             : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */

Generated by: LCOV version 1.10