查看源代码 wxRadioButton (wx v2.4.3)

单选按钮是一种按钮，通常表示几个互斥选项中的一个。

它在（通常）圆形按钮旁边有一个文本标签。

您可以通过为组中的第一个单选按钮指定 wxRB_GROUP 来创建一组互斥的单选按钮。当创建另一个单选按钮组或没有更多单选按钮时，该组结束。

样式

此类支持以下样式

wxRB_GROUP：标记新的单选按钮组的开始。
wxRB_SINGLE：在某些情况下，非连续同级的单选按钮会在 Windows (仅限) 中触发挂起错误。如果发生这种情况，请添加此样式以将该按钮标记为不属于任何组，并自行实现互斥组的行为。

参见

此类派生自以下类，并可以使用其函数：

wxWidgets 文档：wxRadioButton

事件

从此类发出的事件类型

command_radiobutton_selected

摘要

类型

wxRadioButton()

函数

create(This, Parent, Id, Label)

等同于 create(This, Parent, Id, Label, [])。

create/5

创建用于两步构造的选择。

destroy(This)

销毁对象

getValue(This)

如果选中单选按钮，则返回 true，否则返回 false。

new()

默认构造函数。

new(Parent, Id, Label)

等同于 new(Parent, Id, Label, [])。

new/4

构造函数，创建并显示单选按钮。

setValue(This, Value)

将单选按钮设置为选中或未选中状态。

类型

wxRadioButton()

-type wxRadioButton() :: wx:wx_object().

函数

create(This, Parent, Id, Label)

-spec create(This, Parent, Id, Label) -> boolean()
                when
                    This :: wxRadioButton(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Label :: unicode:chardata().

等同于 create(This, Parent, Id, Label, [])。

create/5

-spec create(This, Parent, Id, Label, [Option]) -> boolean()
                when
                    This :: wxRadioButton(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Label :: unicode:chardata(),
                    Option ::
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()} |
                        {validator, wx:wx_object()}.

创建用于两步构造的选择。

有关详细信息，请参阅 new/4。

destroy(This)

-spec destroy(This :: wxRadioButton()) -> ok.

销毁对象

getValue(This)

-spec getValue(This) -> boolean() when This :: wxRadioButton().

如果选中单选按钮，则返回 true，否则返回 false。

new()

-spec new() -> wxRadioButton().

默认构造函数。

请参阅：create/5

new(Parent, Id, Label)

-spec new(Parent, Id, Label) -> wxRadioButton()
             when Parent :: wxWindow:wxWindow(), Id :: integer(), Label :: unicode:chardata().

等同于 new(Parent, Id, Label, [])。

new/4

-spec new(Parent, Id, Label, [Option]) -> wxRadioButton()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Label :: unicode:chardata(),
                 Option ::
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {validator, wx:wx_object()}.

构造函数，创建并显示单选按钮。

请参阅：create/5

setValue(This, Value)

-spec setValue(This, Value) -> ok when This :: wxRadioButton(), Value :: boolean().

将单选按钮设置为选中或未选中状态。

这不会导致发出 wxEVT_RADIOBUTTON 事件。

如果单选按钮属于一个单选组，则该组中只有一个按钮可以被选中，因此此方法只能在 value 设置为 true 的情况下调用。要取消选中组中的单选按钮，必须选中同一组中的另一个按钮。

注意：在 MSW 下，获得焦点的单选按钮始终处于选中状态，即其值为 true。反之，调用 SetValue(true) 也会将焦点设置到单选按钮，如果焦点先前位于同一组中的另一个单选按钮上 - 因为否则设置它将不起作用。