查看源码 wxRadioBox (wx v2.4.3)

单选框项用于选择多个互斥选项中的一个。

它以标签按钮的垂直列或水平行的形式显示。

样式

此类支持以下样式

  • wxRA_SPECIFY_ROWS: major dimension 参数指的是最大行数。

  • wxRA_SPECIFY_COLS: major dimension 参数指的是最大列数。

参见

此类派生自以下类,并可以使用其函数:

wxWidgets 文档: wxRadioBox

事件

此类发出的事件类型

摘要

函数

创建用于两步构造的单选框。

销毁对象

启用或禁用单选框。

启用或禁用单选框中的单个按钮。

返回单选框中的列数。

返回点下的单选框项,一个从零开始的项索引,如果点下没有项,则返回 wxNOT_FOUND

返回与指定的 item 关联的帮助文本(如果有),否则返回 wxEmptyString

返回与指定的 item 关联的工具提示(如果有),否则返回 NULL。

返回单选框中的行数。

返回所选项的索引,如果没有选择任何项,则返回 wxNOT_FOUND

返回具有给定索引的项的标签。

如果该项已启用,则返回 true;如果使用 enable/3 禁用,则返回 false。

如果该项当前显示,则返回 true;如果使用 show/3 隐藏,则返回 false。

构造函数,创建并显示单选框。

设置项的帮助文本。

设置单选组中指定项的工具提示文本。

将选择设置为给定项。

显示或隐藏单个按钮。

类型

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

函数

链接到此函数

create(This, Parent, Id, Label, Pos, Size, Choices)

查看源码
-spec create(This, Parent, Id, Label, Pos, Size, Choices) -> boolean()
                when
                    This :: wxRadioBox(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Label :: unicode:chardata(),
                    Pos :: {X :: integer(), Y :: integer()},
                    Size :: {W :: integer(), H :: integer()},
                    Choices :: [unicode:chardata()].

等同于 create(This, Parent, Id, Label, Pos, Size, Choices, [])

-spec create(This, Parent, Id, Label, Pos, Size, Choices, [Option]) -> boolean()
                when
                    This :: wxRadioBox(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Label :: unicode:chardata(),
                    Pos :: {X :: integer(), Y :: integer()},
                    Size :: {W :: integer(), H :: integer()},
                    Choices :: [unicode:chardata()],
                    Option :: {majorDim, integer()} | {style, integer()} | {val, wx:wx_object()}.

创建用于两步构造的单选框。

有关更多详细信息,请参见 new/7

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

销毁对象

-spec enable(This) -> boolean() when This :: wxRadioBox().

等同于 enable(This, [])

-spec enable(This, N) -> boolean() when This :: wxRadioBox(), N :: integer();
            (This, [Option]) -> boolean() when This :: wxRadioBox(), Option :: {enable, boolean()}.

启用或禁用单选框。

参见: wxWindow:enable/2

-spec enable(This, N, [Option]) -> boolean()
                when This :: wxRadioBox(), N :: integer(), Option :: {enable, boolean()}.

启用或禁用单选框中的单个按钮。

参见: wxWindow:enable/2

链接到此函数

getColumnCount(This)

查看源码
-spec getColumnCount(This) -> integer() when This :: wxRadioBox().

返回单选框中的列数。

链接到此函数

getItemFromPoint(This, Pt)

查看源码
-spec getItemFromPoint(This, Pt) -> integer()
                          when This :: wxRadioBox(), Pt :: {X :: integer(), Y :: integer()}.

返回点下的单选框项,一个从零开始的项索引,如果点下没有项,则返回 wxNOT_FOUND

链接到此函数

getItemHelpText(This, Item)

查看源码
-spec getItemHelpText(This, Item) -> unicode:charlist() when This :: wxRadioBox(), Item :: integer().

返回与指定的 item 关联的帮助文本(如果有),否则返回 wxEmptyString

参见: setItemHelpText/3

链接到此函数

getItemToolTip(This, Item)

查看源码
-spec getItemToolTip(This, Item) -> wxToolTip:wxToolTip() when This :: wxRadioBox(), Item :: integer().

返回与指定的 item 关联的工具提示(如果有),否则返回 NULL。

参见

-spec getRowCount(This) -> integer() when This :: wxRadioBox().

返回单选框中的行数。

-spec getSelection(This) -> integer() when This :: wxRadioBox().

返回所选项的索引,如果没有选择任何项,则返回 wxNOT_FOUND

返回:当前选择的位置。

备注:此方法只能用于单选列表框,对于具有 wxLB_MULTIPLE 样式的列表框,应使用 wxListBox:getSelections/1

参见

-spec getString(This, N) -> unicode:charlist() when This :: wxRadioBox(), N :: integer().

返回具有给定索引的项的标签。

返回:项的标签,如果位置无效,则返回空字符串。

链接到此函数

isItemEnabled(This, N)

查看源码
-spec isItemEnabled(This, N) -> boolean() when This :: wxRadioBox(), N :: integer().

如果该项已启用,则返回 true;如果使用 enable/3 禁用,则返回 false。

此函数当前仅在 wxMSW、wxGTK、wxQT 和 wxUniversal 中实现,并且在其他端口中始终返回 true。

链接到此函数

isItemShown(This, N)

查看源码
-spec isItemShown(This, N) -> boolean() when This :: wxRadioBox(), N :: integer().

如果该项当前显示,则返回 true;如果使用 show/3 隐藏,则返回 false。

请注意,即使整个单选框当前未显示,此函数也会为未隐藏的项返回 true。

此函数当前仅在 wxMSW、wxGTK、wxQT 和 wxUniversal 中实现,并且在其他端口中始终返回 true。

链接到此函数

new(Parent, Id, Label, Pos, Size, Choices)

查看源码
-spec new(Parent, Id, Label, Pos, Size, Choices) -> wxRadioBox()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Label :: unicode:chardata(),
                 Pos :: {X :: integer(), Y :: integer()},
                 Size :: {W :: integer(), H :: integer()},
                 Choices :: [unicode:chardata()].

等同于 new(Parent, Id, Label, Pos, Size, Choices, [])

-spec new(Parent, Id, Label, Pos, Size, Choices, [Option]) -> wxRadioBox()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Label :: unicode:chardata(),
                 Pos :: {X :: integer(), Y :: integer()},
                 Size :: {W :: integer(), H :: integer()},
                 Choices :: [unicode:chardata()],
                 Option :: {majorDim, integer()} | {style, integer()} | {val, wx:wx_object()}.

构造函数,创建并显示单选框。

参见: create/8

链接到此函数

setItemHelpText(This, Item, Helptext)

查看源码
-spec setItemHelpText(This, Item, Helptext) -> ok
                         when This :: wxRadioBox(), Item :: integer(), Helptext :: unicode:chardata().

设置项的帮助文本。

空字符串会删除任何现有的帮助文本。

参见: getItemHelpText/2

链接到此函数

setItemToolTip(This, Item, Text)

查看源码
-spec setItemToolTip(This, Item, Text) -> ok
                        when This :: wxRadioBox(), Item :: integer(), Text :: unicode:chardata().

设置单选组中指定项的工具提示文本。

此函数当前仅在 wxMSW 和 wxGTK2 中实现,在其他端口中不执行任何操作。

参见

链接到此函数

setSelection(This, N)

查看源码
-spec setSelection(This, N) -> ok when This :: wxRadioBox(), N :: integer().

将选择设置为给定项。

请注意,单选框始终有选择,因此 n 在这里必须有效,并且不允许传递 wxNOT_FOUND

-spec show(This, Item) -> boolean() when This :: wxRadioBox(), Item :: integer().

等同于 show(This, Item, [])

-spec show(This, Item, [Option]) -> boolean()
              when This :: wxRadioBox(), Item :: integer(), Option :: {show, boolean()}.

显示或隐藏单个按钮。

返回:如果该项已显示或隐藏,则返回 true;如果由于该项已处于请求状态而未执行任何操作,则返回 false。

参见: show/3