"""XRC dialog runner. This module facilitates creating and running simple dialogs that are defined in XRC files. The XRC file must define OK and Cancel buttons with XRC IDs of 'ID_OK' and 'ID_CANCEL'. The feature to run a dialog will only set and return values for controls that support GetValue() and SetValue(). Customizing this to support other types of controls is doable. The basic principle of operation can be summarized with this sample code: import wx from wx import xrc app = wx.PySimpleApp() # assuming you don't already have an app running # Load the dialog from the resource file. res = xrc.XmlResource('dialog.xrc') dlg = res.LoadDialog(None, 'dlgLogin') dlg.Fit() # Configure OK & Cancel buttons for default behavior. dlg.FindWindowByName('ID_OK' ).SetId(wx.ID_OK) dlg.FindWindowByName('ID_CANCEL').SetId(wx.ID_CANCEL) # Run the dialog. if dlg.ShowModal() == wx.ID_OK: print 'OK' else: print 'Cancel' # Extract results. print '%r' % dlg.FindWindowByName('fldUser' ).GetValue() print '%r' % dlg.FindWindowByName('fldPassword').GetValue() Once the dialog or frame is created, you are free to use Bind() calls to add handlers to various controls: def myHandler(evt): print 'click!' dlg.FindWindowByName('myButton').Bind(wx.EVT_BUTTON, myHandler) """ import os import wx from wx import xrc resourceCache = dict() def insureWxApp(): """Create an instance of PySimpleApp if there is no app already. This is required by wxPython before creating any GUI objects. """ global _wxApp _wxApp = wx.GetApp() if not _wxApp: _wxApp = wx.PySimpleApp() return _wxApp def loadXrc(filePath, reload=False): """Return an xrc.XmlResource instance.""" filePath = os.path.abspath(filePath) if reload or (filePath not in resourceCache): result = xrc.XmlResource(filePath) resourceCache[filePath] = result else: result = resourceCache[filePath] return result def escapeSuppressor(evt): """wx.EVT_CHAR_HOOK handler that suppresses processing ESC. By default, if you don't have a Cancel button, wx will trigger the OK button when you press ESC. Binding this to a dialog will deactivate the ESC key. We need this when there is no Cancel button. """ evt.Skip(evt.GetKeyCode() != wx.WXK_ESCAPE) def buildDialog(filePath, resourceName, mayCancel, **defaults): """Return a configured wx.Dialog. Assumes that the OK and Cancel buttons are named ID_OK & ID_CANCEL. """ res = loadXrc(filePath) insureWxApp() dlg = res.LoadDialog(None, resourceName) assert isinstance(dlg, wx.Dialog) dlg.Fit() fetchWidget = dlg.FindWindowByName bOk = dlg.FindWindowByName('ID_OK') bCancel = dlg.FindWindowByName('ID_CANCEL') bOk.SetId(wx.ID_OK) bCancel.SetId(wx.ID_CANCEL) if not mayCancel: bCancel.Disable() bCancel.Hide() for name, value in defaults.items(): dlg.FindWindowByName(name).SetValue(value) if not mayCancel: dlg.Bind(wx.EVT_CHAR_HOOK, escapeSuppressor) return dlg def runDialog(dlg, mayCancel, *itemNames): """Run the specified dialog and return the values of the named items. Return None if the user cancels. """ while True: if dlg.ShowModal() == wx.ID_OK: result = tuple((dlg.FindWindowByName(name).GetValue() for name in itemNames)) break elif mayCancel: result = None break else: wx.Bell() return result def useTemporaryDialog(filePath, resourceName, mayCancel, *itemNames, **defaults): """Create a dialog, run it, capture the results, destroy the dialog, and return the results. Return None if the user cancels. """ dlg = buildDialog(filePath, resourceName, mayCancel, **defaults) try: result = runDialog(dlg, mayCancel, *itemNames) finally: dlg.Destroy() return result # --- Sample Dialog --- def askLogin(defaultUser='', defaultPassword='', mayCancel=True): """Return None if user cancels; otherwise (user, password) as unicode.""" result = useTemporaryDialog('dialog.xrc', 'dlgLogin', mayCancel, 'fldUser', 'fldPassword', fldUser=defaultUser, fldPassword=defaultPassword) return result # --- Sample Usage --- import sys print askLogin('john_doe', '123', mayCancel=False) print askLogin() # --- Sample XRC File named dialog.xrc --- # Open in XRCed (part of "wxPython Docs Demos & Tools") or wxGlade to edit. """ Login wxVERTICAL 2 2 wxALL|wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL 8 wxALL|wxEXPAND 8 200,20 wxALL|wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL 8 wxALL|wxEXPAND 8 1 wxALL|wxEXPAND 8 wxHORIZONTAL wxALL|wxALIGN_BOTTOM 8 1 wxALL|wxALIGN_BOTTOM 8 wxBOTTOM|wxLEFT|wxRIGHT|wxALIGN_RIGHT 8 1 """