查看源代码 wxCommandEvent (wx v2.4.3)
这个事件类包含关于命令事件的信息,这些事件源自各种简单的控件。
请注意,wxCommandEvents 和 wxCommandEvent 派生的事件类默认情况下,与其它 wxEvent 派生的类不同,它们会从源窗口(发出事件的窗口)向上传播到第一个处理该事件的父窗口。请务必阅读 overview_events_propagation。
更复杂的控件,例如 wxTreeCtrl
,有单独的命令事件类。
这个类是从以下类派生的,可以使用其函数:
wxWidgets 文档: wxCommandEvent
事件
使用 wxEvtHandler:connect/3
和 wxCommandEventType
来订阅此类型的事件。
摘要
函数
返回列表框或选择框选择事件的客户端对象指针(对于取消选择无效)。
返回取决于事件对象类型的额外信息。
返回与列表框、选择框或单选框选择对应的整数标识符(仅当事件是选择而不是取消选择时),或表示复选框值的布尔值。
返回列表框或选择框选择事件的项目索引(对于取消选择无效)。
返回列表框或选择框选择事件的项目字符串。
此方法可以用于复选框和菜单事件:对于复选框,该方法在选择事件时返回 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。
-spec setInt(This, IntCommand) -> ok when This :: wxCommandEvent(), IntCommand :: integer().
设置 m_commandInt
成员。
-spec setString(This, String) -> ok when This :: wxCommandEvent(), String :: unicode:chardata().
设置 m_commandString
成员。