Text小部件提供了浏览以及编辑文本的能力。如果用户输入的字符串超过了小部件容纳的能力的话,它将自动生成滚动条。有用的API如下:
addModifyListener(ModifyListener)在监听器集合中添加一个监听器,当接收者修改文本的时候通过给它发送一个定义在ModifyListener接口中的消息去通知监听器。
addSelectionListener(SelectionListener)在监听器集合中添加一个监听器,当选中控件的时候通过给它发送一个定义在SelectionListener接口中的消息去通知监听器。
addVerifyListener(VerifyListener)在监听器集合中添加一个监听器,当需要验证接收者的时候通过给它发送一个定义在VerifyListener接口中的消息去通知监听器。
clearSelection()清理选择。
copy()复制已选择的文本。
getText()获取小部件的文本。
getText(int start, int end)获取范围内的文本。
insert(String)插入一个字符串。
paste()从粘贴板复制文本。
selectAll()选择所有接收者的文本。
setEchoChar(char echo)设置显示的字符。(译者注:这个是设置统一的显示字符,比如作为密码框,你可以设置成’*’)。
setEditable(boolean editable)设置可编辑的状态。
setSelection(int start, int end)设置选中的范围。
setText(String)为接收者设置一个以给定的字符串。
setTextLimit(int)设置接收者的最大接受字符的能力。
setTopIndex(int)当前接收者置顶的行的零相关的索引值。
有用的创建风格如下:
SWT.SINGLE创建一个单行的Text小部件。
SWT.MULTI创建一个多行的Text小部件。
SWT.WRAP多行的时候根据需要是Text换行。(译者注:如果需要的话使用者可以使用‘/n’去换行)
SWT.READ_ONLY创建一个只读的Text小部件,它不能编辑。
SWT.LEFT创建一个居左对齐的Text小部件。
SWT.RIGHT创建一个居右对齐的Text小部件。
SWT.CENTER创建一个居中对齐的Text小部件。