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
public abstract class RootScopePage extends PreferencePage implements ISearchScopePage
Clients that contribute search scope root page to the search engine definition must extend this class and implementcreateScopeContentsmethod. 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
Constructors Constructor Description RootScopePage()The default constructor.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected ControlcreateContents(Composite parent)Creates the initial contents of the page and allocates the area for the clients.protected abstract intcreateScopeContents(Composite parent)Abstract method that subclasses must implement in order to provide root page content.protected IEngineDescriptorgetEngineDescriptor()Returns the descriptor of the engine associated with this page.protected StringgetScopeSetName()Returns the scope set name passed to the page during initialization.voidinit(IEngineDescriptor ed, String scopeSetName)Initializes the search scope page.protected voidinitializeDefaults(IPreferenceStore store)Initializes default values of the store to be used when the user presses 'Defaults' button.protected booleanisEngineEnabled()Tests whether the search engine has been selected to participate in the search.protected voidmasterValueChanged(boolean value)Called when the value of the master switch has changed.protected voidperformDefaults()Sets the value of the master switch to the initial value from the extension.booleanperformOk()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
-
-
-
-
Method Detail
-
init
public void init(IEngineDescriptor ed, String scopeSetName)
Description copied from interface:ISearchScopePageInitializes the search scope page.- Specified by:
initin 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
protected final Control createContents(Composite parent)
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:
createContentsin 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-trueif the master switch is on,falseotherwise.
-
getScopeSetName
protected String getScopeSetName()
Returns the scope set name passed to the page during initialization.- Returns:
- the name of the current scope set
-
getEngineDescriptor
protected IEngineDescriptor 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:
trueif the search engine is enabled,falseotherwise.
-
performOk
public boolean performOk()
Stores the value of the master switch in the preference store. Subclasses may override but must call 'super'.- Specified by:
performOkin interfaceIPreferencePage- Overrides:
performOkin classPreferencePage- Returns:
trueif the wizard can be closed,falseotherwise.
-
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:
performDefaultsin classPreferencePage
-
initializeDefaults
protected void initializeDefaults(IPreferenceStore store)
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
protected abstract int createScopeContents(Composite parent)
Abstract method that subclasses must implement in order to provide root page content. The parent usesGridLayoutto position and size the widgets. Widgets created in this method should useGridDatato 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
-
-