xref: /trunk/main/odk/examples/DevelopersGuide/Forms/ButtonOperator.java (revision cdf0e10c4e3984b49a9502b011690b615761d4a3)
1 /*************************************************************************
2  *
3  *  The Contents of this file are made available subject to the terms of
4  *  the BSD license.
5  *
6  *  Copyright 2000, 2010 Oracle and/or its affiliates.
7  *  All rights reserved.
8  *
9  *  Redistribution and use in source and binary forms, with or without
10  *  modification, are permitted provided that the following conditions
11  *  are met:
12  *  1. Redistributions of source code must retain the above copyright
13  *     notice, this list of conditions and the following disclaimer.
14  *  2. Redistributions in binary form must reproduce the above copyright
15  *     notice, this list of conditions and the following disclaimer in the
16  *     documentation and/or other materials provided with the distribution.
17  *  3. Neither the name of Sun Microsystems, Inc. nor the names of its
18  *     contributors may be used to endorse or promote products derived
19  *     from this software without specific prior written permission.
20  *
21  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24  *  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25  *  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26  *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  *  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
28  *  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
29  *  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
30  *  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
31  *  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  *
33  *************************************************************************/
34 // java base stuff
35 import com.sun.star.awt.ActionEvent;
36 import com.sun.star.awt.XActionListener;
37 import com.sun.star.awt.XButton;
38 import com.sun.star.beans.XPropertySet;
39 import com.sun.star.form.runtime.FormOperations;
40 import com.sun.star.form.runtime.XFeatureInvalidation;
41 import com.sun.star.form.runtime.XFormOperations;
42 import com.sun.star.lang.EventObject;
43 import com.sun.star.uno.UnoRuntime;
44 import com.sun.star.uno.XComponentContext;
45 import java.util.Vector;
46 
47 
48 /**************************************************************************/
49 /** a helper class for operating the buttons
50 */
51 public class ButtonOperator implements XActionListener, XFeatureInvalidation
52 {
53     private XComponentContext   m_componentContext;
54     private DocumentHelper      m_aDocument;
55     private XPropertySet        m_form;
56     private XFormOperations     m_formOperations;
57 
58     private Vector              m_aButtons;
59 
60     /* ------------------------------------------------------------------ */
61     /** ctor
62     */
63     public ButtonOperator( XComponentContext xCtx, DocumentHelper aDocument, XPropertySet _form )
64     {
65         m_componentContext = xCtx;
66         m_aDocument = aDocument;
67         m_form = _form;
68         m_aButtons = new Vector();
69     }
70 
71     /* ------------------------------------------------------------------ */
72     private short getAssociatedFormFeature( XPropertySet _buttonModel )
73     {
74         short formFeature = -1;
75         try
76         {
77             formFeature = Short.valueOf( (String)_buttonModel.getPropertyValue( "Tag" ) );
78         }
79         catch( com.sun.star.uno.Exception e )
80         {
81         }
82         return formFeature;
83     }
84 
85     /* ------------------------------------------------------------------ */
86     /** get's the button which we operate and which is responsible for a given URL
87     */
88     private XPropertySet getButton( short _formFeature )
89     {
90         for ( int i=0; i < m_aButtons.size(); ++i )
91         {
92             XPropertySet button = (XPropertySet)m_aButtons.elementAt( i );
93             if ( _formFeature == getAssociatedFormFeature( button ) )
94                 return button;
95         }
96         return null;
97     }
98 
99     /* ------------------------------------------------------------------ */
100     /** announces a button which the operator should be responsible for
101     */
102     private int getButtonIndex( XPropertySet xButton )
103     {
104         int nPos = -1;
105         for ( int i=0; ( i < m_aButtons.size() ) && ( -1 == nPos ); ++i )
106         {
107             if ( xButton.equals( m_aButtons.elementAt( i ) ) )
108                 nPos = i;
109         }
110         return nPos;
111     }
112 
113     /* ------------------------------------------------------------------ */
114     /** announces a button which the operator should be responsible for
115     */
116     public void addButton( XPropertySet _buttonModel, short _formFeature  ) throws java.lang.Exception
117     {
118         // the current view to the document
119         DocumentViewHelper aCurrentView = m_aDocument.getCurrentView();
120 
121         // add a listener so we get noticed if the user presses the button
122         XButton xButtonControl = (XButton)UnoRuntime.queryInterface( XButton.class,
123             aCurrentView.getFormControl( _buttonModel ) );
124         xButtonControl.addActionListener( this );
125 
126         _buttonModel.setPropertyValue( "Tag", String.valueOf( _formFeature ) );
127 
128         // remember the button
129         m_aButtons.add( _buttonModel );
130     }
131 
132     /* ------------------------------------------------------------------ */
133     public void revokeButton( XPropertySet xButtonModel )
134     {
135         int nPos = getButtonIndex( xButtonModel );
136         if ( -1 < nPos )
137         {
138             m_aButtons.remove( nPos );
139         }
140     }
141 
142     /* ==================================================================
143        = XActionListener
144        ================================================================== */
145     /* ------------------------------------------------------------------ */
146     /* called when a button has been pressed
147     */
148     public void actionPerformed( ActionEvent aEvent ) throws com.sun.star.uno.RuntimeException
149     {
150         // get the model's name
151         XPropertySet buttonModel = (XPropertySet)FLTools.getModel( aEvent.Source, XPropertySet.class );
152         try
153         {
154             short formFeature = getAssociatedFormFeature( buttonModel );
155             if ( formFeature != -1 )
156                 m_formOperations.execute( formFeature );
157         }
158         catch( final com.sun.star.uno.Exception e )
159         {
160         }
161     }
162 
163     /* ------------------------------------------------------------------ */
164     /* (to be) called when the form layer has been switched to alive mode
165      * @todo
166      *  register as listener somewhere ...
167     */
168     public void onFormsAlive()
169     {
170         try
171         {
172             m_formOperations = FormOperations.createWithFormController(
173                 m_componentContext, m_aDocument.getCurrentView().getFormController( m_form ) );
174             m_formOperations.setFeatureInvalidation( this );
175             invalidateAllFeatures();
176         }
177         catch( final com.sun.star.uno.Exception e )
178         {
179         }
180     }
181 
182     /* ==================================================================
183        = XEventListener
184        ================================================================== */
185     public void disposing( EventObject aEvent )
186     {
187         // not interested in
188     }
189 
190     /* ==================================================================
191        = XFeatureInvalidation
192        ================================================================== */
193     private void updateButtonState( XPropertySet _buttonModel, short _formFeature )
194     {
195         try
196         {
197             _buttonModel.setPropertyValue( "Enabled", m_formOperations.isEnabled( _formFeature ) );
198         }
199         catch( com.sun.star.uno.Exception e )
200         {
201         }
202     }
203 
204     public void invalidateFeatures( short[] _features ) throws com.sun.star.uno.RuntimeException
205     {
206         for ( int i=0; i<_features.length; ++i )
207         {
208             XPropertySet buttonModel = getButton( _features[i] );
209             if ( buttonModel != null )
210                 updateButtonState( buttonModel, _features[i] );
211         }
212     }
213 
214     public void invalidateAllFeatures() throws com.sun.star.uno.RuntimeException
215     {
216         for ( int i=0; i < m_aButtons.size(); ++i )
217         {
218             XPropertySet buttonModel = (XPropertySet)m_aButtons.elementAt( i );
219             updateButtonState( buttonModel, getAssociatedFormFeature( buttonModel ) );
220         }
221     }
222 };
223 
224