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: */
|
