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

interface XSubToolbarController

Methods' Summary
opensSubToolbar if the controller features a sub-toolbar.  
getSubToolbarName provides the resource URL of the sub-toolbar this controller opens.  
functionSelected gets called to notify a controller that a sub-toolbar function has been selected.  
updateImage gets called to notify a controller that it should set an image which represents the current selected function.  
Methods' Details
opensSubToolbar
boolean
opensSubToolbar();

Description
if the controller features a sub-toolbar.
Returns
true if the controller offers a sub toolbar, otherwise false.

Enables implementations to dynamically decide to support sub-toolbars or not.

getSubToolbarName
string
getSubToolbarName();

Description
provides the resource URL of the sub-toolbar this controller opens.
Returns
name of the sub-toolbar this controller offers. A empty string will be interpreted as if this controller offers no sub-toolbar.
functionSelected
void
functionSelected( [in] string  aCommand );

Description
gets called to notify a controller that a sub-toolbar function has been selected.
Parameter aCommand
a string which identifies the function that has been selected by a user.
updateImage
void
updateImage();

Description
gets called to notify a controller that it should set an image which represents the current selected function.

Only the controller instance is able to set the correct image for the current function. A toolbar implementation will ask sub-toolbar controllers to update their image whenever it has to update the images of all its buttons.

Top of Page