e43b145d4c74b79e8bb217f2afaac5898c77d28d
[phpeclipse.git] /
1 /*******************************************************************************
2  * Copyright (c) 2000, 2003 IBM Corporation and others.
3  * All rights reserved. This program and the accompanying materials 
4  * are made available under the terms of the Common Public License v1.0
5  * which accompanies this distribution, and is available at
6  * http://www.eclipse.org/legal/cpl-v10.html
7  * 
8  * Contributors:
9  *     IBM Corporation - initial API and implementation
10  *******************************************************************************/
11 package net.sourceforge.phpdt.internal.ui.wizards.dialogfields;
12
13 import org.eclipse.swt.SWT;
14 import org.eclipse.swt.events.ModifyEvent;
15 import org.eclipse.swt.events.ModifyListener;
16 import org.eclipse.swt.layout.GridData;
17 import org.eclipse.swt.widgets.Composite;
18 import org.eclipse.swt.widgets.Control;
19 import org.eclipse.swt.widgets.Label;
20 import org.eclipse.swt.widgets.Text;
21
22 /**
23  * Dialog field containing a label and a text control.
24  */
25 public class StringDialogField extends DialogField {
26
27         private String fText;
28
29         private Text fTextControl;
30
31         private ModifyListener fModifyListener;
32
33         public StringDialogField() {
34                 super();
35                 fText = ""; //$NON-NLS-1$
36         }
37
38         // ------- layout helpers
39
40         /*
41          * @see DialogField#doFillIntoGrid
42          */
43         public Control[] doFillIntoGrid(Composite parent, int nColumns) {
44                 assertEnoughColumns(nColumns);
45
46                 Label label = getLabelControl(parent);
47                 label.setLayoutData(gridDataForLabel(1));
48                 Text text = getTextControl(parent);
49                 text.setLayoutData(gridDataForText(nColumns - 1));
50
51                 return new Control[] { label, text };
52         }
53
54         /*
55          * @see DialogField#getNumberOfControls
56          */
57         public int getNumberOfControls() {
58                 return 2;
59         }
60
61         protected static GridData gridDataForText(int span) {
62                 GridData gd = new GridData();
63                 gd.horizontalAlignment = GridData.FILL;
64                 gd.grabExcessHorizontalSpace = false;
65                 gd.horizontalSpan = span;
66                 return gd;
67         }
68
69         // ------- focus methods
70
71         /*
72          * @see DialogField#setFocus
73          */
74         public boolean setFocus() {
75                 if (isOkToUse(fTextControl)) {
76                         fTextControl.setFocus();
77                         fTextControl.setSelection(0, fTextControl.getText().length());
78                 }
79                 return true;
80         }
81
82         // ------- ui creation
83
84         /**
85          * Creates or returns the created text control.
86          * 
87          * @param parent
88          *            The parent composite or <code>null</code> when the widget
89          *            has already been created.
90          */
91         public Text getTextControl(Composite parent) {
92                 if (fTextControl == null) {
93                         assertCompositeNotNull(parent);
94                         fModifyListener = new ModifyListener() {
95                                 public void modifyText(ModifyEvent e) {
96                                         doModifyText(e);
97                                 }
98                         };
99
100                         fTextControl = new Text(parent, SWT.SINGLE | SWT.BORDER);
101                         // moved up due to 1GEUNW2
102                         fTextControl.setText(fText);
103                         fTextControl.setFont(parent.getFont());
104                         fTextControl.addModifyListener(fModifyListener);
105
106                         fTextControl.setEnabled(isEnabled());
107                 }
108                 return fTextControl;
109         }
110
111         private void doModifyText(ModifyEvent e) {
112                 if (isOkToUse(fTextControl)) {
113                         fText = fTextControl.getText();
114                 }
115                 dialogFieldChanged();
116         }
117
118         // ------ enable / disable management
119
120         /*
121          * @see DialogField#updateEnableState
122          */
123         protected void updateEnableState() {
124                 super.updateEnableState();
125                 if (isOkToUse(fTextControl)) {
126                         fTextControl.setEnabled(isEnabled());
127                 }
128         }
129
130         // ------ text access
131
132         /**
133          * Gets the text. Can not be <code>null</code>
134          */
135         public String getText() {
136                 return fText;
137         }
138
139         /**
140          * Sets the text. Triggers a dialog-changed event.
141          */
142         public void setText(String text) {
143                 fText = text;
144                 if (isOkToUse(fTextControl)) {
145                         fTextControl.setText(text);
146                 } else {
147                         dialogFieldChanged();
148                 }
149         }
150
151         /**
152          * Sets the text without triggering a dialog-changed event.
153          */
154         public void setTextWithoutUpdate(String text) {
155                 fText = text;
156                 if (isOkToUse(fTextControl)) {
157                         fTextControl.removeModifyListener(fModifyListener);
158                         fTextControl.setText(text);
159                         fTextControl.addModifyListener(fModifyListener);
160                 }
161         }
162
163 }