LibreOffice
LibreOffice 24.2 SDK API Reference
Public Member Functions | List of all members
XSubToolbarController Interface Reference

special interface to support sub-toolbars in a controller implementation. More...

import"XSubToolbarController.idl";

Inheritance diagram for XSubToolbarController:
XInterface ToolbarController

Public Member Functions

boolean opensSubToolbar ()
 if the controller features a sub-toolbar. More...
 
string getSubToolbarName ()
 provides the resource URL of the sub-toolbar this controller opens. More...
 
void functionSelected ([in] string aCommand)
 gets called to notify a controller that a sub-toolbar function has been selected. More...
 
void updateImage ()
 gets called to notify a controller that it should set an image which represents the current selected function. 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

special interface to support sub-toolbars in a controller implementation.

This interface is normally used to implement the toolbar button/sub- toolbar function feature. It exchanges the function of the toolbar button, that opened the sub-toolbar, with the one that has been selected on the sub-toolbar.

See also
com::sun::star::frame::ToolbarController
Since
OOo 2.0

Member Function Documentation

◆ functionSelected()

void functionSelected ( [in] string  aCommand)

gets called to notify a controller that a sub-toolbar function has been selected.

Parameters
aCommanda string which identifies the function that has been selected by a user.

◆ getSubToolbarName()

string getSubToolbarName ( )

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.

◆ opensSubToolbar()

boolean opensSubToolbar ( )

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.

◆ updateImage()

void updateImage ( )

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.


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