(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 XPopupMenuController
Usage Restrictions
not published
Description
provides data to a popup menu controller implementation to fill and update a popup menu dynamically.

A popup menu controller gets a ::com::sun::star::awt::XPopupMenu from its parent menu implementation. The controller has to fill this popup menu with a set of menu items and/or sub menus. The parent menu implementation briefs the controller whenever the popup menu gets activated by a user.

Since
OOo 2.0.0
Methods' Summary
setPopupMenu provides a ::com::sun::star::awt::XPopupMenu to a popup menu controller implementation. The controller must fill this popup menu with its functions.  
updatePopupMenu briefs the popup menu controller to update the contents of the provided popup menu to reflect the current state.  
Methods' Details
setPopupMenu
void
setPopupMenu( [in] ::com::sun::star::awt::XPopupMenu  PopupMenu );
Description
provides a ::com::sun::star::awt::XPopupMenu to a popup menu controller implementation. The controller must fill this popup menu with its functions.
Parameter PopupMenu
An empty popup menu that must be filled by the popup menu controller.
updatePopupMenu
void
updatePopupMenu();
Description
briefs the popup menu controller to update the contents of the provided popup menu to reflect the current state.

A controller should never update the popup menu structure on its own to prevent performance problems. A better way would be that a controller registers itself as status listener to for a command URL and immediately deregister after that. Therefor status updates will not be send regularly for a non visible popup menu.

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.