X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/8b9a4190f70909de9568f45389e7aa3ecbc66b8a..28e5e577e4d26332a7ebdf7d1dc7492807fa1601:/wxPython/wx/lib/maskedctrl.py diff --git a/wxPython/wx/lib/maskedctrl.py b/wxPython/wx/lib/maskedctrl.py index 4e5aaafbc4..a3d6413c0a 100644 --- a/wxPython/wx/lib/maskedctrl.py +++ b/wxPython/wx/lib/maskedctrl.py @@ -1,8 +1,101 @@ +#---------------------------------------------------------------------------- +# Name: wxPython.lib.maskedctrl.py +# Author: Will Sadkin +# Created: 09/24/2003 +# Copyright: (c) 2003 by Will Sadkin +# RCS-ID: $Id$ +# License: wxWindows license +#---------------------------------------------------------------------------- + +""" +

+wxMaskedCtrl is actually a factory function for several types of +masked edit controls: +

wxMaskedTextCtrl - standard masked edit text box
wxMaskedComboBox - adds combobox capabilities
wxIpAddrCtrl - adds logical input semantics for IP address entry
wxTimeCtrl - special subclass handling lots of time formats as values
wxMaskedNumCtrl - special subclass handling numeric values

+wxMaskedCtrl works by looking for a special controlType +parameter in the variable arguments of the control, to determine +what kind of instance to return. +controlType can be one of: +


+    controlTypes.MASKEDTEXT
+    controlTypes.MASKEDCOMBO
+    controlTypes.IPADDR
+    controlTypes.TIME
+    controlTypes.NUMBER
+

+These constants are also available individually, ie, you can +use either of the following: +


+    from wxPython.wx.lib.maskedctrl import wxMaskedCtrl, MASKEDCOMBO, MASKEDTEXT, NUMBER
+    from wxPython.wx.lib.maskedctrl import wxMaskedCtrl, controlTypes
+

+If not specified as a keyword argument, the default controlType is +controlTypes.MASKEDTEXT. +

+Each of the above classes has its own unique arguments, but wxMaskedCtrl +provides a single "unified" interface for masked controls. wxMaskedTextCtrl, +wxMaskedComboBox and wxIpAddrCtrl are all documented below; the others have +their own demo pages and interface descriptions. + +""" + +from wxPython.lib.maskededit import wxMaskedTextCtrl, wxMaskedComboBox, wxIpAddrCtrl +from wxPython.lib.maskednumctrl import wxMaskedNumCtrl +from wxPython.lib.timectrl import wxTimeCtrl + + +# "type" enumeration for class instance factory function +MASKEDTEXT = 0 +MASKEDCOMBO = 1 +IPADDR = 2 +TIME = 3 +NUMBER = 4 + +# for ease of import +class controlTypes: + MASKEDTEXT = MASKEDTEXT + MASKEDCOMBO = MASKEDCOMBO + IPADDR = IPADDR + TIME = TIME + NUMBER = NUMBER + + +def wxMaskedCtrl( *args, **kwargs): + """ + Actually a factory function providing a unifying + interface for generating masked controls. + """ + if not kwargs.has_key('controlType'): + controlType = MASKEDTEXT + else: + controlType = kwargs['controlType'] + del kwargs['controlType'] + + if controlType == MASKEDTEXT: + return wxMaskedTextCtrl(*args, **kwargs) + + elif controlType == MASKEDCOMBO: + return wxMaskedComboBox(*args, **kwargs) + + elif controlType == IPADDR: + return wxIpAddrCtrl(*args, **kwargs) + + elif controlType == TIME: + return wxTimeCtrl(*args, **kwargs) + + elif controlType == NUMBER: + return wxMaskedNumCtrl(*args, **kwargs) + + else: + raise AttributeError( + "invalid controlType specified: %s" % repr(controlType)) -"""Renamer stub: provides a way to drop the wx prefix from wxPython objects.""" -from wx import _rename -from wxPython.lib import maskedctrl -_rename(globals(), maskedctrl.__dict__, modulename='lib.maskedctrl') -del maskedctrl -del _rename