wxPython/demo/Dialog.py

   1
   2 import  wx
   3
   4 #---------------------------------------------------------------------------
   5 # Create and set a help provider.  Normally you would do this in
   6 # the app's OnInit as it must be done before any SetHelpText calls.
   7 provider = wx.SimpleHelpProvider()
   8 wx.HelpProvider_Set(provider)
   9
  10 #---------------------------------------------------------------------------
  11
  12 class TestDialog(wx.Dialog):
  13     def __init__(
  14             self, parent, ID, title, size=wx.DefaultSize, pos=wx.DefaultPosition,
  15             style=wx.DEFAULT_DIALOG_STYLE
  16             ):
  17
  18         # Instead of calling wx.Dialog.__init__ we precreate the dialog
  19         # so we can set an extra style that must be set before
  20         # creation, and then we create the GUI dialog using the Create
  21         # method.
  22         pre = wx.PreDialog()
  23         pre.SetExtraStyle(wx.DIALOG_EX_CONTEXTHELP)
  24         pre.Create(parent, ID, title, pos, size, style)
  25
  26         # This next step is the most important, it turns this Python
  27         # object into the real wrapper of the dialog (instead of pre)
  28         # as far as the wxPython extension is concerned.
  29         self.PostCreate(pre)
  30
  31         # Now continue with the normal construction of the dialog
  32         # contents
  33         sizer = wx.BoxSizer(wx.VERTICAL)
  34
  35         label = wx.StaticText(self, -1, "This is a wx.Dialog")
  36         label.SetHelpText("This is the help text for the label")
  37         sizer.Add(label, 0, wx.ALIGN_CENTRE|wx.ALL, 5)
  38
  39         box = wx.BoxSizer(wx.HORIZONTAL)
  40
  41         label = wx.StaticText(self, -1, "Field #1:")
  42         label.SetHelpText("This is the help text for the label")
  43         box.Add(label, 0, wx.ALIGN_CENTRE|wx.ALL, 5)
  44
  45         text = wx.TextCtrl(self, -1, "", size=(80,-1))
  46         text.SetHelpText("Here's some help text for field #1")
  47         box.Add(text, 1, wx.ALIGN_CENTRE|wx.ALL, 5)
  48
  49         sizer.Add(box, 0, wx.GROW|wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5)
  50
  51         box = wx.BoxSizer(wx.HORIZONTAL)
  52
  53         label = wx.StaticText(self, -1, "Field #2:")
  54         label.SetHelpText("This is the help text for the label")
  55         box.Add(label, 0, wx.ALIGN_CENTRE|wx.ALL, 5)
  56
  57         text = wx.TextCtrl(self, -1, "", size=(80,-1))
  58         text.SetHelpText("Here's some help text for field #2")
  59         box.Add(text, 1, wx.ALIGN_CENTRE|wx.ALL, 5)
  60
  61         sizer.Add(box, 0, wx.GROW|wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5)
  62
  63         line = wx.StaticLine(self, -1, size=(20,-1), style=wx.LI_HORIZONTAL)
  64         sizer.Add(line, 0, wx.GROW|wx.ALIGN_CENTER_VERTICAL|wx.RIGHT|wx.TOP, 5)
  65
  66         btnsizer = wx.StdDialogButtonSizer()
  67
  68         if wx.Platform != "__WXMSW__":
  69             btn = wx.ContextHelpButton(self)
  70             btnsizer.AddButton(btn)
  71
  72         btn = wx.Button(self, wx.ID_OK)
  73         btn.SetHelpText("The OK button completes the dialog")
  74         btnsizer.AddButton(btn)
  75
  76         btn = wx.Button(self, wx.ID_CANCEL)
  77         btn.SetHelpText("The Cancel button cnacels the dialog. (Cool, huh?)")
  78         btnsizer.AddButton(btn)
  79         btnsizer.Finalise()
  80
  81         sizer.Add(btnsizer, 0, wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5)
  82
  83         self.SetSizer(sizer)
  84         self.SetAutoLayout(True)
  85         sizer.Fit(self)
  86
  87 #---------------------------------------------------------------------------
  88
  89 class TestPanel(wx.Panel):
  90     def __init__(self, parent, log):
  91         self.log = log
  92         wx.Panel.__init__(self, parent, -1)
  93
  94         b = wx.Button(self, -1, "Create and Show a custom Dialog", (50,50))
  95         self.Bind(wx.EVT_BUTTON, self.OnButton, b)
  96
  97
  98     def OnButton(self, evt):
  99         dlg = TestDialog(self, -1, "This is a Dialog", size=(350, 200),
 100                          #style = wxCAPTION | wxSYSTEM_MENU | wxTHICK_FRAME
 101                          style = wx.DEFAULT_DIALOG_STYLE
 102                          )
 103         dlg.CenterOnScreen()
 104
 105         # this does not return until the dialog is closed.
 106         val = dlg.ShowModal()
 107
 108         if val == wx.ID_OK:
 109             self.log.WriteText("You pressed OK\n")
 110         else:
 111             self.log.WriteText("You pressed Cancel\n")
 112
 113         dlg.Destroy()
 114
 115
 116 #---------------------------------------------------------------------------
 117
 118
 119 def runTest(frame, nb, log):
 120     win = TestPanel(nb, log)
 121     return win
 122
 123
 124 #---------------------------------------------------------------------------
 125
 126
 127 overview = """\
 128 wxPython offers quite a few general purpose dialogs for useful data input from
 129 the user; they are all based on the wx.Dialog class, which you can also subclass
 130 to create custom dialogs to suit your needs.
 131
 132 The Dialog class, in addition to dialog-like behaviors, also supports the full
 133 wxWindows layout featureset, which means that you can incorporate sizers or
 134 layout constraints as needed to achieve the look and feel desired. It even supports
 135 context-sensitive help, which is illustrated in this example.
 136
 137 The example is very simple; in real world situations, a dialog that had input
 138 fields such as this would no doubt be required to deliver those values back to
 139 the calling function. The Dialog class supports data retrieval in this manner.
 140 <b>However, the data must be retrieved prior to the dialog being destroyed.</b>
 141 The example shown here is <i>modal</i>; non-modal dialogs are possible as well.
 142
 143 See the documentation for the <code>Dialog</code> class for more details.
 144
 145 """
 146
 147 if __name__ == '__main__':
 148     import sys,os
 149     import run
 150     run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
 151