Package org.eclipse.ui.dialogs
Class WizardNewProjectCreationPage
java.lang.Object
org.eclipse.jface.dialogs.DialogPage
org.eclipse.jface.wizard.WizardPage
org.eclipse.ui.dialogs.WizardNewProjectCreationPage
- All Implemented Interfaces:
IDialogPage
,IMessageProvider
,IWizardPage
Standard main page for a wizard that is creates a project resource.
This page may be used by clients as-is; it may be also be subclassed to suit.
Example usage:
mainPage = new WizardNewProjectCreationPage("basicNewProjectPage"); mainPage.setTitle("Project"); mainPage.setDescription("Create a new project resource.");
-
Field Summary
Fields inherited from interface org.eclipse.jface.dialogs.IMessageProvider
ERROR, INFORMATION, NONE, WARNING
-
Constructor Summary
ConstructorDescriptionWizardNewProjectCreationPage
(String pageName) Creates a new project creation wizard page.WizardNewProjectCreationPage
(String pageName, IStructuredSelection selection, String[] workingSetTypes) Deprecated.default placement of the working set group has been removed. -
Method Summary
Modifier and TypeMethodDescriptionvoid
createControl
(Composite parent) Creates the top level control for this dialog page under the given parent composite.createWorkingSetGroup
(Composite composite, IStructuredSelection selection, String[] supportedWorkingSetTypes) Create a working set group for this page.Returns the current project location path as entered by the user, or its anticipated initial value./** Returns the current project location URI as entered by the user, ornull
if a valid project location has not been entered.Creates a project resource handle for the current project name field value.Returns the current project name as entered by the user, or its anticipated initial value.Return the selected working sets, if any.void
setInitialProjectName
(String name) Sets the initial project name that this page will use when created.void
setVisible
(boolean visible) TheDialogPage
implementation of thisIDialogPage
method sets the control to the given visibility state.boolean
Returns the useDefaults.protected boolean
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, setButtonLayoutData, 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
Methods inherited from interface org.eclipse.jface.wizard.IWizardPage
getMinimumPageSize
-
Constructor Details
-
WizardNewProjectCreationPage
Creates a new project creation wizard page.- Parameters:
pageName
- the name of this page
-
WizardNewProjectCreationPage
@Deprecated public WizardNewProjectCreationPage(String pageName, IStructuredSelection selection, String[] workingSetTypes) Deprecated.default placement of the working set group has been removed. If you wish to use the working set block please callcreateWorkingSetGroup(Composite, IStructuredSelection, String[])
in your overriddencreateControl(Composite)
implementation.Creates a new project creation wizard page.- Parameters:
pageName
- the name of this pageselection
- the current workbench selectionworkingSetTypes
- an array of working set type IDs that will restrict what types of working sets can be chosen in this group- Since:
- 3.4
-
-
Method Details
-
createControl
Description copied from interface:IDialogPage
Creates the top level control for this dialog page under the given parent composite.Implementors are responsible for ensuring that the created control can be accessed via
getControl
- Parameters:
parent
- the parent composite
-
createWorkingSetGroup
public WorkingSetGroup createWorkingSetGroup(Composite composite, IStructuredSelection selection, String[] supportedWorkingSetTypes) Create a working set group for this page. This method can only be called once.- Parameters:
composite
- the composite in which to create the groupselection
- the current workbench selectionsupportedWorkingSetTypes
- an array of working set type IDs that will restrict what types of working sets can be chosen in this group- Returns:
- the created group. If this method has been called previously the original group will be returned.
- Since:
- 3.4
-
getLocationPath
Returns the current project location path as entered by the user, or its anticipated initial value. Note that if the default has been returned the path in a project description used to create a project should not be set.- Returns:
- the project location path or its anticipated initial value.
-
getLocationURI
/** Returns the current project location URI as entered by the user, ornull
if a valid project location has not been entered.- Returns:
- the project location URI, or
null
- Since:
- 3.2
-
getProjectHandle
Creates a project resource handle for the current project name field value. The project handle is created relative to the workspace root.This method does not create the project resource; this is the responsibility of
IProject::create
invoked by the new project resource wizard.- Returns:
- the new project resource handle
-
getProjectName
Returns the current project name as entered by the user, or its anticipated initial value.- Returns:
- the project name, its anticipated initial value, or
null
if no project name is known
-
setInitialProjectName
Sets the initial project name that this page will use when created. The name is ignored if the createControl(Composite) method has already been called. Leading and trailing spaces in the name are ignored. Providing the name of an existing project will not necessarily cause the wizard to warn the user. Callers of this method should first check if the project name passed already exists in the workspace.- Parameters:
name
- initial project name for this page- See Also:
-
validatePage
protected boolean validatePage()Returns whether this page's controls currently all contain valid values.- Returns:
true
if all controls are valid, andfalse
if at least one is invalid
-
setVisible
public void setVisible(boolean visible) Description copied from class:DialogPage
TheDialogPage
implementation of thisIDialogPage
method sets the control to the given visibility state. Subclasses may extend.- Specified by:
setVisible
in interfaceIDialogPage
- Overrides:
setVisible
in classDialogPage
- Parameters:
visible
-true
to make this page visible, andfalse
to hide it
-
useDefaults
public boolean useDefaults()Returns the useDefaults.- Returns:
- boolean
-
getSelectedWorkingSets
Return the selected working sets, if any. If this page is not configured to interact with working sets this will be an empty array.- Returns:
- the selected working sets
- Since:
- 3.4
-