/************************************************************** * * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. * *************************************************************/ #ifndef __com_sun_star_frame_PopupMenuController_idl__ #define __com_sun_star_frame_PopupMenuController_idl__ #ifndef __com_sun_star_frame_XPopupMenuController_idl__ #include #endif #ifndef _com_sun_star_lang_XInitialization_idl__ #include #endif #ifndef __com_sun_star_frame_XStatusListener_idl__ #include #endif #ifndef __com_sun_star_frame_XDispatchProvider_idl__ #include #endif #ifndef __com_sun_star_lang_XComponent_idl__ #include #endif //============================================================================= module com { module sun { module star { module frame { //============================================================================= /** provides access to a popup menu controller.

A popup menu controller is used to make special functions available to users, which depend on runtime or context specific conditions.
A typical example for a popup menu controller can be a recent file list implementation which provides a list of latest files that a user has worked on. This list gets changes consistently during a work session.

@since OpenOffice 2.0 */ service PopupMenuController { //------------------------------------------------------------------------- /** supports functions to initialize and update a popup menu controller implementation.

A popup menu controller implementation gets initialized with a XPopupMenu object. This assures that a popup menu controller can be implemented with any UNO based language.

*/ interface com::sun::star::frame::XPopupMenuController; //------------------------------------------------------------------------- /** provides functions to initialize a popup menu controller with specific data which are needed.

This interface should not directly used. A factory service is responsible to initialize every controller correctly.
A popup menu controller needs at least two additional arguments provided as PropertyValue:

  • Frame
    specifies the XFrame instance to which the popup menu controller belongs to.
  • CommandURL
    specifies which popup menu controller should be created.

@see PopupMenuControllerFactory */ interface com::sun::star::lang::XInitialization; //------------------------------------------------------------------------- /** used to brief the popup menu controller with new status information.

A popup menu controller makes special functions available to users which normally depend on the state of other data. This interface is used to send this data to a controller implementation.

*/ interface com::sun::star::frame::XStatusListener; //------------------------------------------------------------------------- /** used to query for commands supported by the popup menu controller to execute them directly.

A popup menu controller provides special functions which should be available by the normal dispatch API. This optional interface enables popup menu controller to be normal dispatch providers.
Attention:
Popup menu controller functions must be specified using the following the dispatch URL scheme: "vnd.sun.star.popup:" opaque_part [ "?" query ].

@since OpenOffice 2.2 */ [optional] interface com::sun::star::frame::XDispatchProvider; //------------------------------------------------------------------------- /** used to dispose popup menu controller by the owner instance.

A popup menu controller resides in a menu which has a limited life-time. For correct life-time handling a popup menu controller should support this interface.

@since OpenOffice 2.2 */ [optional] interface com::sun::star::lang::XComponent; }; }; }; }; }; //============================================================================= #endif