查看源代码 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。然而，即使值确实发生了变化，也不会生成 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 中的大多数其他 setter 方法一样，调用此方法不会生成任何事件，因为事件仅针对用户操作生成。