Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.ui.help
Interface IWorkbenchHelpSystem


public interface IWorkbenchHelpSystem

The interface that is used to access the workbench help system. Replaces static methods on WorkbenchHelp.

This interface is not intended to be implemented by clients.

Since:
3.1
Restriction:
This interface is not intended to be implemented by clients.

Method Summary
 void displayContext ( IContext context, int x, int y)
          Displays context-sensitive help for the given context.
 void displayDynamicHelp ()
          Displays the dynamic help for the current UI context.
 void displayHelp ()
          Displays the entire help bookshelf.
 void displayHelp ( IContext context)
          Displays context-sensitive help for the given context.
 void displayHelp ( String contextId)
          Calls the help support system to display the given help context id.
 void displayHelpResource ( String href)
          Displays help content for the help resource with the given URL.
 void displaySearch ()
          Displays the help search system.
 boolean hasHelpUI ()
          Returns whether there is a UI help system installed.
 boolean isContextHelpDisplayed ()
          Returns whether the context-sensitive help window is currently being displayed.
  URL resolve ( String href, boolean documentOnly)
          Resolves the help resource href by converting it into a legitimate URL according to the implementation of the help system.
 void search ( String expression)
          Starts the search using the help search system.
 void setHelp ( Control control, String contextId)
          Sets the given help context id on the given control.
 void setHelp ( IAction action, String contextId)
          Sets the given help context id on the given action.
 void setHelp ( MenuItem item, String contextId)
          Sets the given help context id on the given menu item.
 void setHelp ( Menu menu, String contextId)
          Sets the given help context id on the given menu.
 

Method Detail

hasHelpUI

boolean hasHelpUI()
Returns whether there is a UI help system installed.

Returns:
whether there is a UI help system installed

displayHelp

void displayHelp()
Displays the entire help bookshelf.

Ignored if no help UI is available.


displaySearch

void displaySearch()
Displays the help search system.

Ignored if no help UI is available.


displayDynamicHelp

void displayDynamicHelp()
Displays the dynamic help for the current UI context.

Ignored if no help UI is available.


search

void search(
String expression)
Starts the search using the help search system.

Ignored if no help UI is available.

Parameters:
expression - the search expression. The actual syntax rules of the expression are dependent on the active help system. Refer to the help system documentation for more details.

displayContext

void displayContext(
IContext context,
                    int x,
                    int y)
Displays context-sensitive help for the given context.

(x,y) coordinates specify the location where the context sensitive help UI will be presented. These coordinates are screen-relative (ie: (0,0) is the top left-most screen corner). The platform is responsible for calling this method and supplying the appropriate location.

Ignored if no help UI is available.

Parameters:
context - the context to display
x - horizontal position
y - verifical position

displayHelpResource

void displayHelpResource(
String href)
Displays help content for the help resource with the given URL.

This method is called by the platform to launch the help system UI, displaying the documentation identified by the href parameter.

The help system makes no guarantee that all the help resources can be displayed or how they are displayed.

Ignored if no help UI is available.

Parameters:
href - the URL of the help resource.

Valid href are as described in IHelpResource.getHref()


displayHelp

void displayHelp(
String contextId)
Calls the help support system to display the given help context id.

May only be called from a UI thread.

Parameters:
contextId - the id of the context to display

displayHelp

void displayHelp(
IContext context)
Displays context-sensitive help for the given context.

May only be called from a UI thread.

Parameters:
context - the context to display

isContextHelpDisplayed

boolean isContextHelpDisplayed()
Returns whether the context-sensitive help window is currently being displayed. Returns false if the help UI has not been activated yet.

Returns:
true if the context-sensitive help window is currently being displayed, false otherwise

setHelp

void setHelp(
IAction action,
             
String contextId)
Sets the given help context id on the given action.

Parameters:
action - the action on which to register the context id
contextId - the context id to use when F1 help is invoked

setHelp

void setHelp(
Control control,
             
String contextId)
Sets the given help context id on the given control.

Parameters:
control - the control on which to register the context id
contextId - the context id to use when F1 help is invoked

setHelp

void setHelp(
Menu menu,
             
String contextId)
Sets the given help context id on the given menu.

Parameters:
menu - the menu on which to register the context id
contextId - the context id to use when F1 help is invoked

setHelp

void setHelp(
MenuItem item,
             
String contextId)
Sets the given help context id on the given menu item.

Parameters:
item - the menu item on which to register the context id
contextId - the context id to use when F1 help is invoked

resolve

URL resolve(
String href,
            boolean documentOnly)
Resolves the help resource href by converting it into a legitimate URL according to the implementation of the help system. Help resources that already have a protocol will be unchanged.

Parameters:
href -
documentOnly - if true, the resulting URL must point at the document referenced by href. Otherwise, it can be a URL that contains additional elements like navigation that the help system adds to the document.
Returns:
the resolved URL or null if no help UI is available.

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire