XStateChangeListener Interface Reference

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

import"XStateChangeListener.idl";

Inheritance diagram for XStateChangeListener:

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

aEvent	specifies the object that is going to change own state
nOldState	specifies the old state of the object
nNewState	specifies the new state of the object

Exceptions

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
	)

is called after the object has changed state.

Parameters

aEvent	specifies the object that has changed own state
nOldState	specifies the old state of the object
nNewState	specifies the new state of the object

---

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

• com/sun/star/embed/XStateChangeListener.idl