查看源代码 wxSpinButton (wx v2.4.3)

wxSpinButton 有两个小的向上和向下(或向左和向右)箭头按钮。

它通常与文本控件一起使用,用于递增和递减值。可移植的程序应尝试使用 wxSpinCtrl,因为 wxSpinButton 并非在所有平台上都实现,但 wxSpinCtrl 是实现的,因为它会在这些平台上退化为一个简单的 wxTextCtrl

注意:此控件(以及 wxSpinCtrl)支持的范围取决于平台,但至少为 -0x80000x7fff。在 GTK 和 Win32 下,使用足够新版本的 comctrl32.dll(至少需要 4.71,建议使用 5.80),则支持完整的 32 位范围。

样式

此类支持以下样式

  • wxSP_HORIZONTAL: 指定一个水平微调按钮(请注意,此样式在 wxGTK 中不受支持)。

  • wxSP_VERTICAL: 指定一个垂直微调按钮。

  • wxSP_ARROW_KEYS: 用户可以使用箭头键更改值。

  • wxSP_WRAP: 值在最小值和最大值处循环。

请参阅:wxSpinCtrl

此类派生自以下类,并且可以使用以下类中的函数:

wxWidgets 文档:wxSpinButton

事件

此类发出的事件类型

摘要

函数

由微调按钮构造函数调用的滚动条创建函数。

销毁对象

返回允许的最大值。

返回允许的最小值。

返回当前微调按钮的值。

默认构造函数。

构造函数,创建并显示一个微调按钮。

设置微调按钮的范围。

设置微调按钮的值。

类型

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

函数

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

等效于 create(This, Parent, [])

-spec create(This, Parent, [Option]) -> boolean()
                when
                    This :: wxSpinButton(),
                    Parent :: wxWindow:wxWindow(),
                    Option ::
                        {id, integer()} |
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()}.

由微调按钮构造函数调用的滚动条创建函数。

有关详细信息,请参阅 new/2

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

销毁对象

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

返回允许的最大值。

请参阅:setRange/3

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

返回允许的最小值。

请参阅:setRange/3

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

返回当前微调按钮的值。

请参阅:setValue/2

-spec new() -> wxSpinButton().

默认构造函数。

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

等效于 new(Parent, [])

-spec new(Parent, [Option]) -> wxSpinButton()
             when
                 Parent :: wxWindow:wxWindow(),
                 Option ::
                     {id, integer()} |
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()}.

构造函数,创建并显示一个微调按钮。

请参阅:create/3

链接到此函数

setRange(This, Min, Max)

查看源代码
-spec setRange(This, Min, Max) -> ok when This :: wxSpinButton(), Min :: integer(), Max :: integer().

设置微调按钮的范围。

在可移植的代码中,min 应小于或等于 max。在 wxMSW 中,可以指定最小值大于最大值,并且本地控件支持与反转时相同的范围,但会交换向上和向下箭头的含义,但是此可疑的功能在其他平台上不受支持。

请参阅

-spec setValue(This, Value) -> ok when This :: wxSpinButton(), Value :: integer().

设置微调按钮的值。