RSE
Release 3.3

org.eclipse.rse.ui.dialogs
Class SystemWizardDialog

java.lang.Object
  extended by org.eclipse.jface.window.Window
      extended by org.eclipse.jface.dialogs.Dialog
          extended by org.eclipse.jface.dialogs.TrayDialog
              extended by org.eclipse.jface.dialogs.TitleAreaDialog
                  extended by org.eclipse.jface.wizard.WizardDialog
                      extended by org.eclipse.rse.ui.dialogs.SystemWizardDialog
All Implemented Interfaces:
IPageChangeProvider, IRunnableContext, IShellProvider, IWizardContainer, IWizardContainer2, ISystemPromptDialog

public class SystemWizardDialog
extends WizardDialog
implements ISystemPromptDialog

Base wizard dialog class. Extends Eclipse WizardDialog class to add support for the ISystemPromptDialog interface methods. These make it easy to pass an input object to your wizard, if your wizard implements ISystemWizard.

This class is most effective when used together with AbstractSystemWizard and with SystemBaseWizardAction. Indeed, if you use SystemBaseWizardAction, this class is automatically used for the dialog. It supports propogation of information from the action, to the wizard, to the wizard dialog and to the wizard pages.

The advantages to using this class versus the base JFace WizardDialog class is:

To use this class, simply instantiate it, passing a wizard that implements ISystemWizard, which AbstractSystemWizard does. If you use SystemBaseWizardAction, then this is done for you.

See Also:
AbstractSystemWizard, SystemBaseWizardAction

Nested Class Summary
 
Nested classes/interfaces inherited from class org.eclipse.jface.wizard.WizardDialog
WizardDialog.PageContainerFillLayout
 
Nested classes/interfaces inherited from class org.eclipse.jface.window.Window
Window.IExceptionHandler
 
Field Summary
protected  String helpId
           
 
Fields inherited from class org.eclipse.jface.wizard.WizardDialog
WIZ_IMG_ERROR
 
Fields inherited from class org.eclipse.jface.dialogs.TitleAreaDialog
DLG_IMG_TITLE_BANNER, DLG_IMG_TITLE_ERROR, INFO_MESSAGE, WARNING_MESSAGE
 
Fields inherited from class org.eclipse.jface.dialogs.Dialog
blockedHandler, buttonBar, DIALOG_DEFAULT_BOUNDS, DIALOG_PERSISTLOCATION, DIALOG_PERSISTSIZE, dialogArea, DLG_IMG_ERROR, DLG_IMG_HELP, DLG_IMG_INFO, DLG_IMG_MESSAGE_ERROR, DLG_IMG_MESSAGE_INFO, DLG_IMG_MESSAGE_WARNING, DLG_IMG_QUESTION, DLG_IMG_WARNING, ELLIPSIS
 
Fields inherited from class org.eclipse.jface.window.Window
CANCEL, OK
 
Constructor Summary
SystemWizardDialog(Shell shell, IWizard wizard)
          Constructor
SystemWizardDialog(Shell shell, IWizard wizard, Object inputObject)
          Constructor two.
 
Method Summary
protected  Control createDialogArea(Composite parent)
          Intercept of parent method so we can automatically register the wizard's progress monitor with the SystemRegistry for all framework progress monitor requests, if user has specified they need a progress monitor for this wizard.
 String getHelpContextId()
          Get the help context id for this wizard dialog, as set in setHelp
 Object getInputObject()
          For explicitly getting input object
 Object getOutputObject()
          For explicitly getting output object after dialog is dismissed.
 int publicConvertHeightInCharsToPixels(int chars)
          Expose inherited protected method convertHeightInCharsToPixels as a publicly excessible method
 int publicConvertWidthInCharsToPixels(int chars)
          Expose inherited protected method convertWidthInCharsToPixels as a publicly excessible method
 void setHelp(String id)
          Set the help context id for this wizard dialog
 void setInputObject(Object inputObject)
          For explicitly setting input object
 void setOutputObject(Object outputObject)
          For explicitly setting output object after wizard is dismissed.
 void updateSize(IWizardPage page)
          Exposes this nice new 2.0 capability to the public.
 boolean wasCancelled()
          Allow caller to determine if window was cancelled or not.
 
Methods inherited from class org.eclipse.jface.wizard.WizardDialog
addPageChangedListener, addPageChangingListener, backPressed, buttonPressed, cancelPressed, close, configureShell, createButtonsForButtonBar, createContents, createProgressMonitorPart, finishPressed, firePageChanged, firePageChanging, getButton, getCurrentPage, getProgressMonitor, getSelectedPage, getWizard, helpPressed, nextPressed, removePageChangedListener, removePageChangingListener, run, setButtonLayoutData, setMinimumPageSize, setMinimumPageSize, setPageSize, setPageSize, setWizard, showPage, update, updateButtons, updateMessage, updateSize, updateTitleBar, updateWindowTitle
 
Methods inherited from class org.eclipse.jface.dialogs.TitleAreaDialog
getErrorMessage, getInitialSize, getMessage, getTitleArea, getTitleImageLabel, setErrorMessage, setMessage, setMessage, setTitle, setTitleAreaColor, setTitleImage
 
Methods inherited from class org.eclipse.jface.dialogs.TrayDialog
closeTray, createButtonBar, createHelpControl, getLayout, getTray, isDialogHelpAvailable, isHelpAvailable, openTray, setDialogHelpAvailable, setHelpAvailable
 
Methods inherited from class org.eclipse.jface.dialogs.Dialog
applyDialogFont, convertHeightInCharsToPixels, convertHeightInCharsToPixels, convertHorizontalDLUsToPixels, convertHorizontalDLUsToPixels, convertVerticalDLUsToPixels, convertVerticalDLUsToPixels, convertWidthInCharsToPixels, convertWidthInCharsToPixels, create, createButton, dialogFontIsDefault, getBlockedHandler, getButtonBar, getCancelButton, getDialogArea, getDialogBoundsSettings, getDialogBoundsStrategy, getImage, getInitialLocation, getOKButton, initializeBounds, initializeDialogUnits, isResizable, okPressed, setBlockedHandler, setButtonLayoutFormData, shortenText
 
Methods inherited from class org.eclipse.jface.window.Window
canHandleShellCloseEvent, constrainShellSize, createShell, getConstrainedShellBounds, getContents, getDefaultImage, getDefaultImages, getDefaultOrientation, getParentShell, getReturnCode, getShell, getShellListener, getShellStyle, getWindowManager, handleFontChange, handleShellCloseEvent, open, setBlockOnOpen, setDefaultImage, setDefaultImages, setDefaultModalParent, setDefaultOrientation, setExceptionHandler, setParentShell, setReturnCode, setShellStyle, setWindowManager
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.eclipse.jface.wizard.IWizardContainer
getShell
 

Field Detail

helpId

protected String helpId
Constructor Detail

SystemWizardDialog

public SystemWizardDialog(Shell shell,
                          IWizard wizard)
Constructor


SystemWizardDialog

public SystemWizardDialog(Shell shell,
                          IWizard wizard,
                          Object inputObject)
Constructor two. Use when you have an input object at instantiation time.

Method Detail

setInputObject

public void setInputObject(Object inputObject)
Description copied from interface: ISystemPromptDialog
For explicitly setting input object

Specified by:
setInputObject in interface ISystemPromptDialog

getInputObject

public Object getInputObject()
Description copied from interface: ISystemPromptDialog
For explicitly getting input object

Specified by:
getInputObject in interface ISystemPromptDialog

getOutputObject

public Object getOutputObject()
Description copied from interface: ISystemPromptDialog
For explicitly getting output object after dialog is dismissed. Set by the dialog's processOK method.

Specified by:
getOutputObject in interface ISystemPromptDialog

setOutputObject

public void setOutputObject(Object outputObject)
Description copied from interface: ISystemPromptDialog
For explicitly setting output object after wizard is dismissed. Called in the wizard's processFinish method, typically.

Specified by:
setOutputObject in interface ISystemPromptDialog

wasCancelled

public boolean wasCancelled()
Description copied from interface: ISystemPromptDialog
Allow caller to determine if window was cancelled or not.

Specified by:
wasCancelled in interface ISystemPromptDialog

setHelp

public void setHelp(String id)
Set the help context id for this wizard dialog


getHelpContextId

public String getHelpContextId()
Get the help context id for this wizard dialog, as set in setHelp


createDialogArea

protected Control createDialogArea(Composite parent)
Intercept of parent method so we can automatically register the wizard's progress monitor with the SystemRegistry for all framework progress monitor requests, if user has specified they need a progress monitor for this wizard.

Overrides:
createDialogArea in class WizardDialog

updateSize

public void updateSize(IWizardPage page)
Exposes this nice new 2.0 capability to the public.

Overrides:
updateSize in class WizardDialog

publicConvertWidthInCharsToPixels

public int publicConvertWidthInCharsToPixels(int chars)
Expose inherited protected method convertWidthInCharsToPixels as a publicly excessible method

Specified by:
publicConvertWidthInCharsToPixels in interface ISystemPromptDialog

publicConvertHeightInCharsToPixels

public int publicConvertHeightInCharsToPixels(int chars)
Expose inherited protected method convertHeightInCharsToPixels as a publicly excessible method

Specified by:
publicConvertHeightInCharsToPixels in interface ISystemPromptDialog

RSE
Release 3.3

Copyright (c) IBM Corporation and others 2000, 2011. All Rights Reserved.