查看源码 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().
函数
-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()}.
启用或禁用单选框。
-spec enable(This, N, [Option]) -> boolean() when This :: wxRadioBox(), N :: integer(), Option :: {enable, boolean()}.
启用或禁用单选框中的单个按钮。
-spec getColumnCount(This) -> integer() when This :: wxRadioBox().
返回单选框中的列数。
-spec getItemFromPoint(This, Pt) -> integer() when This :: wxRadioBox(), Pt :: {X :: integer(), Y :: integer()}.
返回点下的单选框项,一个从零开始的项索引,如果点下没有项,则返回 wxNOT_FOUND
。
-spec getItemHelpText(This, Item) -> unicode:charlist() when This :: wxRadioBox(), Item :: integer().
返回与指定的 item
关联的帮助文本(如果有),否则返回 wxEmptyString
。
-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().
返回具有给定索引的项的标签。
返回:项的标签,如果位置无效,则返回空字符串。
-spec isItemEnabled(This, N) -> boolean() when This :: wxRadioBox(), N :: integer().
如果该项已启用,则返回 true;如果使用 enable/3
禁用,则返回 false。
此函数当前仅在 wxMSW、wxGTK、wxQT 和 wxUniversal 中实现,并且在其他端口中始终返回 true。
-spec isItemShown(This, N) -> boolean() when This :: wxRadioBox(), N :: integer().
如果该项当前显示,则返回 true;如果使用 show/3
隐藏,则返回 false。
请注意,即使整个单选框当前未显示,此函数也会为未隐藏的项返回 true。
此函数当前仅在 wxMSW、wxGTK、wxQT 和 wxUniversal 中实现,并且在其他端口中始终返回 true。
-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()].
-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
-spec setItemHelpText(This, Item, Helptext) -> ok when This :: wxRadioBox(), Item :: integer(), Helptext :: unicode:chardata().
设置项的帮助文本。
空字符串会删除任何现有的帮助文本。
-spec setItemToolTip(This, Item, Text) -> ok when This :: wxRadioBox(), Item :: integer(), Text :: unicode:chardata().
设置单选组中指定项的工具提示文本。
此函数当前仅在 wxMSW 和 wxGTK2 中实现,在其他端口中不执行任何操作。
参见
-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