Text Tutorial
Text是一个允许用户输入文本的控件，org.eclipse.swt.widgets.Text提供了不同风格的Text。如单行的，多行的，只读的，输入密码的，搜索框等。
我们先通过一段代码来做个初步的认识：
Display display = new Display();
Shell shell = new Shell(display);
shell.setText("Text Tutorial");
shell.setSize(300, 200);
shell.setLayout(new RowLayout(SWT.VERTICAL));
Text text1 = new Text(shell, SWT.NONE);
text1.setText("Default Text");
Text text2 = new Text(shell, SWT.BORDER);
text2.setText("Text with border");
Text text3 = new Text(shell, SWT.MULTI |SWT.BORDER);
text3.setText("Text with multi lines\nAuto wrapped.");
Text text4 = new Text(shell, SWT.PASSWORD |SWT.BORDER);
text4.setText("123456");
Text text5 = new Text(shell, SWT.READ_ONLY | SWT.BORDER);
text5.setText("Read only Text");
Text text6 = new Text(shell, SWT.SEARCH | SWT.BORDER);
text6.setText("Search Text");
shell.open();
while (!shell.isDisposed()) {
if (!display.readAndDispatch()) {
display.sleep();
}
}
display.dispose();
运行后的效果图：
单行（SWT.SINGLE）和多行（SWT.MULTI）只能设置一个。自动换行（SWT.WRAP）只能应用在多行（SWT.MULTI）的Text中，如果不设置SWT.WRAP，多行的Text只有在文本中遇到换行符（\n）的情况下才换行。可以给多行（SWT.MULTI）的Text设置水平（SWT.HORIZONTAL）的或垂直的（SWT.VERTICAL）滚动条。文本对齐（Alignment）可以通过SWT.LEFT，SWT.RIGHT和SWT.CENTER来设置。-
对于搜索框（SWT.SEARCH）可以用SWT.ICON_CANCEL或SWT.ICON_SEARCH来设置图标，但是这要根据系统来定，如Windows就没有此功能。比如，在MAC下带取消图标的搜索框就长这个样子
，当你点击取消图标时，会清空搜索框里面的内容。 对于搜索框（SWT.SEARCH）,可以用setMessage()方法来设置提示信息。只读的Text，不允许被修改内容，且背景色为灰色。默认情况下，Text是没有边界的，要用SWT.BORDER来显示边界。
1. DefaultSelection：通过addSelectionListener(SelectionListener)或addListener(SWT.DefaultSelection, Linstener)添加。
触发条件：
单行（SWT.SINGLE）文本框，当键盘的回车键（Enter）按下时触发。搜索框（SWT.SEARCH），当键盘的回车键（Enter）按下时触发。当搜索框显示取消图标（SWT.ICON_CANCEL）时，点击取消图标清空文本也会触发，不过在Event的detail信息中会包含SWT.ICON_CANCEL值；同理，如果搜索框中显示搜索图标（SWT.ICON_SEARCH）时，点击搜索图标也会触发，且在Event的detail信息中会包含SWT.ICON_SEARCH值。
看一个具体的例子：
Display display = new Display();
Shell shell = new Shell(display);
shell.setText("Text Tutorial");
shell.setSize(300, 200);
shell.setLayout(new GridLayout());
final Label label = new Label(shell, SWT.NONE);
label.setLayoutData(new GridData(GridData.FILL_BOTH
| GridData.GRAB_HORIZONTAL | GridData.GRAB_VERTICAL));
final Text text1 = new Text(shell, SWT.BORDER);
text1.setLayoutData(new GridData(GridData.FILL_HORIZONTAL
| GridData.GRAB_HORIZONTAL));
text1.addSelectionListener(new SelectionListener() {
@Override
public void widgetSelected(SelectionEvent e) {
// Never called for text.
}
@Override
public void widgetDefaultSelected(SelectionEvent e) {
label.setText("Enter pressed: " + text1.getText());
}
});
final Text text2 = new Text(shell, SWT.SEARCH | SWT.ICON_SEARCH);
text2.setLayoutData(new GridData(GridData.FILL_HORIZONTAL
| GridData.GRAB_HORIZONTAL));
text2.setMessage("type message for search");
text2.addListener(SWT.DefaultSelection, new Listener() {
@Override
public void handleEvent(Event event) {
label.setText("Enter pressed to perform search : "
+ text2.getText());
}
});
shell.open();
while (!shell.isDisposed()) {
if (!display.readAndDispatch()) {
display.sleep();
}
}
display.dispose();
如图：
2. Modify：通过addModifyListener(ModifyListener)或addListener(SWT.Modify, Listener)添加。
触发条件：当文本框中的内容发生变化时立即触发。
final Text text = new Text(shell, SWT.BORDER);
text.addModifyListener(new ModifyListener() {
@Override
public void modifyText(ModifyEvent e) {
String newTextValue = text.getText();
// Put your code here
}
});
3. Verify：通过addVerifyListener(VerifyListener)或addListener(SWT.Verify, Listener)添加。
触发条件：当文本框的内容发生变化时立即触发，跟Modify类似，但是它的优先级比Modify高，也就是说如果Verify没有通过，文本框的内容就不会更改，Modify事件也就不会被触发了。这个监听一般用在我们需要输入一些特殊的字符（比如全是数字或全是字母等等）的情况下。
对于VerifyEvent，我们需要知道一下几点信心：
VerifyEvent.start：文本改变的起始位置。VerifyEvent.end：文本改变的结束位置。VerifyEvent.text：输入的新的文本。VerifyEvent.doit：设置为false，则表明Verify没有通过。
通过一段示例来加深印象：
Display display = new Display();
Shell shell = new Shell(display);
shell.setText("Text Modify Tutorial");
shell.setSize(300, 200);
shell.setLayout(new GridLayout());
final Text result = new Text(shell, SWT.MULTI | SWT.V_SCROLL);
result.setLayoutData(new GridData(GridData.FILL_BOTH
| GridData.GRAB_HORIZONTAL | GridData.GRAB_VERTICAL));
final Text text = new Text(shell, SWT.BORDER);
text.setLayoutData(new GridData(GridData.FILL_HORIZONTAL
| GridData.GRAB_HORIZONTAL));
text.addModifyListener(new ModifyListener() {
@Override
public void modifyText(ModifyEvent e) {
result.setText(result.getText() + "\nText modified to: "
+ text.getText());
}
});
text.addVerifyListener(new VerifyListener() {
@Override
public void verifyText(VerifyEvent e) {
int start = e.start;
int end = e.end;
String newValue = e.text;
result.setText("Replace [" + start +"-" + end + "] to '" + newValue + "'");
// Character 'd' is not allowed.
if ("d".endsWith(newValue)){
e.doit = false;
}
}
});
shell.open();
while (!shell.isDisposed()) {
if (!display.readAndDispatch()) {
display.sleep();
}
}
display.dispose();
更多示例：
- verify input (only allow digits)
- verify input in a template (YYYY/MM/DD)
- verify input using a regular expression
参考资料：
- Text snippets
- 如果想了解更多的关于设置颜色，字体等其它属性的相关内容，请移步至控件的通用设置。
- 如果想了解更多的关于
Layout和LayoutData的相关内容，请移步至布局管理器。 - SWT Example: ControlExample
- Sample code and further information
上一篇：Button Tutorial 下一篇：Combo Tutorial