annotate dwtx/jface/wizard/IWizardPage.d @ 35:ef4534de0cf9

remaining files
author Frank Benoit <benoit@tionex.de>
date Sat, 05 Apr 2008 04:49:22 +0200
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
35
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
1 /*******************************************************************************
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
2 * Copyright (c) 2000, 2006 IBM Corporation and others.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
3 * All rights reserved. This program and the accompanying materials
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
4 * are made available under the terms of the Eclipse Public License v1.0
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
5 * which accompanies this distribution, and is available at
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
6 * http://www.eclipse.org/legal/epl-v10.html
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
7 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
8 * Contributors:
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
9 * IBM Corporation - initial API and implementation
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
10 * Port to the D programming language:
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
11 * Frank Benoit <benoit@tionex.de>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
12 *******************************************************************************/
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
13 module dwtx.jface.wizard.IWizardPage;
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
14
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
15 import dwtx.jface.wizard.IWizard;
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
16
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
17 import dwtx.jface.dialogs.IDialogPage;
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
18
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
19 import dwt.dwthelper.utils;
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
20
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
21 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
22 * Interface for a wizard page.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
23 * <p>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
24 * The class <code>WizardPage</code> provides an abstract implementation
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
25 * of this interface. However, clients are also free to implement this
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
26 * interface if <code>WizardPage</code> does not suit their needs.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
27 * </p>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
28 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
29 public interface IWizardPage : IDialogPage {
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
30 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
31 * Returns whether the next page could be displayed.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
32 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
33 * @return <code>true</code> if the next page could be displayed,
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
34 * and <code>false</code> otherwise
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
35 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
36 public bool canFlipToNextPage();
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
37
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
38 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
39 * Returns this page's name.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
40 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
41 * @return the name of this page
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
42 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
43 public String getName();
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
44
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
45 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
46 * Returns the wizard page that would to be shown if the user was to
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
47 * press the Next button.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
48 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
49 * @return the next wizard page, or <code>null</code> if none
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
50 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
51 public IWizardPage getNextPage();
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
52
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
53 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
54 * Returns the wizard page that would to be shown if the user was to
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
55 * press the Back button.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
56 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
57 * @return the previous wizard page, or <code>null</code> if none
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
58 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
59 public IWizardPage getPreviousPage();
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
60
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
61 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
62 * Returns the wizard that hosts this wizard page.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
63 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
64 * @return the wizard, or <code>null</code> if this page has not been
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
65 * added to any wizard
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
66 * @see #setWizard
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
67 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
68 public IWizard getWizard();
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
69
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
70 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
71 * Returns whether this page is complete or not.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
72 * <p>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
73 * This information is typically used by the wizard to decide
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
74 * when it is okay to finish.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
75 * </p>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
76 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
77 * @return <code>true</code> if this page is complete, and
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
78 * <code>false</code> otherwise
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
79 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
80 public bool isPageComplete();
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
81
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
82 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
83 * Sets the wizard page that would typically be shown
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
84 * if the user was to press the Back button.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
85 * <p>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
86 * This method is called by the container.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
87 * </p>
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
88 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
89 * @param page the previous wizard page
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
90 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
91 public void setPreviousPage(IWizardPage page);
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
92
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
93 /**
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
94 * Sets the wizard that hosts this wizard page.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
95 * Once established, a page's wizard cannot be changed
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
96 * to a different wizard.
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
97 *
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
98 * @param newWizard the wizard
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
99 * @see #getWizard
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
100 */
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
101 public void setWizard(IWizard newWizard);
ef4534de0cf9 remaining files
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
102 }