/* -*- 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 .
*/
typedef ::cppu::WeakComponentImplHelper < css::inspection::XPropertyHandler
, css::lang::XServiceInfo
> EventHandler_Base; class EventHandler final : public EventHandler_Base
{ private: mutable ::osl::Mutex m_aMutex;
/// the context in which the instance was created
css::uno::Reference< css::uno::XComponentContext > m_xContext; /// the properties of the object we're handling
css::uno::Reference< css::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;
/** returns the script events associated with our introspectee @param _out_rEvents Takes, upon successful return, the events currently associated with the introspectee @precond Our introspectee is a form component
*/ void impl_getFormComponentScriptEvents_nothrow(
std::vector< css::script::ScriptEventDescriptor >& _out_rEvents
) const;
/** returns the script events associated with our introspectee @param _out_rEvents Takes, upon successful return, the events currently associated with the introspectee @precond Our introspectee is a dialog element
*/ void impl_getDialogElementScriptEvents_nothrow(
std::vector< css::script::ScriptEventDescriptor >& _out_rEvents
) const;
/** returns the script events associated with our introspectee @param _out_rEvents Takes, the events currently associated with the introspectee
*/ void impl_getComponentScriptEvents_nothrow(
std::vector< css::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 successful return, the types of possible listeners at the introspectee
*/ void impl_getComponentListenerTypes_nothrow(
std::vector< css::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/>
*/
css::uno::Reference< css::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 css::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 css::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 css::script::ScriptEventDescriptor& _rScriptEvent );
/** returns the frame associated with our context document
*/
css::uno::Reference< css::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;
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.
