檢視原始碼 wxRadioBox (wx v2.4.3)
單選框項目用於選擇數個互斥選項中的一個。
它以標籤按鈕的垂直列或水平行顯示。
樣式
此類別支援以下樣式
wxRA_SPECIFY_ROWS：主要尺寸參數指的是最大行數。
wxRA_SPECIFY_COLS：主要尺寸參數指的是最大列數。
參閱
此類別繼承自以下類別，並可使用以下類別中的函式：
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