(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.
Overview Module Use Devguide Index
Methods' Summary Attributes' Summary Methods' Details Attributes' Details

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

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

A generic toolbar function is represented as a button which has a state (enabled,disabled and selected, not selected). A toolbar controller can be added to a toolbar and provide information or functions with a more sophisticated user interface.
A typical example for toolbar controller is a font chooser on a toolbar. It provides all available fonts in a dropdown box and shows the current chosen font.

Since
OOo 2.0.0
See also
XDispatchProvider
Methods' Summary
execute provides a function to execute the command which is bound to the toolbar controller.  
click notifies a component that a single click has been made on the toolbar item.  
doubleClick notifies a component that a double click has been made on the toolbar item.  
createPopupWindow requests to create a popup window for additional functions.  
createItemWindow requests to create an item window which can be added to the toolbar.  
Methods' Details
execute
void
execute( [in] short  KeyModifier );
Description
provides a function to execute the command which is bound to the toolbar controller.
Parameter a
combination of ::com::sun::star::awt::KeyModifier value that represent the current state of the modifier keys.

This function is usally called by a toolbar implementation when a user clicked on a toolbar button or pressed enter on the keyboard when the item has the input focus.

click
void
click();
Description
notifies a component that a single click has been made on the toolbar item.
doubleClick
void
doubleClick();
Description
notifies a component that a double click has been made on the toolbar item.
createPopupWindow
::com::sun::star::awt::XWindow
createPopupWindow();
Description
requests to create a popup window for additional functions.
Returns
a ::com::sun::star::awt::XWindow which provides additional functions to the user. The reference must be empty if component does not want to provide a separate window.
createItemWindow
::com::sun::star::awt::XWindow
createItemWindow( [in] ::com::sun::star::awt::XWindow  Parent );
Description
requests to create an item window which can be added to the toolbar.
Parameter Parent
a ::com::sun::star::awt::XWindow which must be used as a parent for the requested item window.
Returns
a ::com::sun::star::awt::XWindow which can be added to a toolbar. The reference must be empty if a component does not want to provide an item window.
Top of Page

Copyright © 1995, 2010, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.