实战wxPython：030 - 基本控件之单选按钮RadioButton

单选按钮(RadioButton)也是GUI程序中非常常见的一种控件，通常用于表示几个互斥选项之一的按钮。在wxPython中，实现单选按钮的类为wx.RadioButton。

一、wx.RadioButton简介

wx.RadioButton最常见的外观是在圆形按钮旁有一个文字标签。单选按钮通常用于互斥按钮组中，即组中只有一个按钮被选中，而其他按钮则自动未选中。这样的组是隐式创建的，但也可以通过使用RB_GROUP样式显式启动，具有这种样式的按钮将启动一个新组，并将成为该组中的初始选择。另一方面，单选按钮可以通过使用RB_SINGLE样式从它原本属于的组中排除。

可以使用GetFirstGroup, GetPreviousInGroup, GetNextInGroup和GetLastInGroup函数来找到同一单选按钮组的其他元素。

wx.RadioButton支持以下窗口样式：

• wx.RB_GROUP：标志一组新单选按钮的开始。
• wx.RB_SINGLE：创建一个不属于任何单选按钮组的单选按钮。在使用此样式时，当此按钮打开时，不会自动关闭其他单选按钮，如果要关闭其他单选按钮则需要在此按钮的事件处理程序中手动实现。

wx.RadioButton常用的方法有：

• GetFirstInGroup(self)：返回单选按钮组所属的第一个按钮。对于RB_SINGLE样式的单选按钮，该函数返回该按钮本身，因为它是该组中唯一的成员。否则，该函数返回最近的RB_GROUP样式单选按钮(仍然可以是该按钮本身)或同一窗口中的第一个单选按钮。
• GetLastInGroup(self)：返回单选按钮组所属的最后一个按钮。与GetFirstInGroup类似，如果按钮具有RB_SINGLE样式，则此函数返回该按钮本身。否则，该函数返回RB_GROUP样式的下一个按钮之前的最后一个按钮或同一窗口中的最后一个单选按钮。
• GetNextInGroup(self)：返回同一组中的下一个单选按钮。如果没有后续按钮或该按钮具有RB_SINGLE样式，则返回值为None。
• GetPreviousInGroup(self)：返回同一组中的上一个单选按钮。如果没有前一个按钮，或者该按钮具有RB_SINGLE样式，则返回值为None。
• GetValue(self)：如果单选按钮被选中，则返回True，否则返回False。
• SetValue(self, value)：将单选按钮设置为选中或未选中状态。它不会导致触发wxEVT_RADIOBUTTON事件。如果单选按钮属于一个单选组，则该组中只有一个按钮可以被选中，因此此方法只能在值设置为True时调用。要取消选中组中的单选按钮，必须选中同一组中的另一个按钮。

 图1. wx.RadioButton类继承关系

二、wx.RadioButton 演示

下面的代码演示如何使用wx.RadioButton。

#复选按钮(wx.RadioButton)

import wx
import os

class SampleRadioButton(wx.Frame):

    def __init__(self, *args, **kw):
        super(SampleRadioButton, self).__init__(*args, **kw)

        self.InitUi()

    def InitUi(self):
        #设置标题
        self.SetTitle("实战wxPython: RadioButton演示")
        #设置窗口尺寸
        self.SetSize(400, 300)

        panel = wx.Panel(self)

        light_on = wx.RadioButton(panel, label="开灯", pos = (10, 10));
        light_on.Bind(wx.EVT_RADIOBUTTON, self.OnLightOn)
        
        light_off = wx.RadioButton(panel, label="关灯", pos = (60, 10));
        light_off.Bind(wx.EVT_RADIOBUTTON, self.OnLightOff)

        self.bmpOn = wx.Image(os.path.dirname(__file__) + "/light_on.png", wx.BITMAP_TYPE_PNG).ConvertToBitmap()
        self.bmpOff = wx.Image(os.path.dirname(__file__) + "/light_off.png", wx.BITMAP_TYPE_PNG).ConvertToBitmap()

        self.stcLight = wx.StaticBitmap(panel, wx.ID_ANY, self.bmpOn, pos = (100, 20), size = (256, 256))

        self.Centre()

    def OnLightOn(self, e):
        sender = e.GetEventObject()
        if sender.GetValue():
            self.stcLight.SetBitmap(self.bmpOn)
        else:
            self.stcLight.SetBitmap(self.bmpOff)       

    def OnLightOff(self, e):
        sender = e.GetEventObject()
        if sender.GetValue():
            self.stcLight.SetBitmap(self.bmpOff)
        else:
            self.stcLight.SetBitmap(self.bmpOn)

def main():
    app = wx.App()
    sample = SampleRadioButton(None)
    sample.Show()
    app.MainLoop()

if __name__ == "__main__":
    main()

在上述代码中，我们在窗口中加入了两个wx.RadioButton，一个命名为” 开灯”, 一个命名为”关灯”, 然后添加了一个wx.StaticBitmap控件，通过设置不同的图片来显示开灯和关灯状态。

当我们点击”开灯”按钮时，运行结果如图2。

 图2：wx.RadioButton演示，开灯状态

当我们点击”关灯”按钮时，运行结果如图3。

 图2：wx.RadioButton演示，关灯状态

三、本文知识点

• 了解和使用wx.RadioButton。
• 了解wx.StaticBitmap。

---

前一篇：实战wxPython：029 - 基本控件之复选框CheckBox