Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: star :: embed ::

interface XStateChangeListener
Base Interfaces
XStateChangeListener
┗ ::com::sun::star::lang::XEventListener

::com::sun::star::lang::XEventListener
(referenced interface's summary:)
base interface for all event listeners interfaces.
Description
makes it possible to receive events when an embedded object changes it's state.

Methods' Summary
changingState is called just before the object changes state.  
stateChanged is called after the object has changed state.  
Methods' Details
changingState
void
changingState( [in] ::com::sun::star::lang::EventObject  aEvent,
[in] long  nOldState,
[in] long  nNewState )
raises( WrongStateException );

Description
is called just before the object changes state.

Actually the listener can try to complain about state changing, but it is up to object to decide whether the state change can be prevented. Anyway the possibility to complain must be used very carefully.

Parameter aEvent
specifies the object that is going to change own state
Parameter nOldState
specifies the old state of the object
Parameter nNewState
specifies the new state of the object
Throws
::com::sun::star::embed::WrongStateException the state change is unexpected by listener
stateChanged
void
stateChanged( [in] ::com::sun::star::lang::EventObject  aEvent,
[in] long  nOldState,
[in] long  nNewState );

Description
is called after the object has changed state.
Parameter aEvent
specifies the object that has changed own state
Parameter nOldState
specifies the old state of the object
Parameter nNewState
specifies the new state of the object
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.