.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2020 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. currentmodule:: wx.lib.intctrl
.. highlight:: python
.. _wx.lib.intctrl.IntValidator:
==========================================================================================================================================
|phoenix_title| **wx.lib.intctrl.IntValidator**
==========================================================================================================================================
Validator class used with :class:`~lib.intctrl.IntCtrl` handles all validation of
input prior to changing the value of the underlying :class:`TextCtrl`.
|
|class_hierarchy| Class Hierarchy
=================================
.. raw:: html
Inheritance diagram for class
IntValidator:
|
|super_classes| Known Superclasses
==================================
:class:`wx.Validator`
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.lib.intctrl.IntValidator.__init__` Standard constructor
:meth:`~wx.lib.intctrl.IntValidator.Clone` Standard cloner
:meth:`~wx.lib.intctrl.IntValidator.OnChar` Validates keystrokes to make sure the resulting value will a legal
:meth:`~wx.lib.intctrl.IntValidator.TransferFromWindow` Transfer data from window to validator.
:meth:`~wx.lib.intctrl.IntValidator.TransferToWindow` Transfer data from validator to window.
:meth:`~wx.lib.intctrl.IntValidator.Validate` Because each operation on the control is vetted as it's made,
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: IntValidator(wx.Validator)
Validator class used with :class:`~lib.intctrl.IntCtrl` handles all validation of
input prior to changing the value of the underlying :class:`TextCtrl`.
.. method:: __init__(self)
Standard constructor
.. method:: Clone (self)
Standard cloner
..note::
Every validator must implement the Clone() method.
.. method:: OnChar(self, event)
Validates keystrokes to make sure the resulting value will a legal
value. Erasing the value causes it to be set to 0, with the value
selected, so it can be replaced. Similarly, replacing the value
with a '-' sign causes the value to become -1, with the value
selected. Leading zeros are removed if introduced by selection,
and are prevented from being inserted.
.. method:: TransferFromWindow(self)
Transfer data from window to validator.
The default implementation returns False, indicating that an error
occurred. We simply return True, to indicate to e.g. :class:`Dialog`
that all is well.
If data comes e.g. from a database then you need to override this.
.. method:: TransferToWindow(self)
Transfer data from validator to window.
The default implementation returns False, indicating that an error
occurred. We simply return True, to indicate to e.g. :class:`Dialog`
that all is well.
If data comes e.g. from a database then you need to override this.
.. method:: Validate(self, window)
Because each operation on the control is vetted as it's made,
the value of the control is always valid.