:: com :: sun :: star :: drawing :: framework ::

unpublished interface XConfigurationChangeRequest
Description
A single explicit request for a configuration change.

The one explicitly represented change request may lead to other, implicit, configuration changes when executed. For example, when the deactivation of a pane is requested, then the view displayed in it has also to be deactivated.

The requested change is committed to a configuration only when the execute() method is called. Configuration change requests are executed asynchronously. This is done to avoid reentrance problems with objects that are registered as XConfigurationChangeListener and at the same time make configuration change requests. When the requests were executed synchronously then they would be notified of the changes while their request call has not yet returned.

See also
XConfiguration, XConfigurationController

Methods' Summary
execute Commit the configuration change request represented by the called object to the given configuration.  
Methods' Details
execute
void
execute( [in] XConfiguration  xConfiguration );

Description
Commit the configuration change request represented by the called object to the given configuration.
Parameter xConfiguration
This is the configuration to commit the requested change to.
Top of Page