文本输入控件wx.TextCtrl

构造函数：

 

wx.TextCtrl(parent,
 id,
 value='',
 pos=wx.DefaultPostion,
size=wx.DefaultSize,
 style=0,
 validator=wx.DefaultValidator,
 name=wx.TextCtrlNameStr)

 

 

---

wx.TextCtrl的样式:

wx.TE_CENTER：控件中的文本居中。

wx.TE_LEFT：控件中的文本左对齐。默认行为。

wx.TE_NOHIDESEL：文本始终高亮显示，只适用于Windows。

wx.TE_PASSWORD：不显示所键入的文本，代替以星号显示。

wx.TE_PROCESS_ENTER：如果使用了这个样式，那么当用户在控件内按下回车

键时，一个文本输入事件被触发。否则，按键事件内在的由该文本控件或该对话框管

理。

wx.TE_PROCESS_TAB：如果指定了这个样式，那么通常的字符事件在Tab键按下

时创建（一般意味一个制表符将被插入文本）。否则，tab由对话框来管理，通常是

控件间的切换。

wx.TE_READONLY：文本控件为只读，用户不能修改其中的文本。

wx.TE_RIGHT：控件中的文本右对齐。

---

不输入的情况下如何改变文本：

AppendText(text)：在尾部添加文本。

Clear()：重置控件中的文本为“”。并且生成一个文本更新事件。

EmulateKeyPress(event)：产生一个按键事件，插入与事件相关联的控制符，就如同实际的按键发生了。

GetInsertionPoint()

SetInsertionPoint(pos)

SetInsertionPointEnd()：得到或设置插入点的位置，位置是整型的索引值。控件的开始位置是0。

GetRange(from, to)：返回控件中位置索引范围内的字符串。

GetSelection()

GetStringSelection()

SetSelection(from, to)：GetSelection()以元组的形式返回当前所选择的文本的起始位置的索引值（开始，结束）。                    GetStringSelection()得到所选择的字符串。SetSelection(from, to)设置选择的文本。

GetValue()

SetValue(value)：SetValue()改变控件中的全部文本。GetValue()返回控件中所有的字符串。

Remove(from, to)：删除指定范围的文本。

Replace(from, to, value)：用给定的值替换掉指定范围内的文本。这可以改变文本的长度。

WriteText(text)：类似于AppendText()，只是写入的文本被放置在当前的插入点。

---

使用多行或丰富文本样式  

wx.HSCROLL：如果文本控件是多行的，并且如果该样式被声明了，那么长的行将不会自动换行，并显示水平滚动条。该选项在GTK+中被忽略。

wx.TE_AUTO_URL：如果丰富文本选项被设置并且平台支持的话，那么当用户的鼠标位于文本中的一个URL上或在该URL上敲击时，这个样式将导致一个事件被生成。

wx.TE_DONTWRAP：wx.HSCROLL的别名。

wx.TE_LINEWRAP：对于太长的行，以字符为界换行。某些操作系统可能会忽略该样式。

wx.TE_MULTILINE：文本控件将显示多行。

wx.TE_RICH：用于Windows下，丰富文本控件用作基本的窗口部件。这允许样式文本的使用。

wx.TE_RICH2：用于Windows下，把最新版本的丰富文本控件用作基本的窗口部件。

wx.TE_WORDWRAP：对于太长的行，以单词为界换行。许多操作系统会忽略该样式。

---

在wx.TextCtrl窗口部件中的文本样式类(wx.TextAttr)

构造函数：

wx.TextAttr(colText, colBack=wx.NullColor, font=wx.NullFont)

 分别为字体颜色，背景色，字体。文本色和背景色为wxPython对象，可由颜色名或颜色的RGB值（红，绿，蓝）来 指定。NullColor和NullFont都表示当前的默认值。

wx.TextAttr的方法：

GetBackgroundColour()，

GetFont()，

GetTextColour(),

HasBackgroundColour(),

HasFont(),

HasTextColour()。

wx.TextAttr的实例是不可变的，如果要改变文本的样式，必须创建新的实例。

如果要使用文本样式，就要调用textCtrl的SetDefaultStyle(style)或者SetStyle(start,end,style)

---

wx.TextCtrl的一些实用的方法:

GetDefaultStyle()

SetDefaultStyle(style)：上面已作了说明。

GetLineLength(lineNo)：返回给定行的长度的整数值。

GetLineText(lineNo)：返回给定行的文本。

GetNumberOfLines()：返回控件中的行的数量。对于单行，返回1。

IsMultiLine()

IsSingleLine()：布尔类型的方法，确定控件的状态。

PositionToXY(pos)：指定文本内的一个整数值位置，返回以元组(列，行)形式的索引位置。列和行的索引值均以0作为开始。

SetStyle(start, end,style)：立即改变指定范围内文本的样式。

ShowPosition(pos)：引起一个多行控件的滚动，以便观察到指定位置的内容。

XYToPosition(x, y)：与PositionToXY(pos)相反——指定行和列，返回整数值位置。

---

响应文本事件：

frame.Bind(wx.EVT_TEXT, frame.OnText, text)

 

事件列表如下：

EVT_TEXT：当控件中的文本改变时产生该事件。文本因用户的输入或在程序中使

用SetValue()而被改变，都要产生该事件。

EVT_TEXT_ENTER：当用户在一个wx.TE_PROCESS_ENTER样式的文本控件中

按下了回车键时，产生该事件。

EVT_TEXT_URL：如果在Windows系统上，wx.TE_RICH或wx.TE_RICH2样式被设

置了，并且wx.TE_AUTO_URL样式也被设置了，那么当在文本控件内的URL上发生

了一个鼠标事件时，该事件被触发。

EVT_TEXT_MAXLEN：如果使用SetMaxLength()指定了该控件的最大长度，那么当

用户试图输入更长的字符串时，该事件被触发。你可能会用这个，例如，这时给用户

显示一个警告消息。