wx.CheckBox (wxPython) | Python-izm

CheckBox

本項ではCheckBoxを扱います。GUIアプリケーションではかなりの頻度で使用され複数の選択肢の中から該当するものを１つ以上選択するケースで利用します。

基本的な使い方

パネルへチェックボックスを追加しています。引数には(親ウィンドウ、識別子、ラベル)の順番で渡しています。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３')
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４')
checkbox_5 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス５')
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
layout.Add(checkbox_5, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

ラベル設定

先程のサンプルでは初期化時の引数にてラベル（チェックボックスに表示される文字）を指定していました。当然ラベルを変更するメソッドも用意されています。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３')
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４')
checkbox_5 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス５')
 
checkbox_3.SetLabel('CheckBox3')
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
layout.Add(checkbox_5, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

checkbox_3のラベルがチェックボックス３ではなくCheckBox3となりました。

有効・無効設定

チェックボックスを無効（ステートの変更が出来ない状態）にするにはDisableを使用します。それとは逆に無効状態となっているチェックボックスを有効（ステートの変更が出来る状態）へ変更するにはEnableを使用しましょう。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３')
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４')
checkbox_5 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス５')
 
checkbox_3.Disable()
# checkbox_3.Enable()
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
layout.Add(checkbox_5, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

チェックボックス３が押せない状態となっています。

ツールチップ設定

チェックボックスへツールチップ（補足情報を載せる小さいウィンドウ）を表示させるにはSetToolTipを使用します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３')
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４')
checkbox_5 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス５')
 
checkbox_3.SetToolTip('python-izm.com')
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
layout.Add(checkbox_5, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

チェックボックス３の上にマウスカーソルを載せると、メッセージが出るようになります。

イベント設定

チェックボックスへイベントを設定するにはBindを使用します。引数には(イベント種別、イベント発生時に呼び出す関数）の順番で値を渡しチェックボックス１とチェックボックス２ではそれぞれ違う関数を定義してイベント設定しています。チェックボックス３とチェックボックス４では、引数にイベント発生元を追加し、チェックボックス初期化時のIDで判別して挙動を変えています。なおサンプルでもあるように、チェックボックス・フレームのどちらにBindしてもイベントはきちんと動作します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
import wx
 
def state_change_checkbox_1(event):
    frame.SetStatusText('StateChange! checkbox_1')
 
def state_change_checkbox_2(event):
    frame.SetStatusText('StateChange! checkbox_2')
 
def state_change_checkbox(event):
    if event.GetId() == 3333:
        frame.SetStatusText('StateChange! checkbox_3')
    elif event.GetId() == 4444:
        frame.SetStatusText('StateChange! checkbox_4')
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
frame.CreateStatusBar()
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, 3333, 'チェックボックス３')
checkbox_4 = wx.CheckBox(panel, 4444, 'チェックボックス４')
 
checkbox_1.Bind(wx.EVT_CHECKBOX, state_change_checkbox_1)
checkbox_2.Bind(wx.EVT_CHECKBOX, state_change_checkbox_2)
frame.Bind(wx.EVT_CHECKBOX, state_change_checkbox, checkbox_3)
frame.Bind(wx.EVT_CHECKBOX, state_change_checkbox, checkbox_4)
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

チェックボックスのステートを変更すると、ステータスバーにそれぞれ違ったメッセージが入ります。

ステートの設定・取得

チェックボックスのステート（選択状態）の設定はSetValueを使用します。GetValueもしくはIsCheckedを使用すると、ステートの取得を行う事が出来ます。設定・取得どちらのケースでもTrueがチェックが付いている状態で、Falseがチェックの付いていない状態となります。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３')
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４')
 
checkbox_1.SetValue(True)
checkbox_2.SetValue(True)
checkbox_3.SetValue(False)
checkbox_4.SetValue(False)
 
print(checkbox_1.GetValue())
print(checkbox_2.IsChecked())
print(checkbox_3.GetValue())
print(checkbox_4.IsChecked())
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

出力されるステートは、上からTrue、True、False、Falseとなります。

３ステートチェックボックス

近年のGUIアプリケーションでもしばしば見られるような、３つのステート（チェックなし・チェックあり・中間）を保持出来るチェックボックスも使用可能です。デフォルトでは２ステートチェックボックスなので、必要に応じて使い分けましょう。なお３ステートチェックボックスには２つのモードが存在するので違いを記載しておきます。

  • wx.CHK_3STATEのみを指定した場合
    • プログラム上では３つのステートを設定可能、ユーザー側はチェックなし・チェックありのみ設定可能。
  • wx.CHK_3STATEとwx.CHK_ALLOW_3RD_STATE_FOR_USERを指定した場合
    • プログラム上でもユーザー側でも３つのステートが利用可能。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２')
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３',
                         style=wx.CHK_3STATE)
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４',
                         style=wx.CHK_3STATE | wx.CHK_ALLOW_3RD_STATE_FOR_USER)
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

チェックボックス３はクリックしてもチェックなしとチェックありのみで中間ステートが出現しません（プログラム上では設定可能）。中間はチェックボックス４のような形で表現されます。

ステートの設定・取得（３ステート）

３ステートチェックボックスでは、ステートの設定・取得方法が２ステートチェックボックスとは異なります。チェックなしが0、チェックありが1、中間が2で判別されるので注意しましょう。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import wx
 
application = wx.App()
frame = wx.Frame(None, wx.ID_ANY, 'テストフレーム', size=(300, 200))
 
panel = wx.Panel(frame, wx.ID_ANY)
panel.SetBackgroundColour('#AFAFAF')
 
checkbox_1 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス１')
checkbox_2 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス２',
                         style=wx.CHK_3STATE)
checkbox_3 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス３',
                         style=wx.CHK_3STATE)
checkbox_4 = wx.CheckBox(panel, wx.ID_ANY, 'チェックボックス４',
                         style=wx.CHK_3STATE | wx.CHK_ALLOW_3RD_STATE_FOR_USER)
 
checkbox_2.Set3StateValue(0)
checkbox_3.Set3StateValue(1)
checkbox_4.Set3StateValue(2)
 
# print(checkbox_1.Get3StateValue())
print(checkbox_2.Get3StateValue())
print(checkbox_3.Get3StateValue())
print(checkbox_4.Get3StateValue())
 
layout = wx.BoxSizer(wx.VERTICAL)
layout.Add(checkbox_1, flag=wx.GROW)
layout.Add(checkbox_2, flag=wx.GROW)
layout.Add(checkbox_3, flag=wx.GROW)
layout.Add(checkbox_4, flag=wx.GROW)
 
panel.SetSizer(layout)
 
frame.Show()
application.MainLoop()

旧バージョンのwxPythonでは、３ステートではないチェックボックスに対してSet3StateValueやGet3StateValueを実行すると、エラーになってしまうので注意しましょう。出力されるステートは、上から0、1、2となります。