LibreOffice
LibreOffice 24.2 SDK API Reference
Public Member Functions | List of all members
XStateChangeListener Interface Referencepublished

makes it possible to receive events when an embedded object changes it's state. More...

import"XStateChangeListener.idl";

Inheritance diagram for XStateChangeListener:
XEventListener XInterface

Public Member Functions

void changingState ([in] com::sun::star::lang::EventObject aEvent, [in] long nOldState, [in] long nNewState) raises ( ::com::sun::star::embed::WrongStateException )
 is called just before the object changes state. More...
 
void stateChanged ([in] com::sun::star::lang::EventObject aEvent, [in] long nOldState, [in] long nNewState)
 is called after the object has changed state. More...
 
- Public Member Functions inherited from XEventListener
void disposing ([in] com::sun::star::lang::EventObject Source)
 gets called when the broadcaster is about to be disposed. More...
 
- Public Member Functions inherited from XInterface
any queryInterface ([in] type aType)
 queries for a new interface to an existing UNO object. More...
 
void acquire ()
 increases the reference counter by one. More...
 
void release ()
 decreases the reference counter by one. More...
 

Detailed Description

makes it possible to receive events when an embedded object changes it's state.

Member Function Documentation

◆ changingState()

void changingState ( [in] com::sun::star::lang::EventObject  aEvent,
[in] long  nOldState,
[in] long  nNewState 
)
raises (::com::sun::star::embed::WrongStateException
)

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.

Parameters
aEventspecifies the object that is going to change own state
nOldStatespecifies the old state of the object
nNewStatespecifies the new state of the object
Exceptions
com::sun::star::embed::WrongStateExceptionthe state change is unexpected by listener

◆ stateChanged()

void stateChanged ( [in] com::sun::star::lang::EventObject  aEvent,
[in] long  nOldState,
[in] long  nNewState 
)

is called after the object has changed state.

Parameters
aEventspecifies the object that has changed own state
nOldStatespecifies the old state of the object
nNewStatespecifies the new state of the object

The documentation for this interface was generated from the following file: