檢視原始碼 wxSpinCtrl (wx v2.4.3)

wxSpinCtrl 結合了 wxTextCtrl 和 wxSpinButton 在一個控制項中。

樣式

這個類別支援以下樣式

wxSP_ARROW_KEYS: 使用者可以使用方向鍵來變更數值。
wxSP_WRAP: 數值會在最小值和最大值之間循環。
wxTE_PROCESS_ENTER: 表示控制項應產生 wxEVT_TEXT_ENTER 事件。在 MSW 下使用此樣式將會阻止使用者使用 Enter 鍵進行對話方塊導覽 (例如，啟動對話方塊中的預設按鈕)。
wxALIGN_LEFT: 與 wxTextCtrl 的 wxTE_LEFT 相同：文字靠左對齊 (這是預設值)。
wxALIGN_CENTRE_HORIZONTAL: 與 wxTextCtrl 的 wxTE_CENTRE 相同：文字置中對齊。
wxALIGN_RIGHT: 與 wxTextCtrl 的 wxTE_RIGHT 相同：文字靠右對齊。

請參閱

這個類別繼承自，並可以使用以下類別的功能：

wxWidgets 文件: wxSpinCtrl

事件

這個類別發出的事件類型

command_spinctrl_updated

摘要

類型

wxSpinCtrl()

函式

create(This, Parent)

等同於 create(This, Parent, [])。

create/3

由旋轉控制項建構子呼叫的建立函式。

destroy(This)

銷毀物件

getMax(This)

取得允許的最大值。

getMin(This)

取得允許的最小值。

getValue(This)

取得旋轉控制項的值。

new()

預設建構子。

new(Parent)

等同於 new(Parent, [])。

new/2

建構子，建立並顯示旋轉控制項。

setRange(This, MinVal, MaxVal)

設定允許值的範圍。

setSelection(This, From, To)

選取控制項文字部分中，位置 from (包含) 和 to (不包含) 之間的文字。

setValue/2

設定旋轉控制項的值。

類型

wxSpinCtrl()

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

函式

create(This, Parent)

-spec create(This, Parent) -> boolean() when This :: wxSpinCtrl(), Parent :: wxWindow:wxWindow().

等同於 create(This, Parent, [])。

create/3

-spec create(This, Parent, [Option]) -> boolean()
                when
                    This :: wxSpinCtrl(),
                    Parent :: wxWindow:wxWindow(),
                    Option ::
                        {id, integer()} |
                        {value, unicode:chardata()} |
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()} |
                        {min, integer()} |
                        {max, integer()} |
                        {initial, integer()}.

由旋轉控制項建構子呼叫的建立函式。

詳細資訊請參閱 new/2。

destroy(This)

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

銷毀物件

getMax(This)

-spec getMax(This) -> integer() when This :: wxSpinCtrl().

取得允許的最大值。

getMin(This)

-spec getMin(This) -> integer() when This :: wxSpinCtrl().

取得允許的最小值。

getValue(This)

-spec getValue(This) -> integer() when This :: wxSpinCtrl().

取得旋轉控制項的值。

new()

-spec new() -> wxSpinCtrl().

預設建構子。

new(Parent)

-spec new(Parent) -> wxSpinCtrl() when Parent :: wxWindow:wxWindow().

等同於 new(Parent, [])。

new/2

-spec new(Parent, [Option]) -> wxSpinCtrl()
             when
                 Parent :: wxWindow:wxWindow(),
                 Option ::
                     {id, integer()} |
                     {value, unicode:chardata()} |
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {min, integer()} |
                     {max, integer()} |
                     {initial, integer()}.

建構子，建立並顯示旋轉控制項。

如果 value 非空，它將顯示在控制項的文字輸入部分，如果它具有數值，則控制項的初始數值 (由 getValue/1 傳回) 也將由它決定，而不是由 initial 決定。因此，只有當 value 是空字串或無法轉換為數字時，指定 initial 才有意義，否則 initial 將被忽略，並且使用 value 指定的數字。

請參閱：create/3

setRange(This, MinVal, MaxVal)

-spec setRange(This, MinVal, MaxVal) -> ok
                  when This :: wxSpinCtrl(), MinVal :: integer(), MaxVal :: integer().

設定允許值的範圍。

請注意，如果控制項的值不在新的有效範圍內，則呼叫此方法可能會變更控制項的值，例如，如果它現在小於 minVal，則會變成 minVal。但是，即使值確實發生變更，也不會產生 wxEVT_SPINCTRL 事件。

注意：如果目前基礎設定為 16，則設定包含負值的範圍將被靜默忽略。

setSelection(This, From, To)

-spec setSelection(This, From, To) -> ok when This :: wxSpinCtrl(), From :: integer(), To :: integer().

選取控制項文字部分中，位置 from (包含) 和 to (不包含) 之間的文字。

這與 wxTextCtrl:setSelection/3 類似。

注意：目前僅針對 Windows 和控制項的通用版本實作此功能。

setValue/2

-spec setValue(This, Value) -> ok when This :: wxSpinCtrl(), Value :: integer();
              (This, Text) -> ok when This :: wxSpinCtrl(), Text :: unicode:chardata().

設定旋轉控制項的值。

建議使用接受整數值的多載版本。

請注意，與 wxTextCtrl:setValue/2 不同，但與 wxWidgets 中大多數其他設定方法類似，呼叫此方法不會產生任何事件，因為事件僅針對使用者動作產生。