:: com :: sun :: star :: frame ::

unpublished service StatusbarController
Usage Restrictions
not published
Description
is an abstract service for a component which offers a more complex user interface to users within a status bar.

A generic status bar function is represented as a text field which provides status information to the user. A status bar controller can be added to a status bar and provides information or functions with a more sophisticated user interface.
A typical example for a status bar controller is the zoom level chooser within the statusbar. It provides an option to change the zoom level of an application.

Since
OOo 2.0
See also
XDispatchProvider, XStatusbarController

Exported Interfaces - Summary
XStatusListener

with this interface a component can receive events if a feature has changed. (details)

::com::sun::star::lang::XInitialization

used to initialize a component with required arguments. A status bar controller needs at least three additional arguments provided as ::com::sun::star::beans::PropertyValue: (details)

::com::sun::star::util::XUpdatable

used to notify an implementation that it needs to add its listener or remove and add them again. (details)

XStatusbarController

used to notify changed features and requests for additional user interface items. (details)

Exported Interfaces - Details
XStatusListener
Description
with this interface a component can receive events if a feature has changed.

The status bar controller implementation should register itself as a listener when its XUpdatable interface has been called.

::com::sun::star::lang::XInitialization
Description
used to initialize a component with required arguments. A status bar controller needs at least three additional arguments provided as ::com::sun::star::beans::PropertyValue:
  • Frame
    a XFrame instance to which the status bar controller belongs.
  • CommandURL
    a string which specifies the command associated with the statusbar controller. The command is used to identify the status bar controller implementation.
  • ServiceManager
    a ::com::sun::star::lang::XMultiServiceFactory instance which can be used to create additional UNO services.
  • Parent
    a com::sun::star::awt::Window instance which represents the parent window (status bar window).
  • Identifier
    an integer value which is the unique id used by the status bar implementation to identify a status bar entry. This value is currently only used by internal OpenOffice.org status bar controller implementations.
::com::sun::star::util::XUpdatable
Description
used to notify an implementation that it needs to add its listener or remove and add them again.

A status bar controller instance is ready for use after this call has been made the first time. The status bar implementation guarentees that the controller's item window has been added to the status bar and its reference is held by it.

XStatusbarController
Description
used to notify changed features and requests for additional user interface items.

Mostly used by a status bar implementation to forward information to and request services from a status bar controller component. This interface must be useable after com::sun::star::lang::XInitialitation::initialize has been called. The behavior of the interface is undefined if the controller component hasn't been initialized.


 
Top of Page