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

这个事件类包含关于命令事件的信息,这些事件源自各种简单的控件。

请注意,wxCommandEvents 和 wxCommandEvent 派生的事件类默认情况下,与其它 wxEvent 派生的类不同,它们会从源窗口(发出事件的窗口)向上传播到第一个处理该事件的父窗口。请务必阅读 overview_events_propagation。

更复杂的控件,例如 wxTreeCtrl,有单独的命令事件类。

这个类是从以下类派生的,可以使用其函数:

wxWidgets 文档: wxCommandEvent

事件

使用 wxEvtHandler:connect/3wxCommandEventType 来订阅此类型的事件。

摘要

函数

返回列表框或选择框选择事件的客户端对象指针(对于取消选择无效)。

返回取决于事件对象类型的额外信息。

返回与列表框、选择框或单选框选择对应的整数标识符(仅当事件是选择而不是取消选择时),或表示复选框值的布尔值。

返回列表框或选择框选择事件的项目索引(对于取消选择无效)。

返回列表框或选择框选择事件的项目字符串。

此方法可以用于复选框和菜单事件:对于复选框,该方法在选择事件时返回 true,在取消选择事件时返回 false。

对于列表框或类似的事件,如果它是选择则返回 true,如果它是取消选择则返回 false。

设置 m_commandInt 成员。

设置 m_commandString 成员。

类型

-type wxCommand() ::
          #wxCommand{type :: wxCommandEvent:wxCommandEventType(),
                     cmdString :: unicode:chardata(),
                     commandInt :: integer(),
                     extraLong :: integer()}.
-type wxCommandEvent() :: wx:wx_object().
-type wxCommandEventType() ::
          command_button_clicked | command_checkbox_clicked | command_choice_selected |
          command_listbox_selected | command_listbox_doubleclicked | command_text_updated |
          command_text_enter | text_maxlen | command_menu_selected | command_slider_updated |
          command_radiobox_selected | command_radiobutton_selected | command_scrollbar_updated |
          command_vlbox_selected | command_combobox_selected | combobox_dropdown | combobox_closeup |
          command_tool_rclicked | command_tool_enter | tool_dropdown | command_checklistbox_toggled |
          command_togglebutton_clicked | command_left_click | command_left_dclick |
          command_right_click | command_set_focus | command_kill_focus | command_enter |
          notification_message_click | notification_message_dismissed | notification_message_action.

函数

-spec getClientData(This) -> term() when This :: wxCommandEvent().

返回列表框或选择框选择事件的客户端对象指针(对于取消选择无效)。

-spec getExtraLong(This) -> integer() when This :: wxCommandEvent().

返回取决于事件对象类型的额外信息。

如果事件来自列表框选择,则它是一个布尔值,确定事件是选择 (true) 还是取消选择 (false)。列表框取消选择仅发生在多选框中,在这种情况下,索引和字符串值是不确定的,应用程序必须检查列表框。

-spec getInt(This) -> integer() when This :: wxCommandEvent().

返回与列表框、选择框或单选框选择对应的整数标识符(仅当事件是选择而不是取消选择时),或表示复选框值的布尔值。

对于菜单项,如果该项不可选中,则此方法返回 -1,对于可选中项,则返回布尔值 (true 或 false) 表示该项的新状态。

-spec getSelection(This) -> integer() when This :: wxCommandEvent().

返回列表框或选择框选择事件的项目索引(对于取消选择无效)。

-spec getString(This) -> unicode:charlist() when This :: wxCommandEvent().

返回列表框或选择框选择事件的项目字符串。

如果一个或多个项目被取消选择,则返回第一个被取消选择的项目的索引。如果同时选择了一些项目并取消选择了一些项目,它将返回第一个被选择的项目的索引。

-spec isChecked(This) -> boolean() when This :: wxCommandEvent().

此方法可以用于复选框和菜单事件:对于复选框,该方法在选择事件时返回 true,在取消选择事件时返回 false。

对于菜单事件,此方法指示菜单项是否刚刚被选中或取消选中(因此仅对可选中菜单项有意义)。

请注意,目前此方法不能与 wxCheckListBox 一起使用。

-spec isSelection(This) -> boolean() when This :: wxCommandEvent().

对于列表框或类似的事件,如果它是选择则返回 true,如果它是取消选择则返回 false。

如果同时选择了一些项目并取消选择了一些项目,它将返回 true。

链接到此函数

setInt(This, IntCommand)

查看源代码
-spec setInt(This, IntCommand) -> ok when This :: wxCommandEvent(), IntCommand :: integer().

设置 m_commandInt 成员。

链接到此函数

setString(This, String)

查看源代码
-spec setString(This, String) -> ok when This :: wxCommandEvent(), String :: unicode:chardata().

设置 m_commandString 成员。