Class HandlerSubmission

  • All Implemented Interfaces:
    Comparable

    @Deprecated
    public final class HandlerSubmission
    extends Object
    implements Comparable
    Deprecated.
    Please use IHandlerService.activateHandler instead. This API is scheduled for deletion, see Bug 431177 for details

    An instance of this class represents a request to handle a command. A handler submission specifies a list of conditions under which it would be appropriate for a particular command to have a particular handler. These conditions include things like the active part or the active shell. So, it is possible to say things like: "when my part is active, please consider calling these classes when you want to perform a cut, copy or paste".

    The workbench considers all of the submissions it has received and choses the ones it views as the best possible match.

    This class is not intended to be extended by clients.

    Note: this class has a natural ordering that is inconsistent with equals.

    Since:
    3.0
    See Also:
    IWorkbenchCommandSupport, IHandlerService
    Restriction:
    This class is scheduled for deletion.
    • Constructor Detail

      • HandlerSubmission

        @Deprecated
        public HandlerSubmission​(String activePartId,
                                 Shell activeShell,
                                 IWorkbenchPartSite activeWorkbenchPartSite,
                                 String commandId,
                                 IHandler handler,
                                 Priority priority)
        Deprecated.
        Creates a new instance of this class.
        Parameters:
        activePartId - the identifier of the part that must be active for this request to be considered. May be null.
        activeShell - the shell that must be active for this request to be considered. May be null.
        activeWorkbenchPartSite - the workbench part site of the part that must be active for this request to be considered. May be null.
        commandId - the identifier of the command to be handled. Must not be null.
        handler - the handler. Must not be null.
        priority - the priority. Must not be null.
    • Method Detail

      • getActivePartId

        @Deprecated
        public String getActivePartId()
        Deprecated.
        Returns the identifier of the part that must be active for this request to be considered.
        Returns:
        the identifier of the part that must be active for this request to be considered. May be null.
      • getActiveShell

        @Deprecated
        public Shell getActiveShell()
        Deprecated.
        Returns the shell that must be active for this request to be considered.
        Returns:
        the shell that must be active for this request to be considered. May be null.
      • getActiveWorkbenchPartSite

        @Deprecated
        public IWorkbenchPartSite getActiveWorkbenchPartSite()
        Deprecated.
        Returns the workbench part site of the part that must be active for this request to be considered.
        Returns:
        the workbench part site of the part that must be active for this request to be considered. May be null.
      • getCommandId

        @Deprecated
        public String getCommandId()
        Deprecated.
        Returns the identifier of the command to be handled.
        Returns:
        the identifier of the command to be handled. Guaranteed not to be null.
      • getHandler

        @Deprecated
        public IHandler getHandler()
        Deprecated.
        Returns the handler.
        Returns:
        the handler. Guaranteed not to be null.
      • getPriority

        @Deprecated
        public Priority getPriority()
        Deprecated.
        Returns the priority.
        Returns:
        the priority. Guaranteed not to be null.