wxPython in Action (TextEntryDialog

 9.1.3 如何从用户得到短的文本？

这第二个简单类型的对话框是wx.TextEntryDialog，它被用于从用户那里得到短的文本输入。它通常用在在程序的开始时要求用户名或密码的时候，或作为一个数据输入表单的基本替代物。图9.3显示了一个典型的文本对话框。

图9.3 文本输入标准对话框


例9.3显示了产生图9.3的代码

例9.3

import wx

if __name__ == "__main__":
    app = wx.PySimpleApp()
    dialog = wx.TextEntryDialog(None, 
            "What kind of text would you like to enter?",
            "Text Entry", "Default Value", style=wx.OK|wx.CANCEL)
    if dialog.ShowModal() == wx.ID_OK:
        print "You entered: %s" % dialog.GetValue()

    dialog.Destroy()

在前一小节，我们创建了一个对话框类的实例，在这里，我们要用到的对话框类是wx.TextEntryDialog。该类的构造函数比简单消息对话框要复杂一些：

wx.TextEntryDialog(parent, message, caption="Please enter text", 
    defaultValue="", style=wx.OK | wx.CANCEL | wx.CENTRE, 
    pos=wx.DefaultPosition)

message参数是显示在对话框中的文本提示，而caption显示在标题栏中。defaultValue显示在文本框中的默认值。style可以包括wx.OK和wx.CANCEL，它显示适当的按钮。

几个wx.TextCtrl的样式也可以用在这里。最有用的应该是wx.TE_PASSWORD，它掩饰所输入的真实密码。你也可以使用wx.TE_MULTILINE来使用户能够在对话框中输入多行文本，也可以使用wx.TE_LEFT, wx.TE_CENTRE, 和 wx.TE_RIGHT来调整所输入的文本的对齐位置。

例9.3的最后显示了在文本框和对话框之间的另一区别。用户所输入的信息被存储在该对话框实例中，并且以后必须应用程序获取。在这种情况下，你可以使用对话框的GetValue()方法来得到该值。记住，如果用户按下Cancel（取消）去退出该对话框，这意味他们不想去使用他所键入的值。你也可以在程序中使用SetValue()方法来设置该值。

下面这些是使用文本对话框的便利函数：

1、wx.GetTextFromUser()
2、wx.GetPasswordFromUser()
3、wx.GetNumberFromUser()

其中和例9.3的用处最近似的是wx.GetTextFromUser()：

wx.GetTextFromUser(message, caption="Input text", 
    default_value="", parent=None)

这里的message, caption, default_value, 和 parent与wx.TextEntryDialog的构造函数中的一样。如果用户按下OK，该函数的返回值是用户所输入的字符串。如果用户按下Cancel，该函数返回空字符串。

如果你希望用户输入密码，你可以使用wx.GetPasswordFromUser()函数：

wx.GetPasswordFromUser(message, caption="Input text", 
    default_value="", parent=None)

这里的参数意义和前面的一样。用户的输入被显示为星号，如果用户按下OK，该函数的返回值是用户所输入的字符串。如果用户按下Cancel，该函数返回空字符串。

最后，你可以使用wx.GetNumberFromUser()要求用户输入一个数字：

wx.GetNumberFromUser(message, prompt, caption, value, min=0, 
    max=100, parent=None) 

这里的参数的意义有一点不同，message是显在prompt上部的任意长度的消息，value参数是默认显示在文本框中的长整型值。min和max参数为用户的输入限定一个范围。如果用户按下OK按钮退出的话，该方法返回所输入的值，并转换为长整型。如果这个值不能转换为一个数字，或不在指定的范围内，那么该函数返回-1，这意味如果你将该函数用于负数的范围的话，你可能要考虑一个转换的方法。

9.1.4 如何用对话框显示选项列表？

如果给你的用户一个空的文本输入域显得太自由了，那么你可以使用wx.SingleChoiceDialog来让他们在一组选项中作单一的选择。图9.4显示了一个例子。

图9.4 一个单选对话框


例9.4显示了产生图9.4的代码

例9.4 显示一个选择列表对话框

import wx

if __name__ == "__main__":
    app = wx.PySimpleApp()
    choices = ["Alpha", "Baker", "Charlie", "Delta"]
    dialog = wx.SingleChoiceDialog(None, "Pick A Word", "Choices",
            choices)
    if dialog.ShowModal() == wx.ID_OK:
        print "You selected: %s\n" % dialog.GetStringSelection()

    dialog.Destroy()
    
wx.SingleChoiceDialog的构造函数如下所示：

wx.SingleChoiceDialog(parent, message, caption, choices, 
        clientData=None, style=wx.OK | wx.CANCEL | wx.CENTRE, 
        pos=wx.DefaultPosition) 

message和caption参数的意义与前面的一样，分别显示在对话框和标题栏中。choices参数要求一个字符串的列表，它们是你呈现在对话框中的选项。style参数有三个项，这是默认的，分别是OK按钮、Cancle按钮和使对话框在屏幕中居中。centre选项和pos参数在Windows操作系统上不工作。

如果你想在用户看见对话框之前，设置它的默认选项，使用SetSelection(selection)方法。参数selection是选项的索引值，而非实际选择的字符串。在用户选择了一个选项后，你即可以使用GetSelection()——它返回所选项的索引值，也可以使用GetStringSelection()——它返回实际所选的字符串，来得到它。

有两个用于单选对话框的便利函数。第一个是wx.GetSingleChoice，它返回用户所选的字符串：

wx.GetSingleChoice(message, caption, aChoices, parent=None)

参数message, caption, 和parent的意义和wx.SingleChoiceDialog构造函数的一样。aChoices参数是选项的列表。如果用户按下OK，则返回值是所选的字符串，如果用户按下Cancel，则返回值是空字符串。这意味如果空字符是一个有效的选择的话，那么你就不该使用这个函数。

第二个是wx.GetSingleChoiceIndex:

wx.GetSingleChoiceIndex(message, caption, aChoices, parent=None)

这个函数与第一个有相同的参数，但是返回值不同。如果用户按下OK，则返回值是所选项的索引，如果用户按下Cancel，则返回值是-1。