wxPython基础控件使用指南

### wxPython基础控件使用指南 #### 1. 无用户输入情况下更改文本 除了根据用户输入更改显示文本外，`wx.TextCtrl` 还提供了一些方法，可在程序内部更改显示的文本。这些方法在处理只读控件或希望控件文本基于非用户按键事件更改时特别有用。以下是 `wx.TextCtrl` 的文本操作方法： | 方法 | 描述 | | --- | --- | | `AppendText(text)` | 将文本参数追加到控件中文本的末尾，插入点也会移动到控件末尾。 | | `Clear()` | 将控件的文本值重置为空字符串 `""`，同时生成文本更新事件。 | | `EmulateKeyPress(event)` | 根据按键事件，将与该事件关联的字符插入到控件中，就像实际按键发生一样。 | | `GetInsertionPoint()`<br>`SetInsertionPoint(pos)`<br>`SetInsertionPointEnd()` | 插入点位置是当前插入点的整数索引，即下一个插入字符将放置的索引，控件开头为 0。 | | `GetRange(from, to)` | 返回控件中给定整数位置之间的字符串。 | | `GetSelection()`<br>`GetStringSelection()`<br>`SetSelection(from, to)` | `GetSelection()` 返回一个元组 `(start, end)`，包含当前所选文本的索引；`GetStringSelection()` 返回该范围的字符串内容；`SetSelection()` 接受范围的整数端点。 | | `GetValue()`<br>`SetValue(value)` | `SetValue()` 更改控件的整个值，`GetValue()` 返回整个字符串。 | | `Remove(from, to)` | 从文本中移除给定范围的内容。 | | `Replace(from, to, value)` | 用新值替换给定范围的内容，这可能会改变文本的长度。 | | `WriteText(text)` | 与 `AppendText()` 类似，但新文本将放置在当前插入点。 | #### 2. 创建多行或带样式的文本控件 可以使用 `wx.TE_MULTILINE` 样式标志创建多行文本控件。如果原生小部件支持样式，还可以更改控件管理的文本中的字体和颜色样式，这种文本有时称为富文本。对于不支持的平台，设置样式的调用将被忽略。以下是创建多行文本控件的示例代码： ```python import wx class TextFrame(wx.Frame): def __init__(self): wx.Frame.__init__(self, None, -1, 'Text Entry Example', size=(300, 250)) panel = wx.Panel(self, -1) multiLabel = wx.StaticText(panel, -1, "Multi-line") multiText = wx.TextCtrl(panel, -1, "Here is a looooooooooooooong line " "of text set in the control.\n\n" "See that it wrapped, and that " "this line is after a blank", size=(200, 100), style=wx.TE_MULTILINE) multiText.SetInsertionPoint(0) richLabel = wx.StaticText(panel, -1, "Rich Text") richText = wx.TextCtrl(panel, -1, "If supported by the native control, " "this is reversed, and this is a different font.", size=(200, 100), style=wx.TE_MULTILINE|wx.TE_RICH2) richText.SetInsertionPoint(0) richText.SetStyle(44, 52, wx.TextAttr("white", "black")) points = richText.GetFont().GetPointSize() f = wx.Font(points + 3, wx.ROMAN, wx.ITALIC, wx.BOLD, True) richText.SetStyle(68, 82, wx.TextAttr("blue", wx.NullColour, f)) sizer = wx.FlexGridSizer(cols=2, hgap=6, vgap=6) sizer.AddMany([multiLabel, multiText, richLabel, richText]) panel.SetSizer(sizer) if __name__ == '__main__': app = wx.PySimpleApp() frame = TextFrame() frame.Show() app.MainLoop() ``` 除了 `wx.TE_MULTILINE`，还有其他样式标志仅在多行或富文本控件的上下文中有意义，如下表所示： | 样式 | 描述 | | --- | --- | | `wx.HSCROLL` | 如果文本控件是多行的，且声明了此样式，长行将水平滚动而不是换行，此选项在 GTK+ 中被忽略。 | | `wx.TE_AUTO_URL` | 如果设置了富文本选项且平台支持，当用户鼠标悬停或点击文本中的 URL 时，会生成一个事件。 | | `wx.TE_DONTWRAP` | `wx.HSCROLL` 的别名。 | | `wx.TE_LINEWRAP` | 与 `wx.TE_WORDWRAP` 相反，换行可以在任何字符处进行，某些操作系统可能会忽略此样式。 | | `wx.TE_MULTILINE` | 文本控件将显示多行。 | | `wx.TE_RICH` | 在 Windows 下，使用富文本控件作为底层小部件，允许使用样式文本。 | | `wx.TE_RICH2` | 在 Windows 下，使用最新版本的富文本控件作为底层小部件。 | | `wx.TE_WORDWRAP` | 与 `wx.TE_LINEWRAP` 相反，换行仅在单词边界处进行，此选项在许多系统中被忽略。 | `wx.TextCtrl` 小部件中使用的文本样式是 `wx.TextAttr` 类的实例。`wx.TextAttr` 实例具有文本颜色、背景颜色和字体，这些都可以在构造函数中指定： ```python wx.TextAttr(colText, colBack=wx.NullColor, font=wx.NullFont) ``` 文本和背景颜色是 `wxPython` 的 `wx.Color` 对象，可以用颜色名称字符串或 `(红, 绿, 蓝)` 值的元组指定。`wx.NullColor` 表示使用控件现有的背景颜色。字体是 `wx.Font` 对象，后续会详细讨论。`wx.NullFont` 对象表示使用当前默认字体。 `w