LCOV - code coverage report
Current view: top level - usr/local/src/libreoffice/include/svtools - dialogcontrolling.hxx (source / functions) Hit Total Coverage
Test: libreoffice_filtered.info Lines: 0 28 0.0 %
Date: 2013-07-09 Functions: 0 18 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             : 
      20             : #ifndef SVTOOLS_DIALOGCONTROLLING_HXX
      21             : #define SVTOOLS_DIALOGCONTROLLING_HXX
      22             : 
      23             : #include <svtools/svtdllapi.h>
      24             : 
      25             : #include <tools/link.hxx>
      26             : #include <vcl/button.hxx>
      27             : 
      28             : #include <vector>
      29             : #include <boost/shared_ptr.hpp>
      30             : 
      31             : //........................................................................
      32             : namespace svt
      33             : {
      34             : //........................................................................
      35             : 
      36             :     //=====================================================================
      37             :     //= IWindowOperator
      38             :     //=====================================================================
      39             :     /** an abstract interface for operating on a ->Window
      40             :     */
      41           0 :     class SVT_DLLPUBLIC SAL_NO_VTABLE IWindowOperator
      42             :     {
      43             :     public:
      44             :         /** called when an event happened which should be reacted to
      45             : 
      46             :             @param _rTrigger
      47             :                 the event which triggered the call. If the Id of the event is 0, then this is the initial
      48             :                 call which is made when ->_rOperateOn is added to the responsibility of the DialogController.
      49             :             @param _rOperateOn
      50             :                 the window on which to operate
      51             :         */
      52             :         virtual void operateOn( const VclWindowEvent& _rTrigger, Window& _rOperateOn ) const = 0;
      53             : 
      54             :         virtual ~IWindowOperator();
      55             :     };
      56             :     typedef ::boost::shared_ptr< IWindowOperator >  PWindowOperator;
      57             : 
      58             :     //=====================================================================
      59             :     //= IWindowEventFilter
      60             :     //=====================================================================
      61             :     /** an abstract interface for deciding whether a ->VclWindowEvent
      62             :         is worth paying attention to
      63             :     */
      64           0 :     class SVT_DLLPUBLIC SAL_NO_VTABLE IWindowEventFilter
      65             :     {
      66             :     public:
      67             :         virtual bool payAttentionTo( const VclWindowEvent& _rEvent ) const = 0;
      68             : 
      69             :         virtual ~IWindowEventFilter();
      70             :     };
      71             :     typedef ::boost::shared_ptr< IWindowEventFilter >   PWindowEventFilter;
      72             : 
      73             :     //=====================================================================
      74             :     //= DialogController
      75             :     //=====================================================================
      76             :     struct DialogController_Data;
      77             :     /** a class controlling interactions between dialog controls
      78             : 
      79             :         An instance of this class listens to all events fired by a certain
      80             :         ->Control (more precise, a ->Window), the so-called instigator.
      81             : 
      82             :         Additionally, the ->DialogController maintains a list of windows which
      83             :         are affected by changes in the instigator window. Let's call those the
      84             :         dependent windows.
      85             : 
      86             :         Now, by help of an owner-provided ->IWindowEventFilter, the ->DialogController
      87             :         decides which events are worth attention. By help of an owner-provided
      88             :         ->IWindowOperator, it handles those events for all dependent windows.
      89             :     */
      90             :     class SVT_DLLPUBLIC DialogController
      91             :     {
      92             :     private:
      93             :         ::std::auto_ptr< DialogController_Data >    m_pImpl;
      94             : 
      95             :     public:
      96             :         DialogController( Window& _rInstigator, const PWindowEventFilter& _pEventFilter, const PWindowOperator& _pOperator );
      97             :         virtual ~DialogController();
      98             : 
      99             :         /** adds a window to the list of dependent windows
     100             : 
     101             :             @param _rWindow
     102             :                 The window to add to the list of dependent windows.
     103             : 
     104             :                 The caller is responsible for life-time control: The given window
     105             :                 must live at least as long as the ->DialogController instance does.
     106             :         */
     107             :         void    addDependentWindow( Window& _rWindow );
     108             : 
     109             :         /** resets the controller so that no actions happened anymore.
     110             : 
     111             :             The instances is disfunctional after this method has been called.
     112             :         */
     113             :         void    reset();
     114             : 
     115             :     private:
     116             :         void    impl_Init();
     117             :         void    impl_updateAll( const VclWindowEvent& _rTriggerEvent );
     118             :         void    impl_update( const VclWindowEvent& _rTriggerEvent, Window& _rWindow );
     119             : 
     120             :         DECL_LINK( OnWindowEvent, const VclWindowEvent* );
     121             : 
     122             :     private:
     123             :         DialogController( const DialogController& );            // never implemented
     124             :         DialogController& operator=( const DialogController& ); // never implemented
     125             :     };
     126             :     typedef ::boost::shared_ptr< DialogController > PDialogController;
     127             : 
     128             :     //=====================================================================
     129             :     //= ControlDependencyManager
     130             :     //=====================================================================
     131             :     struct ControlDependencyManager_Data;
     132             :     /** helper class for managing control dependencies
     133             : 
     134             :         Instances of this class are intended to be held as members of a dialog/tabpage/whatever
     135             :         class, with easy administration of inter-control dependencies (such as "Enable
     136             :         control X if and only if checkbox Y is checked).
     137             :     */
     138             :     class SVT_DLLPUBLIC ControlDependencyManager
     139             :     {
     140             :     private:
     141             :         ::std::auto_ptr< ControlDependencyManager_Data >    m_pImpl;
     142             : 
     143             :     public:
     144             :         ControlDependencyManager();
     145             :         ~ControlDependencyManager();
     146             : 
     147             :         /** clears all dialog controllers previously added to the manager
     148             :         */
     149             :         void    clear();
     150             : 
     151             :         /** ensures that a given window is enabled or disabled, according to the check state
     152             :             of a given radio button
     153             :             @param _rRadio
     154             :                 denotes the radio button whose check state is to observe
     155             :             @param _rDependentWindow
     156             :                 denotes the window which should be enabled when ->_rRadio is checked, and
     157             :                 disabled when it's unchecked
     158             :         */
     159             :         void    enableOnRadioCheck( RadioButton& _rRadio, Window& _rDependentWindow );
     160             :         void    enableOnRadioCheck( RadioButton& _rRadio, Window& _rDependentWindow1, Window& _rDependentWindow2, Window& _rDependentWindow3 );
     161             :         void    enableOnRadioCheck( RadioButton& _rRadio, Window& _rDependentWindow1, Window& _rDependentWindow2, Window& _rDependentWindow3, Window& _rDependentWindow4, Window& _rDependentWindow5 );
     162             : 
     163             :         /** ensures that a given window is enabled or disabled, according to the mark state
     164             :             of a given check box
     165             :             @param _rBox
     166             :                 denotes the check box whose mark state is to observe
     167             :             @param _rDependentWindow
     168             :                 denotes the window which should be enabled when ->_rBox is marked, and
     169             :                 disabled when it's unmarked
     170             :         */
     171             :         void    enableOnCheckMark( CheckBox& _rBox, Window& _rDependentWindow );
     172             :         void    enableOnCheckMark( CheckBox& _rBox, Window& _rDependentWindow1, Window& _rDependentWindow2 );
     173             :         void    enableOnCheckMark( CheckBox& _rBox, Window& _rDependentWindow1, Window& _rDependentWindow2, Window& _rDependentWindow3, Window& _rDependentWindow4 );
     174             : 
     175             :         /** adds a non-standard controller whose functionality is not covered by the other methods
     176             : 
     177             :             @param _pController
     178             :                 the controller to add to the manager. Must not be <NULL/>.
     179             :         */
     180             :         void    addController( const PDialogController& _pController );
     181             : 
     182             :     private:
     183             :         ControlDependencyManager( const ControlDependencyManager& );            // never implemented
     184             :         ControlDependencyManager& operator=( const ControlDependencyManager& ); // never implemented
     185             :     };
     186             : 
     187             :     //=====================================================================
     188             :     //= EnableOnCheck
     189             :     //=====================================================================
     190             :     /** a helper class implementing the ->IWindowOperator interface,
     191             :         which enables a dependent window depending on the check state of
     192             :         an instigator window.
     193             : 
     194             :         @see DialogController
     195             :     */
     196             :     template< class CHECKABLE >
     197           0 :     class SVT_DLLPUBLIC EnableOnCheck : public IWindowOperator
     198             :     {
     199             :     public:
     200             :         typedef CHECKABLE   SourceType;
     201             : 
     202             :     private:
     203             :         SourceType& m_rCheckable;
     204             : 
     205             :     public:
     206             :         /** constructs the instance
     207             : 
     208             :             @param _rCheckable
     209             :                 a ->Window instance which supports a boolean method IsChecked. Usually
     210             :                 a ->RadioButton or ->CheckBox
     211             :         */
     212           0 :         EnableOnCheck( SourceType& _rCheckable )
     213           0 :             :m_rCheckable( _rCheckable )
     214             :         {
     215           0 :         }
     216             : 
     217           0 :         virtual void operateOn( const VclWindowEvent& /*_rTrigger*/, Window& _rOperateOn ) const
     218             :         {
     219           0 :             _rOperateOn.Enable( m_rCheckable.IsChecked() );
     220           0 :         }
     221             :     };
     222             : 
     223             :     //=====================================================================
     224             :     //= FilterForRadioOrCheckToggle
     225             :     //=====================================================================
     226             :     /** a helper class implementing the ->IWindowEventFilter interface,
     227             :         which filters for radio buttons or check boxes being toggled.
     228             : 
     229             :         Technically, the class simply filters for the ->VCLEVENT_RADIOBUTTON_TOGGLE
     230             :         and the ->VCLEVENT_CHECKBOX_TOGGLE event.
     231             :     */
     232           0 :     class SVT_DLLPUBLIC FilterForRadioOrCheckToggle : public IWindowEventFilter
     233             :     {
     234             :         const Window&   m_rWindow;
     235             :     public:
     236           0 :         FilterForRadioOrCheckToggle( const Window& _rWindow )
     237           0 :             :m_rWindow( _rWindow )
     238             :         {
     239           0 :         }
     240             : 
     241           0 :         bool payAttentionTo( const VclWindowEvent& _rEvent ) const
     242             :         {
     243           0 :             if  (   ( _rEvent.GetWindow() == &m_rWindow )
     244           0 :                 &&  (   ( _rEvent.GetId() == VCLEVENT_RADIOBUTTON_TOGGLE )
     245           0 :                     ||  ( _rEvent.GetId() == VCLEVENT_CHECKBOX_TOGGLE )
     246             :                     )
     247             :                 )
     248           0 :                 return true;
     249           0 :             return false;
     250             :         }
     251             :     };
     252             : 
     253             :     //=====================================================================
     254             :     //= RadioDependentEnabler
     255             :     //=====================================================================
     256             :     /** a ->DialogController derivee which enables or disables its dependent windows,
     257             :         depending on the check state of a radio button.
     258             : 
     259             :         The usage of this class is as simple as
     260             :         <code>
     261             :         pController = new RadioDependentEnabler( m_aOptionSelectSomething );
     262             :         pController->addDependentWindow( m_aLabelSelection );
     263             :         pController->addDependentWindow( m_aListSelection );
     264             :         </code>
     265             : 
     266             :         With this, both <code>m_aLabelSelection</code> and <code>m_aListSelection</code> will
     267             :         be disabled if and only <code>m_aOptionSelectSomething</code> is checked.
     268             :     */
     269           0 :     class SVT_DLLPUBLIC RadioDependentEnabler : public DialogController
     270             :     {
     271             :     public:
     272           0 :         RadioDependentEnabler( RadioButton& _rButton )
     273             :             :DialogController( _rButton,
     274           0 :                 PWindowEventFilter( new FilterForRadioOrCheckToggle( _rButton ) ),
     275           0 :                 PWindowOperator( new EnableOnCheck< RadioButton >( _rButton ) ) )
     276             :         {
     277           0 :         }
     278             : 
     279           0 :         RadioDependentEnabler( CheckBox& _rBox )
     280             :             :DialogController( _rBox,
     281           0 :                 PWindowEventFilter( new FilterForRadioOrCheckToggle( _rBox ) ),
     282           0 :                 PWindowOperator( new EnableOnCheck< CheckBox >( _rBox ) ) )
     283             :         {
     284           0 :         }
     285             :     };
     286             : 
     287             : //........................................................................
     288             : } // namespace svt
     289             : //........................................................................
     290             : 
     291             : #endif // SVTOOLS_DIALOGCONTROLLING_HXX
     292             : 
     293             : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */

Generated by: LCOV version 1.10