wxPython 开发实战之输入控件 TextCtrl 使用验证器 Validator 来约束输入

￡神魔★判官ぃ 2022-02-20 03:55 469阅读 0赞

## 前言 ##

TextCtrl 是 wxPython 框架里一个非常实用的文本输入控件，我们经常需要对 TextCtrl 做这样一个输入上的约束：只允许输入数字（比如允许 1.2、4.5、100 这些输入而禁止诸如 .8、4t等输入，方便我们在将输入的 str 类型转成 int、float 等其他类型时不需要额外加判断来防止产生异常。今天我查阅 wxPython 的 API,发现了 Validator 这个类可以满足我们的需求。事实上，不仅是满足只允许输入数字这个需要，掌握了 Validator 这个类的使用，我们可以满足任何定制化的需求。

## 编码 ##

#### 首先必须新建类继承自 wx.Validator ####

import wx
    
    class MyNumberValidator(wx.Validator):# 创建验证器子类      
    	def __init__(self):
    		wx.Validator.__init__(self)
    	  
    	def Clone(self):
    		return MyNumberValidator()
    
    	def Validate(self,win):#1 使用验证器方法
    		return True
    
    	def TransferToWindow(self):
    		return True
    
    	def TransferFromWindow(self):
    		return True

同时，必须重写 **init**()(完成初始化）、Clone()(返回当前类的一个实例）等五个方法，你只要把它们当成一个模板就行，然后在此基础上加上我们自己的逻辑。

#### 根据需求加入实现逻辑 ####

import wx
    # import wx.lib.imagebrowser
    
    
    class MyNumberValidator(wx.Validator):# 创建验证器子类      
    	def __init__(self):
    		wx.Validator.__init__(self)
    		self.ValidInput = ['.','0','1','2','3','4','5','6','7','8','9']
    		self.StringLength = 0
    		self.Bind(wx.EVT_CHAR,self.OnCharChanged)  #  绑定字符改变事件
    
    	def OnCharChanged(self,event):
    		# 得到输入字符的 ASCII 码
    		keycode = event.GetKeyCode()
    		# 退格（ASCII 码 为8），删除一个字符。
    		if keycode == 8:
    			self.StringLength -= 1
    			#事件继续传递
    			event.Skip()
    			return
    
    		# 把 ASII 码 转成字符
    		InputChar = chr(keycode)
    
    		if InputChar in self.ValidInput:
    			# 第一个字符为 .,非法，拦截该事件，不会成功输入
    			if InputChar == '.' and self.StringLength == 0:
    				return False
    			# 在允许输入的范围，继续传递该事件。
    			else:
    				event.Skip()
    				self.StringLength += 1
    				return True
    		return False
    
    	def Clone(self):
    		return MyNumberValidator()
    
    	def Validate(self,win):#1 使用验证器方法
    		return True
    
    	def TransferToWindow(self):
    		return True
    
    	def TransferFromWindow(self):
    		return True

注意这行代码，`self.Bind(wx.EVT_CHAR,self.OnCharChanged) # 绑定字符输入事件`,它的意思是，一旦用户输入了字符，该事件会首先交给`OnCharChanged`方法处理，在`OnCharChanged`中，特别注意`event.Skip()`这行代码，它的意思是，过了合法性检验这一关，该事件可以继续传递了，可以交给将该字符加入 textctrl.value 并显示出来的函数处理；否则，事件就在`OnCharChanged`中被拦截了，不会显示出来，输入失败。

### 给控件 textctrl 绑定验证器子类。 ###

很简单，只需要在创建 textctrl 的时候加指定关键词参数

wx.TextCtrl(self,validator=MyNumberValidator(),style=wx.TE_CENTER)

`style=wx.TE_CENTER` 使输入字符居中

### 再说 Validate() 方法 ###

我们发现，`Validator` 类中和类名最相似的方法`Validate()`一直没有使用，其实这个方法是一般使用流程如下，先在 `Validate()` 方法中加上业务逻辑。

def Validate(self,win):#1 使用验证器方法
    		print(111)
    		textCtrl = self.GetWindow()
    		text = textCtrl.GetValue()
    		valid_text = ''
    		for i in text:
    			if i in self.ValidInput:
    				valid_text += i
    		textCtrl.SetValue(valid_text)
    		return True

然后在外部调用它验证合法性

self.n1.GetValidator().Validate(self.n1)

Validate()也可以验证合法性，只不过它不能处理输入事件，必须在输入完成后才能验证合法性，相当于“马后炮”的作用。

## 一个完整的例子 ##

![在这里插入图片描述][2019041214403353.gif]

# -*- coding: utf-8 -*-
    # author:           inspurer(月小水长)
    # pc_type           lenovo
    # create_time:      2019/4/12 13:37
    # file_name:        validator.py
    # github            https://github.com/inspurer
    # qq邮箱            2391527690@qq.com
    # 微信公众号         月小水长(ID: inspurer)
    
    
    import wx
    # import wx.lib.imagebrowser
    
    
    class MyNumberValidator(wx.Validator):# 创建验证器子类      
    	def __init__(self):
    		wx.Validator.__init__(self)
    		self.ValidInput = ['.','0','1','2','3','4','5','6','7','8','9']
    		self.StringLength = 0
    		self.Bind(wx.EVT_CHAR,self.OnCharChanged)  #  绑定字符输入事件
    
    	def OnCharChanged(self, event):
    		# 得到输入字符的 ASCII 码
    		keycode = event.GetKeyCode()
    		# 退格（ASCII 码 为8），删除一个字符。
    		if keycode == 8:
    			self.StringLength -= 1
    			# 事件继续传递
    			event.Skip()
    			return
    
    		# 把 ASII 码 转成字符
    		InputChar = chr(keycode)
    
    		if InputChar in self.ValidInput:
    			# 第一个字符为 .,非法，拦截该事件，不会成功输入
    			if InputChar == '.' and self.StringLength == 0:
    				return False
    			# 在允许输入的范围，继续传递该事件。
    			else:
    				event.Skip()
    				self.StringLength += 1
    				return True
    		return False
    
    	def Clone(self):
    		return MyNumberValidator()
    
    	def Validate(self,win):#1 使用验证器方法
    		print(111)
    		textCtrl = self.GetWindow()
    		text = textCtrl.GetValue()
    		valid_text = ''
    		for i in text:
    			if i in self.ValidInput:
    				valid_text += i
    		textCtrl.SetValue(valid_text)
    		return True
    
    	def TransferToWindow(self):
    		return True
    
    	def TransferFromWindow(self):
    		return True
    
    class GUI(wx.Frame):
    	def __init__(self,parent):
    		wx.Frame.__init__(self, parent=parent, title="wxPython开发实战",size=(400,300),style=wx.DEFAULT_FRAME_STYLE ^ wx.RESIZE_BORDER ^ wx.MAXIMIZE_BOX )
    		self.Center()
    
    		self.SetBackgroundColour('white')
    
    		font = wx.Font(16,wx.DECORATIVE, wx.NORMAL, wx.NORMAL)
    		self.n1 = wx.TextCtrl(self,validator=MyNumberValidator(),pos=(100,30),size=(180,45),style=wx.TE_CENTER)
    		self.n1.SetFont(font)
    		self.n1.SetBackgroundColour('#95ec69')
    		self.n1.SetHint('请输入第一个数字')
    
    		self.n2 = wx.TextCtrl(self,validator=MyNumberValidator(),pos=(100,100),size=(180,45),style=wx.TE_CENTER)
    		self.n2.SetFont(font)
    		self.n2.SetBackgroundColour('#95ec69')
    		self.n2.SetHint('请输入第二个数字')
    
    
    		self.config = wx.Button(self,label="验证输入框一的合法性",pos=(115,170),size=(150,40))
    		self.config.SetBackgroundColour('#95ec69')
    
    		self.Bind(wx.EVT_BUTTON,self.configClicked,self.config)
    
    	def configClicked(self,event):
    		self.n1.GetValidator().Validate(self.n1)
    		pass
    
    if __name__ == "__main__":
    	app = wx.App()
    	GUI(None).Show()
    	app.MainLoop()

[2019041214403353.gif]: /images/20220220/0d1a2140f1e145b183ce10eb40d4a649.png