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

unpublished interface XToolBarController
Base Interfaces
XToolBarControllerXResourceController

XResourceController
Description
Manage the set of active tool bars and their factories.

Methods' Summary
addToolBarFactory Register a new tool bar factory for the given URL.  
removeToolBarFactoryForURL Remove a factory for one type of tool bar. When the factory has been registered for other URLs as well then they remain registered. Use the removeToolBarFactoryForReference() to remove a factory completely.  
removeToolBarFactoryForReference Remove a factory for tool bar types it has been registered for. Use removeToolBarFactoryForURL() to remove a factory just for one URL and to leave it registered for others.  
getToolBar Return the tool bar object that has been created for the given XResourceId object.  
Methods' Details
addToolBarFactory
void
addToolBarFactory( [in] string  sToolBarURL,
[in] XToolBarFactory  xToolBarFactory );

Description
Register a new tool bar factory for the given URL.

When one factory is responsible for more than one type of tool bar then this method has to be called for each time. If this method is called multiple times for the same URL then a previously registered factory is removed for the URL.

Parameter sToolBarURL
The URL of the tool bar that the factory can create.
Parameter xToolBarFactory
The factory object.
removeToolBarFactoryForURL
void
removeToolBarFactoryForURL( [in] string  sToolBarURL );

Description
Remove a factory for one type of tool bar. When the factory has been registered for other URLs as well then they remain registered. Use the removeToolBarFactoryForReference() to remove a factory completely.
Parameter sToolBarURL
The URL for which to remove the factory.
removeToolBarFactoryForReference
void
removeToolBarFactoryForReference( [in] XToolBarFactory  xToolBarFactory );

Description
Remove a factory for tool bar types it has been registered for. Use removeToolBarFactoryForURL() to remove a factory just for one URL and to leave it registered for others.
Parameter xToolBarFactory
The factory object to remove.
getToolBar
XToolBar
getToolBar( [in] XResourceId  xToolBarId );

Description
Return the tool bar object that has been created for the given XResourceId object.
Returns
Returns an empty reference when no tool bar has been created yet for the given ResourceId .
Top of Page