module com { module sun { module star { module ui {
 
//============================================================================= 
 
/** This interface enables the object to be registered as an interceptor
    to change context menus or prevent them from being executed.
*/
 
published interface XContextMenuInterceptor : ::com::sun::star::uno::XInterface
{
    //-------------------------------------------------------------------------
    /** notifies the interceptor about the request to execute a context menu.
        The interceptor has to decide whether the menu should be executed with
        or without being modified or may ignore the call.
 
        @param aEvent
            provides information about the current context menu and other
            related data like mouse position, window and selection.
 
        @return 
            action which determines how the interception implementation should 
            proceed.
    */
    ContextMenuInterceptorAction notifyContextMenuExecute([in] ContextMenuExecuteEvent aEvent);
};
 
}; }; }; };

module com { module sun { module star { module ui {
 
//============================================================================= 
 
/** This interface enables the object to get interceptors registered that
    change context menu or prevent them from being executed.
*/
 
published interface XContextMenuInterception : ::com::sun::star::uno::XInterface
{
    //-------------------------------------------------------------------------
    /** registers am XContextMenuInterceptor, which will become the first
        interceptor in the chain of registered interceptors.
 
        @param Interceptor
            an interceptor which should be added at the start of the
            interceptor chain.
 
    */
    void registerContextMenuInterceptor([in] XContextMenuInterceptor Interceptor);
 
    //-------------------------------------------------------------------------
    /** removes an XContextMenuInterceptor which was previously registered
        using XContextMenuInterception::registerContextMenuInterceptor.
 
        The order of removals is arbitrary. It's not necessary to remove the
        last registered interceptor first.
 
        @param Interceptor
            an interceptor which should be removed from the interceptor
            chain.
 
    */
    void releaseContextMenuInterceptor([in] XContextMenuInterceptor Interceptor);
};
 
}; }; }; };

module com { module sun { module star { module ui {
 
//============================================================================= 
 
/** This interface enables the object to get interceptors registered that
    change context menu or prevent them from being executed.
*/
 
published enum ContextMenuInterceptorAction
{
    /** the XContextMenuInterceptor has ignored the call. The next registered
        interceptor should be notified.
    */
    IGNORED,
 
    /** the context menu must not be executed. The next registered interceptor
        should not be notified.
    */
    CANCELLED,
 
    /** the menu has been modified and should be executed without notifying the
        next registered interceptor.
    */
    EXECUTE_MODIFIED,
 
    /** the menu has been modified and the next registered interceptor should
        be notified.
    */
    CONTINUE_MODIFIED
};
 
}; }; }; };