used to control the life-time of the component
Used by a status bar implementation to control the life-time of
a status bar controller. The status bar is the only instance which
is allowed to dispose the component.
used to initialize a component with required arguments.
A status bar controller is initialized with five additional
arguments provided as a sequence of
::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.
StatusbarItem a ::com::sun::star::ui::XStatusbarItem
instance which represents the status bar item asociated with
this controller.
ParentWindow a com::sun::star::awt::Window
instance which represents the parent window (status bar window).
ModuleName a string which specifies the name of the
office module attached to the frame to which this controller
belongs; the value is taken from
XModuleManager::identify().
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.
Usage Restrictions
not published
Description
interface to be implemented by a component offering a more complex user
interface to users within a status bar.
A generic status bar field is represented as a simple text field. A status
bar controller can be added to a Statusbar and provide information or
functions with a more sophisticated user interface.
A typical example for status bar controller is a zoom chooser. It shows
the current zoom and provides general zoom levels on a popup menu
that can be activated by a mouse action for context menus.
is called by a status bar if the mouse position is within the controller
and a mouse button has been pressed. If the controller has captured the
mouse input this function is also called when the mouse position is not
within the controller.
is called by a status bar if the mouse position is within the controller
and a mouse has been moved. If the controller has captured the
mouse input this function is also called when the mouse position is not
within the controller.
is called by a status bar if the mouse position is within the controller
and a mouse button has been released. If the controller has captured the
mouse input this function is also called when the mouse position is not
within the controller.
is called by a status bar if the mouse position is within the controller
and a mouse button has been pressed. If the controller has captured the
mouse input this function is also called when the mouse position is not
within the controller.
Parameter aMouseEvent
current information about the mouse pointer.
Returns
return true if the event should not be processed and false
if the event should be processed by the status bar.
is called by a status bar if the mouse position is within the controller
and a mouse has been moved. If the controller has captured the
mouse input this function is also called when the mouse position is not
within the controller.
Parameter aMouseEvent
current information about the mouse pointer.
Returns
return true if the event should not be processed and false
if the event should be processed by the status bar.
is called by a status bar if the mouse position is within the controller
and a mouse button has been released. If the controller has captured the
mouse input this function is also called when the mouse position is not
within the controller.
Parameter aMouseEvent
current information about the mouse pointer.
Returns
return true if the event should not be processed and false
if the event should be processed by the status bar.
