org.modelio.api.ui

Class ModelioWizardDialog

java.lang.Object

org.modelio.platform.ui.dialog.ModelioDialog

org.modelio.api.ui.ModelioDialog

org.modelio.api.ui.ModelioWizardDialog

public class ModelioWizardDialog
extends ModelioDialog

Version of eclipse's WizardDialog using ModelioDialog instead of TitleAreaDialog.

See Also:

WizardDialog

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ModelioWizardDialog.PageContainerFillLayout A layout for a container which includes several pages, like a notebook, wizard, or preference dialog.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	WIZ_IMG_ERROR Image registry key for error message image (value "dialog_title_error_image").

Constructor Summary

Constructors

Constructor and Description
ModelioWizardDialog(Shell parentShell, IWizard newWizard) Creates a new wizard dialog for the given wizard.

Method Summary

Modifier and Type	Method and Description
protected void	addButtonsInButtonBar(Composite parent) Creates the buttons for this dialog's button bar.
void	addPageChangedListener(IPageChangedListener listener)
void	addPageChangingListener(IPageChangingListener listener) Adds a listener for page changes to the list of page changing listeners registered for this dialog.
protected void	backPressed() The Back button has been pressed.
protected void	buttonPressed(int buttonId)
protected void	cancelPressed()
boolean	close()
protected void	configureShell(Shell newShell)
Control	createContentArea(Composite parent)
protected Control	createContents(Composite parent) The WizardDialog implementation of this Window method calls call IWizard.addPages to allow the current wizard to add extra pages, then super.createContents to create the controls.
protected Control	createDialogArea(Composite parent)
protected ProgressMonitorPart	createProgressMonitorPart(Composite composite, GridLayout pmlayout) Hook method for subclasses to create a custom progress monitor part.
protected void	finishPressed() The Finish button has been pressed.
protected void	firePageChanged(PageChangedEvent event) Notifies any selection changed listeners that the selected page has changed.
protected void	firePageChanging(PageChangingEvent event) Notifies any page changing listeners that the currently selected dialog page is changing.
protected Button	getButton(int id) Return the cancel button if the id is a the cancel id.
IWizardPage	getCurrentPage()
protected IProgressMonitor	getProgressMonitor() Returns the progress monitor for this wizard dialog (if it has one).
java.lang.Object	getSelectedPage()
protected IWizard	getWizard() Returns the wizard this dialog is currently displaying.
protected void	helpPressed() The Help button has been pressed.
void	init()
protected void	nextPressed() The Next button has been pressed.
void	removePageChangedListener(IPageChangedListener listener)
void	removePageChangingListener(IPageChangingListener listener) Removes the provided page changing listener from the list of page changing listeners registered for the dialog.
void	run(boolean fork, boolean cancelable, IRunnableWithProgress runnable) This implementation of IRunnableContext#run(boolean, boolean, IRunnableWithProgress) blocks until the runnable has been run, regardless of the value of fork.
protected void	setButtonLayoutData(Button button)
void	setMinimumPageSize(int minWidth, int minHeight) Sets the minimum page size used for the pages.
void	setMinimumPageSize(Point size) Sets the minimum page size used for the pages.
void	setPageSize(int width, int height) Sets the size of all pages.
void	setPageSize(Point size) Sets the size of all pages.
protected void	setWizard(IWizard newWizard) Sets the wizard this dialog is currently displaying.
void	showPage(IWizardPage page)
protected void	update() Updates this dialog's controls to reflect the current page.
void	updateButtons()
void	updateMessage()
void	updateSize()
protected void	updateSize(IWizardPage page) Computes the correct dialog size for the current page and resizes its shell if necessary.
void	updateTitleBar()
void	updateWindowTitle()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WIZ_IMG_ERROR

public static final java.lang.String WIZ_IMG_ERROR

Image registry key for error message image (value "dialog_title_error_image").

See Also:

Constant Field Values

Constructor Detail

ModelioWizardDialog

public ModelioWizardDialog(Shell parentShell,
                           IWizard newWizard)

Creates a new wizard dialog for the given wizard.

Parameters:

parentShell - the parent shell

newWizard - the wizard this dialog is working on

Method Detail

backPressed

protected void backPressed()

The Back button has been pressed.

buttonPressed

protected void buttonPressed(int buttonId)

cancelPressed

protected void cancelPressed()

close

public boolean close()

finishPressed

protected void finishPressed()

The Finish button has been pressed.

helpPressed

protected void helpPressed()

The Help button has been pressed.

nextPressed

protected void nextPressed()

The Next button has been pressed.

setMinimumPageSize

public void setMinimumPageSize(int minWidth,
                               int minHeight)

Sets the minimum page size used for the pages.

Parameters:

minWidth - the minimum page width

minHeight - the minimum page height

See Also:

setMinimumPageSize(Point)

setPageSize

public void setPageSize(int width,
                        int height)

Sets the size of all pages. The given size takes precedence over computed sizes.

Parameters:

width - the page width

height - the page height

See Also:

setPageSize(Point)

update

protected void update()

Updates this dialog's controls to reflect the current page.

updateButtons

public void updateButtons()

updateMessage

public void updateMessage()

updateSize

public void updateSize()

updateTitleBar

public void updateTitleBar()

updateWindowTitle

public void updateWindowTitle()

getSelectedPage

public java.lang.Object getSelectedPage()

init

public void init()

configureShell

protected void configureShell(Shell newShell)

setButtonLayoutData

protected void setButtonLayoutData(Button button)

getButton

protected Button getButton(int id)

Return the cancel button if the id is a the cancel id.

Parameters:

id - the button id

Returns:

the button corresponding to the button id

createContents

protected Control createContents(Composite parent)

The WizardDialog implementation of this Window method calls call IWizard.addPages to allow the current wizard to add extra pages, then super.createContents to create the controls. It then calls IWizard.createPageControls to allow the wizard to pre-create their page controls prior to opening, so that the wizard opens to the correct size. And finally it shows the first page.

createDialogArea

protected Control createDialogArea(Composite parent)

createProgressMonitorPart

protected ProgressMonitorPart createProgressMonitorPart(Composite composite,
                                                        GridLayout pmlayout)

Hook method for subclasses to create a custom progress monitor part.

The default implementation creates a progress monitor with a stop button will be created.

Parameters:

composite - the parent composite

pmlayout - the layout

Returns:

ProgressMonitorPart the progress monitor part

getCurrentPage

public IWizardPage getCurrentPage()

getProgressMonitor

protected IProgressMonitor getProgressMonitor()

Returns the progress monitor for this wizard dialog (if it has one).

Returns:

the progress monitor, or null if this wizard dialog does not have one

getWizard

protected IWizard getWizard()

Returns the wizard this dialog is currently displaying.

Returns:

the current wizard

run

public void run(boolean fork,
                boolean cancelable,
                IRunnableWithProgress runnable)
         throws java.lang.InterruptedException,
                java.lang.reflect.InvocationTargetException

This implementation of IRunnableContext#run(boolean, boolean, IRunnableWithProgress) blocks until the runnable has been run, regardless of the value of fork. It is recommended that fork is set to true in most cases. If fork is set to false, the runnable will run in the UI thread and it is the runnable's responsibility to call Display.readAndDispatch() to ensure UI responsiveness. UI state is saved prior to executing the long-running operation and is restored after the long-running operation completes executing. Any attempt to change the UI state of the wizard in the long-running operation will be nullified when original UI state is restored.

Throws:

java.lang.InterruptedException

java.lang.reflect.InvocationTargetException

setMinimumPageSize

public void setMinimumPageSize(Point size)

Sets the minimum page size used for the pages.

Parameters:

size - the page size encoded as new Point(width,height)

See Also:

setMinimumPageSize(int,int)

setPageSize

public void setPageSize(Point size)

Sets the size of all pages. The given size takes precedence over computed sizes.

Parameters:

size - the page size encoded as new Point(width,height)

See Also:

setPageSize(int,int)

setWizard

protected void setWizard(IWizard newWizard)

Sets the wizard this dialog is currently displaying.

Parameters:

newWizard - the wizard

showPage

public void showPage(IWizardPage page)

updateSize

protected void updateSize(IWizardPage page)

Computes the correct dialog size for the current page and resizes its shell if necessary. Also causes the container to refresh its layout.

Parameters:

page - the wizard page to use to resize the dialog

Since:

2.0

addPageChangedListener

public void addPageChangedListener(IPageChangedListener listener)

removePageChangedListener

public void removePageChangedListener(IPageChangedListener listener)

firePageChanged

protected void firePageChanged(PageChangedEvent event)

Notifies any selection changed listeners that the selected page has changed. Only listeners registered at the time this method is called are notified.

Parameters:

event - a selection changed event

Since:

3.1

See Also:

IPageChangedListener#pageChanged

addPageChangingListener

public void addPageChangingListener(IPageChangingListener listener)

Adds a listener for page changes to the list of page changing listeners registered for this dialog. Has no effect if an identical listener is already registered.

Parameters:

listener - a page changing listener

Since:

3.3

removePageChangingListener

public void removePageChangingListener(IPageChangingListener listener)

Removes the provided page changing listener from the list of page changing listeners registered for the dialog.

Parameters:

listener - a page changing listener

Since:

3.3

firePageChanging

protected void firePageChanging(PageChangingEvent event)

Notifies any page changing listeners that the currently selected dialog page is changing. Only listeners registered at the time this method is called are notified.

Parameters:

event - a selection changing event

Since:

3.3

See Also:

IPageChangingListener#handlePageChanging(PageChangingEvent)

addButtonsInButtonBar

protected void addButtonsInButtonBar(Composite parent)

Creates the buttons for this dialog's button bar.

The WizardDialog implementation of this framework method prevents the parent composite's columns from being made equal width in order to remove the margin between the Back and Next buttons.

Parameters:

parent - the parent composite to contain the buttons

createContentArea

public Control createContentArea(Composite parent)