This extension point is for contributing an action to the Remote Systems view pulldown menu, to the Preferences cascading menu. This action will launch the Preferences dialog, scoped to the particular page you specify. This will automatically show any child pages as well. This point is easy to extend, no coding required. Just name the preference page by its id from the preferencePages extension that defined the page. Also, if it is not a root page, then you must also name the root page (such as when using Windows->Preference) by its id from its preferencePages extension.
This would be used by anyone who extends the Remote System Explorer, and offers preference pages for their users, and wants a shortcut to those preference pages for convenience.
(no description available)
(no description available)
A unique identifier for this extension.
The display name for the action, shown in the menu. Include any mnenomnic if desired.
This matches the "id" attribute on the preferencePages extension, for the preference page you wish to show in the Preference Dialog for this action. If the preference page is a root (no "category" attribute in its preferencePages extension), this is all you need. Else, you also need to specify the preferencePageCategory attribute.
Note this page will be shown as the root in the Preferences dialog, but it can be expanded to see its child nodes.
This is required if the preference page you wish to show is not a root page, which means if it has a "category" attribute in its preferencePage extension definition. If so, here you give the "id" value of the preference page's root page... not its immediate parent! Be careful. We need to know the id of the root page so we know which root to recursively search the children of to find the page you specified in the preferencePageId attribute.
A relative path to an icon that will be displayed in the menu, with the label. Optional
A description of the action, for display on the status line, although it doesn't seem to work just yet. Optional
The id of help to be shown when F1 is pressed while this action is selected. Optional
<extension point="org.eclipse.rse.ui.remoteSystemsViewPreferencesActions">
<action
id="org.eclipse.rse.ui.preferences.actions.rse"
label="%PreferencePageAction.rse.label"
preferencePageId="org.eclipse.rse.ui.ui.preferences.RemoteSystemsPreferencePage"
tooltip="%PreferencePageAction.rse.tooltip"
helpContextId="org.eclipse.rse.ui.aprefrse"
/>
</extension>
<extension point="org.eclipse.rse.ui.remoteSystemsViewPreferencesActions">
<action
id="com.acme.tools.core.preferences.rse"
label="%PreferencePageAction.rse.label"
preferencePageId="com.acme.tools.core.ui.preferences.PreferencePage"
preferencePageCategory="org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage"
tooltip="%PreferencePageAction.rse.tooltip"
helpContextId="com.acme.tools.core.aprefrse"
/>
<action
id="com.acme.tools.core.preferences.editor"
label="%PreferencePageAction.editor.label"
preferencePageId="com.acme.tools.editor.preferences.EditorGeneralPreferencePage"
preferencePageCategory="org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage"
tooltip="%PreferencePageAction.editor.tooltip"
helpContextId="com.acme.tools.core.helpcontext01"
/>
<action
id="com.acme.tools.core.preferences.cache"
label="%PreferencePageAction.cache.label"
preferencePageId="com.acme.tools.core.ui.preferences.CachingPreferencePage"
preferencePageCategory="org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage"
tooltip="%PreferencePageAction.caching.tooltip"
helpContextId="com.acme.tools.core.helpcontext02"
/>
</extension>
Since no coding is required, there is no API information.
This extension point is used by the <code>org.eclipse.rse.ui.actions.SystemCascadingPreferencesAction</code> class, which in turn creates a <code>org.eclipse.rse.ui.actions.SystemShowPreferencesPageAction</code> object for each extension of this point. These are used to populate the Preferences cascading menu of the Remote Systems view pulldown, but could be used elsewhere too, if desired.
Copyright (c) 2002, 2006 IBM Corporation. All Rights Reserved.
This program and the accompanying materials are made available under the terms
of the Eclipse Public License v1.0 which accompanies this distribution, and is
available at http://www.eclipse.org/legal/epl-v10.html
Contributors:
IBM Corporation - initial API and implementation