Eclipse Platform
2.0

org.eclipse.ui.dialogs
Class WizardNewFolderMainPage

java.lang.Object
  |
  +--org.eclipse.jface.dialogs.DialogPage
        |
        +--org.eclipse.jface.wizard.WizardPage
              |
              +--org.eclipse.ui.dialogs.WizardNewFolderMainPage
All Implemented Interfaces:
IDialogPage, IMessageProvider, IWizardPage, Listener

public class WizardNewFolderMainPage
extends WizardPage
implements Listener

Standard main page for a wizard that creates a folder resource.

This page may be used by clients as-is; it may be also be subclassed to suit.

Subclasses may extend


Field Summary
 
Fields inherited from interface org.eclipse.jface.dialogs.IMessageProvider
ERROR, INFORMATION, NONE, WARNING
 
Constructor Summary
WizardNewFolderMainPage(String pageName, IStructuredSelection selection)
          Creates a new folder creation wizard page.
 
Method Summary
 void createControl(Composite parent)
          (non-Javadoc) Method declared on IDialogPage.
protected  void createFolder(IFolder folderHandle, IProgressMonitor monitor)
          Creates a folder resource given the folder handle.
protected  IFolder createFolderHandle(IPath folderPath)
          Creates a folder resource handle for the folder with the given workspace path.
 IFolder createNewFolder()
          Creates a new folder resource in the selected container and with the selected name.
 void handleEvent(Event ev)
          The WizardNewFolderCreationPage implementation of this Listener method handles all events and enablements for controls on this page.
protected  void initializePage()
          Initializes this page's controls.
 void setVisible(boolean visible)
          Sets the visibility of this dialog page.
protected  boolean validatePage()
          Returns whether this page's controls currently all contain valid values.
 
Methods inherited from class org.eclipse.jface.wizard.WizardPage
canFlipToNextPage, getContainer, getDialogSettings, getImage, getName, getNextPage, getPreviousPage, getShell, getWizard, isCurrentPage, isPageComplete, setDescription, setErrorMessage, setImageDescriptor, setMessage, setPageComplete, setPreviousPage, setTitle, setWizard, toString
 
Methods inherited from class org.eclipse.jface.dialogs.DialogPage
convertHeightInCharsToPixels, convertHorizontalDLUsToPixels, convertVerticalDLUsToPixels, convertWidthInCharsToPixels, dispose, getControl, getDescription, getDialogFontName, getErrorMessage, getFont, getMessage, getMessageType, getTitle, getToolTipText, initializeDialogUnits, isControlCreated, performHelp, setControl, setMessage
 
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
dispose, getControl, getDescription, getErrorMessage, getMessage, getTitle, performHelp
 

Constructor Detail

WizardNewFolderMainPage

public WizardNewFolderMainPage(String pageName,
                               IStructuredSelection selection)
Creates a new folder creation wizard page. If the initial resource selection contains exactly one container resource then it will be used as the default container resource.

Parameters:
pageName - the name of the page
selection - the current resource selection
Method Detail

createControl

public void createControl(Composite parent)
(non-Javadoc) Method declared on IDialogPage.

Specified by:
createControl in interface IDialogPage
Parameters:
parent - the parent composite

createFolder

protected void createFolder(IFolder folderHandle,
                            IProgressMonitor monitor)
                     throws CoreException
Creates a folder resource given the folder handle.

Parameters:
folderHandle - the folder handle to create a folder resource for
monitor - the progress monitor to show visual progress with
Throws:
CoreException - if the operation fails
OperationCanceledException - if the operation is canceled

createFolderHandle

protected IFolder createFolderHandle(IPath folderPath)
Creates a folder resource handle for the folder with the given workspace path. This method does not create the folder resource; this is the responsibility of createFolder.

Parameters:
folderPath - the path of the folder resource to create a handle for
Returns:
the new folder resource handle
See Also:
createFolder(org.eclipse.core.resources.IFolder, org.eclipse.core.runtime.IProgressMonitor)

createNewFolder

public IFolder createNewFolder()
Creates a new folder resource in the selected container and with the selected name. Creates any missing resource containers along the path; does nothing if the container resources already exist.

In normal usage, this method is invoked after the user has pressed Finish on the wizard; the enablement of the Finish button implies that all controls on this page currently contain valid values.

Note that this page caches the new folder once it has been successfully created; subsequent invocations of this method will answer the same folder resource without attempting to create it again.

This method should be called within a workspace modify operation since it creates resources.

Returns:
the created folder resource, or null if the folder was not created

handleEvent

public void handleEvent(Event ev)
The WizardNewFolderCreationPage implementation of this Listener method handles all events and enablements for controls on this page. Subclasses may extend.

Specified by:
handleEvent in interface Listener
Parameters:
ev - the event which occurred

initializePage

protected void initializePage()
Initializes this page's controls.


validatePage

protected boolean validatePage()
Returns whether this page's controls currently all contain valid values.

Returns:
true if all controls are valid, and false if at least one is invalid

setVisible

public void setVisible(boolean visible)
Description copied from interface: IDialogPage
Sets the visibility of this dialog page.

Specified by:
setVisible in interface IDialogPage
Overrides:
setVisible in class DialogPage
Parameters:
visible - true to make this page visible, and false to hide it

Eclipse Platform
2.0

Copyright (c) IBM Corp. and others 2000, 2002. All Rights Reserved.