Package org.eclipse.help.ui
Class RootScopePage
java.lang.Object
org.eclipse.jface.dialogs.DialogPage
org.eclipse.jface.preference.PreferencePage
org.eclipse.help.ui.RootScopePage
- All Implemented Interfaces:
ISearchScopePage
,IDialogPage
,IMessageProvider
,IPreferencePage
Clients that contribute search scope root page to the search engine
definition must extend this class and implement
createScopeContents
method. The page will come preset with the
engine name, image and description, as well as the master switch that turns
the engine on or off. When the engine master switch is set to false, all the
children in the client composite will be disabled.- Since:
- 3.1
-
Field Summary
Fields inherited from interface org.eclipse.jface.dialogs.IMessageProvider
ERROR, INFORMATION, NONE, WARNING
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected final Control
createContents
(Composite parent) Creates the initial contents of the page and allocates the area for the clients.protected abstract int
createScopeContents
(Composite parent) Abstract method that subclasses must implement in order to provide root page content.protected IEngineDescriptor
Returns the descriptor of the engine associated with this page.protected String
Returns the scope set name passed to the page during initialization.void
init
(IEngineDescriptor ed, String scopeSetName) Initializes the search scope page.protected void
Initializes default values of the store to be used when the user presses 'Defaults' button.protected boolean
Tests whether the search engine has been selected to participate in the search.protected void
masterValueChanged
(boolean value) Called when the value of the master switch has changed.protected void
Sets the value of the master switch to the initial value from the extension.boolean
Stores the value of the master switch in the preference store.Methods inherited from class org.eclipse.jface.preference.PreferencePage
applyData, applyDialogFont, computeSize, contributeButtons, createControl, createDescriptionLabel, createNoteComposite, doComputeSize, doGetPreferenceStore, getApplyButton, getContainer, getDefaultsButton, getPreferenceStore, isValid, noDefaultAndApplyButton, noDefaultButton, okToLeave, performApply, performCancel, performHelp, setContainer, setErrorMessage, setMessage, setPreferenceStore, setSize, setTitle, setValid, toString, updateApplyButton
Methods inherited from class org.eclipse.jface.dialogs.DialogPage
convertHeightInCharsToPixels, convertHorizontalDLUsToPixels, convertVerticalDLUsToPixels, convertWidthInCharsToPixels, dispose, getControl, getDescription, getDialogFontName, getErrorMessage, getFont, getImage, getMessage, getMessageType, getShell, getTitle, getToolTipText, initializeDialogUnits, isControlCreated, setButtonLayoutData, setControl, setDescription, setImageDescriptor, setMessage, setVisible
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.eclipse.jface.dialogs.IDialogPage
createControl, dispose, getControl, getDescription, getErrorMessage, getImage, getMessage, getTitle, performHelp, setDescription, setImageDescriptor, setTitle, setVisible
Methods inherited from interface org.eclipse.jface.preference.IPreferencePage
computeSize, isValid, okToLeave, performCancel, setContainer, setSize
-
Constructor Details
-
RootScopePage
public RootScopePage()The default constructor.
-
-
Method Details
-
init
Description copied from interface:ISearchScopePage
Initializes the search scope page.- Specified by:
init
in interfaceISearchScopePage
- Parameters:
ed
- the descriptor of the engine associated with this pagescopeSetName
- the name of the current scope set that is used to group data shown in this page
-
createContents
Creates the initial contents of the page and allocates the area for the clients. Classes that extend this class should implementcreateScopeContents(Composite)
instead.- Specified by:
createContents
in classPreferencePage
- Parameters:
parent
- the page parent- Returns:
- the page client control
-
masterValueChanged
protected void masterValueChanged(boolean value) Called when the value of the master switch has changed. The default implementation disables the scope contents control when the master switch is off. Subclass can override this behaviour.- Parameters:
value
-true
if the master switch is on,false
otherwise.
-
getScopeSetName
Returns the scope set name passed to the page during initialization.- Returns:
- the name of the current scope set
-
getEngineDescriptor
Returns the descriptor of the engine associated with this page.- Returns:
- the engine descriptor
-
isEngineEnabled
protected boolean isEngineEnabled()Tests whether the search engine has been selected to participate in the search.- Returns:
true
if the search engine is enabled,false
otherwise.
-
performOk
public boolean performOk()Stores the value of the master switch in the preference store. Subclasses may override but must call 'super'.- Specified by:
performOk
in interfaceIPreferencePage
- Overrides:
performOk
in classPreferencePage
- Returns:
true
if the wizard can be closed,false
otherwise.
-
performDefaults
protected void performDefaults()Sets the value of the master switch to the initial value from the extension. Subclasses may override but must call 'super'.- Overrides:
performDefaults
in classPreferencePage
-
initializeDefaults
Initializes default values of the store to be used when the user presses 'Defaults' button. Subclasses may override but must call 'super'.- Parameters:
store
- the preference store
-
createScopeContents
Abstract method that subclasses must implement in order to provide root page content. The parent usesGridLayout
to position and size the widgets. Widgets created in this method should useGridData
to configure the way they fit in the overall page.The common widgets created by this page will set number of columns they need for themselves only. Clients that implement this method should return the required number of columns so that the root page widgets can be adjusted if more columns are needed than initially set.
- Parameters:
parent
- the page parent- Returns:
- number of columns required by the client content
-