Remote Systems View Preferences Page Action

com.ibm.etools.systems.core.remoteSystemsViewPreferencesAction

WSWB 3.0, or WSSD/WSAD/WDSC 5.1.2

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.

<!ELEMENT extension (action+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT action EMPTY>

<!ATTLIST action

id                     CDATA #REQUIRED

label                  CDATA #REQUIRED

preferencePageId       CDATA #REQUIRED

preferencePageCategory CDATA #IMPLIED

icon                   CDATA #IMPLIED

tooltip                CDATA #IMPLIED

helpContextId          CDATA #IMPLIED>


Since no coding is required, there is no API information.

This extension point is used by the com.ibm.etools.systems.core.ui.actions.SystemCascadingPreferencesAction class, which in turn creates a com.ibm.etools.systems.core.ui.actions.SystemShowPreferencesPageAction 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.


(C) Copyright IBM Corp. 2002, 2004 All Rights Reserved.