1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef EXTENSIONS_SOURCE_PROPCTRLR_EVENTHANDLER_HXX
#define EXTENSIONS_SOURCE_PROPCTRLR_EVENTHANDLER_HXX
#include "pcrcomponentcontext.hxx"
#include "pcrcommontypes.hxx"
#include "pcrcommon.hxx"
#include <com/sun/star/script/ScriptEventDescriptor.hpp>
#include <com/sun/star/lang/XServiceInfo.hpp>
#include <com/sun/star/inspection/XPropertyHandler.hpp>
#include <com/sun/star/beans/XPropertySet.hpp>
#include <com/sun/star/frame/XFrame.hpp>
#include <cppuhelper/compbase2.hxx>
#include <comphelper/listenernotification.hxx>
//........................................................................
namespace pcr
{
//........................................................................
//====================================================================
//= EventDescription
//====================================================================
typedef sal_Int32 EventId;
struct EventDescription
{
public:
OUString sDisplayName;
OUString sListenerClassName;
OUString sListenerMethodName;
OString sHelpId;
OString sUniqueBrowseId;
EventId nId;
EventDescription()
:nId( 0 )
{
}
EventDescription(
EventId _nId,
const sal_Char* _pListenerNamespaceAscii,
const sal_Char* _pListenerClassAsciiName,
const sal_Char* _pListenerMethodAsciiName,
sal_uInt16 _nDisplayNameResId,
const OString& _sHelpId,
const OString& _sUniqueBrowseId );
};
typedef ::boost::unordered_map< OUString, EventDescription, OUStringHash > EventMap;
//====================================================================
//= EventHandler
//====================================================================
typedef ::cppu::WeakComponentImplHelper2 < ::com::sun::star::inspection::XPropertyHandler
, ::com::sun::star::lang::XServiceInfo
> EventHandler_Base;
class EventHandler : public EventHandler_Base
{
private:
mutable ::osl::Mutex m_aMutex;
/// the context in which the instance was created
ComponentContext m_aContext;
/// the properties of the object we're handling
::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySet > m_xComponent;
/// our XPropertyChangeListener(s)
PropertyChangeListeners m_aPropertyListeners;
/// cache of the events we found at our introspectee
EventMap m_aEvents;
/// has m_aEvents been initialized?
bool m_bEventsMapInitialized;
/// is our introspectee a dialog element?
bool m_bIsDialogElement;
// TODO: move different handling into different derived classes?
/// (FormComponent) type of the grid column being inspected, or -1 if we're not inspecting a grid column
sal_Int16 m_nGridColumnType;
public:
// XServiceInfo - static versions
static OUString SAL_CALL getImplementationName_static( ) throw (::com::sun::star::uno::RuntimeException);
static ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames_static( ) throw (::com::sun::star::uno::RuntimeException);
static ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > Create( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext );
protected:
EventHandler(
const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext
);
~EventHandler();
protected:
// XPropertyHandler overridables
virtual void SAL_CALL inspect( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxIntrospectee ) throw (::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Any SAL_CALL getPropertyValue( const OUString& _rPropertyName ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException);
virtual void SAL_CALL setPropertyValue( const OUString& _rPropertyName, const ::com::sun::star::uno::Any& _rValue ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Any SAL_CALL convertToPropertyValue( const OUString& _rPropertyName, const ::com::sun::star::uno::Any& _rControlValue ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Any SAL_CALL convertToControlValue( const OUString& _rPropertyName, const ::com::sun::star::uno::Any& _rPropertyValue, const ::com::sun::star::uno::Type& _rControlValueType ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::beans::PropertyState SAL_CALL getPropertyState( const OUString& _rPropertyName ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException);
virtual void SAL_CALL addPropertyChangeListener( const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener >& _rxListener ) throw (::com::sun::star::uno::RuntimeException);
virtual void SAL_CALL removePropertyChangeListener( const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener >& _rxListener ) throw (::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Sequence< ::com::sun::star::beans::Property >
SAL_CALL getSupportedProperties() throw (::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupersededProperties( ) throw (::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getActuatingProperties( ) throw (::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::inspection::LineDescriptor SAL_CALL describePropertyLine( const OUString& _rPropertyName, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControlFactory >& _rxControlFactory ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException);
virtual ::sal_Bool SAL_CALL isComposable( const OUString& _rPropertyName ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::inspection::InteractiveSelectionResult
SAL_CALL onInteractivePropertySelection( const OUString& _rPropertyName, sal_Bool _bPrimary, ::com::sun::star::uno::Any& _rData, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XObjectInspectorUI >& _rxInspectorUI ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException);
virtual void SAL_CALL actuatingPropertyChanged( const OUString& _rActuatingPropertyName, const ::com::sun::star::uno::Any& _rNewValue, const ::com::sun::star::uno::Any& _rOldValue, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XObjectInspectorUI >& _rxInspectorUI, sal_Bool _bFirstTimeInit ) throw (::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException);
virtual sal_Bool SAL_CALL suspend( sal_Bool _bSuspend ) throw (::com::sun::star::uno::RuntimeException);
// XComponent
DECLARE_XCOMPONENT()
virtual void SAL_CALL disposing();
// XServiceInfo
virtual OUString SAL_CALL getImplementationName( ) throw (::com::sun::star::uno::RuntimeException);
virtual ::sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) throw (::com::sun::star::uno::RuntimeException);
virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames( ) throw (::com::sun::star::uno::RuntimeException);
private:
/** returns the script events associated with our introspectee
@param _out_rEvents
Takes, upon successfull return, the events currently associated with the introspectee
@precond
Our introspectee is a form component
*/
void impl_getFormComponentScriptEvents_nothrow(
::com::sun::star::uno::Sequence< ::com::sun::star::script::ScriptEventDescriptor >& _out_rEvents
) const;
/** returns the script events associated with our introspectee
@param _out_rEvents
Takes, upon successfull return, the events currently associated with the introspectee
@precond
Our introspectee is a dialog element
*/
void impl_getDialogElementScriptEvents_nothrow(
::com::sun::star::uno::Sequence< ::com::sun::star::script::ScriptEventDescriptor >& _out_rEvents
) const;
/** returns the script events associated with our introspectee
@param _out_rEvents
Takes, the events currently associated with the introspectee
*/
inline void impl_getComponentScriptEvents_nothrow(
::com::sun::star::uno::Sequence< ::com::sun::star::script::ScriptEventDescriptor >& _out_rEvents
) const
{
if ( m_bIsDialogElement )
impl_getDialogElementScriptEvents_nothrow( _out_rEvents );
else
impl_getFormComponentScriptEvents_nothrow( _out_rEvents );
}
/** returns the types of the listeners which can be registered at our introspectee
@param _out_rTypes
Takes, upon successfull return, the types of possible listeners at the introspectee
*/
void impl_getCopmonentListenerTypes_nothrow(
::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type >& _out_rTypes
) const;
/** returns a secondary component to be used for event inspection
In the UI, we want to mix events for the control model with events for the control.
Since our introspectee is a model, this method creates a control for it (if possible).
@return
the secondary component whose events should be mixed with the introspectee's events
The caller takes the ownership of the component (if not <NULL/>).
@throws
if an unexpected error occurs during creation of the secondary component.
A <NULL/> component to be returned is not unexpected, but allowed
@precond
->m_xComponent is not <NULL/>
*/
::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >
impl_getSecondaryComponentForEventInspection_throw( ) const;
/** returns the event description for the given (programmatic) property name
@param _rPropertyName
the name whose event description should be looked up
@return
the event description for the property name
@throws ::com::sun::star::beans::UnknownPropertyException
if our introspectee does not have an event with the given logical name (see ->getSupportedProperties)
*/
const EventDescription&
impl_getEventForName_throw( const OUString& _rPropertyName ) const;
/** returns the index of our component within its parent, if this parent can be
obtained (XChild::getParent) and supports an ->XIndexAccess interface
*/
sal_Int32 impl_getComponentIndexInParent_throw() const;
/** sets a given script event as event handler at a form component
@param _rScriptEvent
the script event to set
*/
void impl_setFormComponentScriptEvent_nothrow( const ::com::sun::star::script::ScriptEventDescriptor& _rScriptEvent );
/** sets a given script event as event handler at a dialog component
@param _rScriptEvent
the script event to set
*/
void impl_setDialogElementScriptEvent_nothrow( const ::com::sun::star::script::ScriptEventDescriptor& _rScriptEvent );
/** returns the frame associated with our context document
*/
::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >
impl_getContextFrame_nothrow() const;
/** approves or denies a certain method to be included in the UI
@return
<TRUE/> if and only if the given method is allowed.
*/
bool impl_filterMethod_nothrow( const EventDescription& _rEvent ) const;
private:
EventHandler(); // never implemented
EventHandler( const EventHandler& ); // never implemented
EventHandler& operator=( const EventHandler& ); // never implemented
};
//........................................................................
} // namespace pcr
//........................................................................
#endif // EXTENSIONS_SOURCE_PROPCTRLR_EVENTHANDLER_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
