extensions/source/propctrlr/browserlistbox.hxx

   1 /*************************************************************************
   2  *
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * Copyright 2008 by Sun Microsystems, Inc.
   6  *
   7  * OpenOffice.org - a multi-platform office productivity suite
   8  *
   9  * $RCSfile: browserlistbox.hxx,v $
  10  * $Revision: 1.13 $
  11  *
  12  * This file is part of OpenOffice.org.
  13  *
  14  * OpenOffice.org is free software: you can redistribute it and/or modify
  15  * it under the terms of the GNU Lesser General Public License version 3
  16  * only, as published by the Free Software Foundation.
  17  *
  18  * OpenOffice.org is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU Lesser General Public License version 3 for more details
  22  * (a copy is included in the LICENSE file that accompanied this code).
  23  *
  24  * You should have received a copy of the GNU Lesser General Public License
  25  * version 3 along with OpenOffice.org.  If not, see
  26  * <http://www.openoffice.org/license.html>
  27  * for a copy of the LGPLv3 License.
  28  *
  29  ************************************************************************/
  30
  31 #ifndef _EXTENSIONS_PROPCTRLR_BROWSERLISTBOX_HXX_
  32 #define _EXTENSIONS_PROPCTRLR_BROWSERLISTBOX_HXX_
  33
  34 #include "browserline.hxx"
  35 #ifndef _EXTENSIONS_PROPCTRLR_MODULEPRC_HXX_
  36 #include "modulepcr.hxx"
  37 #endif
  38 #include "pcrcommon.hxx"
  39
  40 /** === begin UNO includes === **/
  41 #include <com/sun/star/inspection/XPropertyControl.hpp>
  42 #include <com/sun/star/inspection/XPropertyHandler.hpp>
  43 /** === end UNO includes === **/
  44 #include <vcl/scrbar.hxx>
  45 #include <vcl/lstbox.hxx>
  46 #ifndef _SV_BUTTON_HXX
  47 #include <vcl/button.hxx>
  48 #endif
  49 #include <tools/link.hxx>
  50 #include <rtl/ref.hxx>
  51
  52 #include <set>
  53 #include <vector>
  54 #include <hash_map>
  55 #include <boost/shared_ptr.hpp>
  56
  57 //............................................................................
  58 namespace pcr
  59 {
  60 //............................................................................
  61
  62     class IPropertyLineListener;
  63     class IPropertyControlObserver;
  64     struct OLineDescriptor;
  65     class InspectorHelpWindow;
  66     class PropertyControlContext_Impl;
  67
  68     //========================================================================
  69     //= administrative structures for OBrowserListBox
  70     //========================================================================
  71     typedef ::boost::shared_ptr< OBrowserLine > BrowserLinePointer;
  72     struct ListBoxLine
  73     {
  74         BrowserLinePointer                      pLine;
  75         ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyHandler >
  76                                                 xHandler;
  77
  78         ListBoxLine() { }
  79         ListBoxLine( BrowserLinePointer _pLine, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyHandler >& _rxHandler )
  80             :pLine( _pLine )
  81             ,xHandler( _rxHandler )
  82         {
  83         }
  84     };
  85     typedef ::std::hash_map< ::rtl::OUString, ListBoxLine, ::rtl::OUStringHash >    ListBoxLines;
  86     typedef ::std::vector< ListBoxLines::iterator >                                 OrderedListBoxLines;
  87
  88     //========================================================================
  89     //= IControlContext
  90     //========================================================================
  91     /** non-UNO version of XPropertyControlContext
  92     */
  93     class SAL_NO_VTABLE IControlContext
  94     {
  95     public:
  96         virtual void SAL_CALL focusGained( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& Control ) throw (::com::sun::star::uno::RuntimeException) = 0;
  97         virtual void SAL_CALL valueChanged( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& Control ) throw (::com::sun::star::uno::RuntimeException) = 0;
  98         virtual void SAL_CALL activateNextControl( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& CurrentControl ) throw (::com::sun::star::uno::RuntimeException) = 0;
  99     };
 100
 101     //========================================================================
 102     //= OBrowserListBox
 103     //========================================================================
 104     class OBrowserListBox   :public Control
 105                             ,public IButtonClickListener
 106                             ,public IControlContext
 107                             ,public PcrClient
 108     {
 109     protected:
 110         Window                      m_aLinesPlayground;
 111         ScrollBar                   m_aVScroll;
 112         ::std::auto_ptr< InspectorHelpWindow >
 113                                     m_pHelpWindow;
 114         ListBoxLines                m_aLines;
 115         OrderedListBoxLines         m_aOrderedLines;
 116         IPropertyLineListener*      m_pLineListener;
 117         IPropertyControlObserver*   m_pControlObserver;
 118         long                        m_nYOffset;
 119         long                        m_nCurrentPreferredHelpHeight;
 120         ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >
 121                                     m_xActiveControl;
 122         sal_uInt16                  m_nTheNameSize;
 123         sal_uInt16                  m_nRowHeight;
 124         ::std::set< sal_uInt16 >    m_aOutOfDateLines;
 125         sal_Bool                    m_bIsActive : 1;
 126         sal_Bool                    m_bUpdate : 1;
 127         ::rtl::Reference< PropertyControlContext_Impl >
 128                                     m_pControlContextImpl;
 129
 130     protected:
 131         void    PositionLine( sal_uInt16 _nIndex );
 132         void    UpdatePosNSize();
 133         void    UpdatePlayGround();
 134         void    UpdateVScroll();
 135         void    ShowEntry(sal_uInt16 nPos);
 136         void    MoveThumbTo(sal_Int32 nNewThumbPos);
 137         void    Resize();
 138
 139     public:
 140                                     OBrowserListBox( Window* pParent, WinBits nWinStyle = WB_DIALOGCONTROL );
 141
 142                                     ~OBrowserListBox();
 143
 144         void                        UpdateAll();
 145
 146         void                        ActivateListBox( sal_Bool _bActive );
 147
 148         sal_uInt16                  CalcVisibleLines();
 149         void                        EnableUpdate();
 150         void                        DisableUpdate();
 151         long                        Notify( NotifyEvent& _rNEvt );
 152
 153         void                        SetListener( IPropertyLineListener* _pListener );
 154         void                        SetObserver( IPropertyControlObserver* _pObserver );
 155
 156         void                        EnableHelpSection( bool _bEnable );
 157         bool                        HasHelpSection() const;
 158         void                        SetHelpText( const ::rtl::OUString& _rHelpText );
 159         void                        SetHelpLineLimites( sal_Int32 _nMinLines, sal_Int32 _nMaxLines );
 160
 161         void                        Clear();
 162
 163         sal_uInt16                  InsertEntry( const OLineDescriptor&, sal_uInt16 nPos = EDITOR_LIST_APPEND );
 164         sal_Bool                    RemoveEntry( const ::rtl::OUString& _rName );
 165         void                        ChangeEntry( const OLineDescriptor&, sal_uInt16 nPos );
 166
 167         void                        SetPropertyValue( const ::rtl::OUString& rEntryName, const ::com::sun::star::uno::Any& rValue, bool _bUnknownValue );
 168         ::com::sun::star::uno::Any  GetPropertyValue( const ::rtl::OUString& rEntryName ) const;
 169         sal_uInt16                  GetPropertyPos( const ::rtl::OUString& rEntryName ) const;
 170         ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >
 171                                     GetPropertyControl( const ::rtl::OUString& rEntryName );
 172         void                        EnablePropertyControls( const ::rtl::OUString& _rEntryName, sal_Int16 _nControls, bool _bEnable );
 173         void                        EnablePropertyLine( const ::rtl::OUString& _rEntryName, bool _bEnable );
 174         sal_Bool                    IsPropertyInputEnabled( const ::rtl::OUString& _rEntryName ) const;
 175
 176         sal_Int32                   GetMinimumWidth();
 177         sal_Int32                   GetMinimumHeight();
 178
 179
 180         sal_Bool    IsModified( ) const;
 181         void        CommitModified( );
 182
 183     protected:
 184         // IControlContext
 185         virtual void SAL_CALL focusGained( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& Control ) throw (::com::sun::star::uno::RuntimeException);
 186         virtual void SAL_CALL valueChanged( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& Control ) throw (::com::sun::star::uno::RuntimeException);
 187         virtual void SAL_CALL activateNextControl( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& CurrentControl ) throw (::com::sun::star::uno::RuntimeException);
 188
 189         // IButtonClickListener
 190         void    buttonClicked( OBrowserLine* _pLine, sal_Bool _bPrimary );
 191
 192         using Window::SetHelpText;
 193     private:
 194         DECL_LINK( ScrollHdl, ScrollBar* );
 195
 196         /** retrieves the index of a given control in our line list
 197             @param _rxControl
 198                 The control to lookup. Must denote a control of one of the lines in ->m_aLines
 199         */
 200         sal_uInt16  impl_getControlPos( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& _rxControl ) const;
 201
 202         /** retrieves (a reference to) the ->ListBoxLine for a given control
 203             @param _rxControl
 204                 The control to lookup. Must denote a control of one of the lines in ->m_aLines
 205         */
 206         inline const ListBoxLine&
 207                     impl_getControlLine( const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControl >& _rxControl ) const
 208         {
 209             return m_aOrderedLines[ impl_getControlPos( _rxControl ) ]->second;
 210         }
 211
 212         /** sets the given property value at the given control, after converting it as necessary
 213             @param _rLine
 214                 The line whose at which the value is to be set.
 215             @param _rPropertyValue
 216                 the property value to set. If it's not compatible with the control value,
 217                 it will be converted, using <member>XPropertyHandler::convertToControlValue</member>
 218         */
 219         void        impl_setControlAsPropertyValue( const ListBoxLine& _rLine, const ::com::sun::star::uno::Any& _rPropertyValue );
 220
 221         /** retrieves the value for the given control, as a property value, after converting it as necessary
 222             @param _rLine
 223                 The line whose at which the value is to be set.
 224         */
 225         ::com::sun::star::uno::Any
 226                     impl_getControlAsPropertyValue( const ListBoxLine& _rLine ) const;
 227
 228         /** retrieves the ->BrowserLinePointer for a given entry name
 229             @param  _rEntryName
 230                 the name whose line is to be looked up
 231             @param  _out_rpLine
 232                 contains, upon return, the found browser line, if any
 233             @return
 234                 <TRUE/> if and only if a non-<NULL/> line for the given entry name could be
 235                 found.
 236         */
 237         bool        impl_getBrowserLineForName( const ::rtl::OUString& _rEntryName, BrowserLinePointer& _out_rpLine ) const;
 238
 239         /** returns the preferred height (in pixels) of the help section, or 0 if we
 240             currently don't have a help section
 241         */
 242         long        impl_getPrefererredHelpHeight();
 243
 244     private:
 245         using Window::Activate;
 246     };
 247
 248 //............................................................................
 249 } // namespace pcr
 250 //............................................................................
 251
 252 #endif // _EXTENSIONS_PROPCTRLR_BROWSERLISTBOX_HXX_
 253
 254