wxruby3 0.9.2-x64-mingw-ucrt → 0.9.3-x64-mingw-ucrt
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/INSTALL.md +35 -29
- data/README.md +24 -15
- data/ext/wxbase32u_gcc_custom.dll +0 -0
- data/ext/wxbase32u_net_gcc_custom.dll +0 -0
- data/ext/wxbase32u_xml_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_aui_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_core_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_gl_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_html_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_media_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_propgrid_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_qa_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_ribbon_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_richtext_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_stc_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_webview_gcc_custom.dll +0 -0
- data/ext/wxmsw32u_xrc_gcc_custom.dll +0 -0
- data/lib/wx/core/bitmap_combobox.rb +17 -21
- data/lib/wx/core/combobox.rb +13 -3
- data/lib/wx/core/controlwithitems.rb +40 -130
- data/lib/wx/core/enum.rb +17 -1
- data/lib/wx/core/event.rb +6 -1
- data/lib/wx/core/events/evt_list.rb +5 -4
- data/lib/wx/core/evthandler.rb +8 -2
- data/lib/wx/core/generic_validator.rb +312 -0
- data/lib/wx/core/listbox.rb +2 -2
- data/lib/wx/core/log.rb +1 -1
- data/lib/wx/core/owner_drawn_combobox.rb +45 -0
- data/lib/wx/core/size.rb +4 -0
- data/lib/wx/core/sizer.rb +1 -2
- data/lib/wx/core/standard_paths.rb +22 -0
- data/lib/wx/core/text_entry.rb +4 -1
- data/lib/wx/core/validator.rb +70 -5
- data/lib/wx/core/window.rb +3 -7
- data/lib/wx/doc/art_locator.rb +1 -0
- data/lib/wx/doc/comboctrl.rb +18 -0
- data/lib/wx/doc/controlwithitems.rb +16 -0
- data/lib/wx/doc/date_picker_ctrl.rb +23 -0
- data/lib/wx/doc/editable_listbox.rb +44 -0
- data/lib/wx/doc/enum.rb +15 -0
- data/lib/wx/doc/event.rb +12 -0
- data/lib/wx/doc/extra/12_client_data.md +89 -0
- data/lib/wx/doc/extra/13_validators.md +139 -0
- data/lib/wx/doc/gdi_common.rb +4 -0
- data/lib/wx/doc/gen/about_dialog_info.rb +25 -0
- data/lib/wx/doc/gen/accelerator.rb +7 -1
- data/lib/wx/doc/gen/accessible.rb +13 -0
- data/lib/wx/doc/gen/activity_indicator.rb +7 -0
- data/lib/wx/doc/gen/animation.rb +12 -0
- data/lib/wx/doc/gen/animation_ctrl.rb +10 -0
- data/lib/wx/doc/gen/any_button.rb +17 -1
- data/lib/wx/doc/gen/app.rb +35 -1
- data/lib/wx/doc/gen/app_traits.rb +38 -5
- data/lib/wx/doc/gen/art_provider.rb +14 -0
- data/lib/wx/doc/gen/aui/aui_dock_art.rb +12 -0
- data/lib/wx/doc/gen/aui/aui_floating_frame.rb +1 -0
- data/lib/wx/doc/gen/aui/aui_manager.rb +24 -1
- data/lib/wx/doc/gen/aui/aui_manager_event.rb +9 -1
- data/lib/wx/doc/gen/aui/aui_mdi_child_frame.rb +3 -0
- data/lib/wx/doc/gen/aui/aui_mdi_client_window.rb +2 -0
- data/lib/wx/doc/gen/aui/aui_mdi_parent_frame.rb +3 -1
- data/lib/wx/doc/gen/aui/aui_notebook.rb +20 -2
- data/lib/wx/doc/gen/aui/aui_notebook_event.rb +2 -1
- data/lib/wx/doc/gen/aui/aui_pane_info.rb +30 -1
- data/lib/wx/doc/gen/aui/aui_tab_art.rb +6 -0
- data/lib/wx/doc/gen/aui/aui_tab_ctrl.rb +1 -0
- data/lib/wx/doc/gen/aui/aui_tool_bar.rb +11 -0
- data/lib/wx/doc/gen/aui/aui_tool_bar_art.rb +2 -0
- data/lib/wx/doc/gen/aui/aui_tool_bar_event.rb +2 -1
- data/lib/wx/doc/gen/aui/aui_tool_bar_item.rb +4 -0
- data/lib/wx/doc/gen/banner_window.rb +7 -0
- data/lib/wx/doc/gen/bitmap.rb +64 -3
- data/lib/wx/doc/gen/bitmap_button.rb +6 -1
- data/lib/wx/doc/gen/bitmap_combo_box.rb +9 -3
- data/lib/wx/doc/gen/book_ctrl_base.rb +17 -2
- data/lib/wx/doc/gen/book_ctrl_event.rb +3 -1
- data/lib/wx/doc/gen/box_sizer.rb +5 -0
- data/lib/wx/doc/gen/brush.rb +16 -1
- data/lib/wx/doc/gen/busy_info.rb +8 -0
- data/lib/wx/doc/gen/button.rb +11 -3
- data/lib/wx/doc/gen/calculate_layout_event.rb +4 -0
- data/lib/wx/doc/gen/calendar_ctrl.rb +22 -0
- data/lib/wx/doc/gen/calendar_date_attr.rb +1 -0
- data/lib/wx/doc/gen/calendar_event.rb +3 -1
- data/lib/wx/doc/gen/caret.rb +3 -0
- data/lib/wx/doc/gen/check_box.rb +10 -0
- data/lib/wx/doc/gen/check_list_box.rb +3 -0
- data/lib/wx/doc/gen/choice.rb +14 -2
- data/lib/wx/doc/gen/choicebook.rb +1 -0
- data/lib/wx/doc/gen/client_dc.rb +1 -0
- data/lib/wx/doc/gen/clipboard.rb +9 -0
- data/lib/wx/doc/gen/collapsible_pane.rb +3 -0
- data/lib/wx/doc/gen/collapsible_pane_event.rb +1 -0
- data/lib/wx/doc/gen/colour.rb +20 -0
- data/lib/wx/doc/gen/colour_dialog.rb +10 -0
- data/lib/wx/doc/gen/colour_picker_ctrl.rb +4 -0
- data/lib/wx/doc/gen/colour_picker_event.rb +1 -0
- data/lib/wx/doc/gen/combo_box.rb +20 -1
- data/lib/wx/doc/gen/combo_ctrl.rb +54 -295
- data/lib/wx/doc/gen/command_link_button.rb +8 -0
- data/lib/wx/doc/gen/context_help_button.rb +7 -1
- data/lib/wx/doc/gen/control.rb +12 -0
- data/lib/wx/doc/gen/control_with_items.rb +45 -9
- data/lib/wx/doc/gen/core.rb +2 -2
- data/lib/wx/doc/gen/cursor.rb +4 -0
- data/lib/wx/doc/gen/data_format.rb +1 -0
- data/lib/wx/doc/gen/data_object.rb +27 -5
- data/lib/wx/doc/gen/date_event.rb +2 -1
- data/lib/wx/doc/gen/date_picker_ctrl.rb +7 -1
- data/lib/wx/doc/gen/dc.rb +87 -3
- data/lib/wx/doc/gen/dial_up_event.rb +2 -0
- data/lib/wx/doc/gen/dial_up_manager.rb +12 -0
- data/lib/wx/doc/gen/dialog.rb +42 -3
- data/lib/wx/doc/gen/dir_dialog.rb +6 -1
- data/lib/wx/doc/gen/dir_filter_list_ctrl.rb +1 -0
- data/lib/wx/doc/gen/dir_picker_ctrl.rb +5 -0
- data/lib/wx/doc/gen/drag_drop.rb +20 -0
- data/lib/wx/doc/gen/drag_image.rb +7 -0
- data/lib/wx/doc/gen/editable_list_box.rb +5 -3
- data/lib/wx/doc/gen/event.rb +26 -11
- data/lib/wx/doc/gen/event_blocker.rb +2 -1
- data/lib/wx/doc/gen/event_filter.rb +3 -0
- data/lib/wx/doc/gen/event_list.rb +4 -4
- data/lib/wx/doc/gen/events.rb +165 -26
- data/lib/wx/doc/gen/evt_handler.rb +40 -2
- data/lib/wx/doc/gen/ext_help_controller.rb +9 -0
- data/lib/wx/doc/gen/file_ctrl.rb +11 -2
- data/lib/wx/doc/gen/file_ctrl_event.rb +5 -1
- data/lib/wx/doc/gen/file_dialog.rb +13 -0
- data/lib/wx/doc/gen/file_dialog_custom_control.rb +12 -0
- data/lib/wx/doc/gen/file_dialog_customize_hook.rb +9 -0
- data/lib/wx/doc/gen/file_dir_picker_event.rb +2 -1
- data/lib/wx/doc/gen/file_picker_ctrl.rb +4 -0
- data/lib/wx/doc/gen/file_system.rb +17 -1
- data/lib/wx/doc/gen/find_dialog_event.rb +2 -1
- data/lib/wx/doc/gen/find_replace_data.rb +1 -0
- data/lib/wx/doc/gen/find_replace_dialog.rb +3 -0
- data/lib/wx/doc/gen/flex_grid_sizer.rb +13 -0
- data/lib/wx/doc/gen/font.rb +75 -3
- data/lib/wx/doc/gen/font_data.rb +14 -0
- data/lib/wx/doc/gen/font_dialog.rb +6 -0
- data/lib/wx/doc/gen/font_picker_ctrl.rb +8 -0
- data/lib/wx/doc/gen/font_picker_event.rb +1 -0
- data/lib/wx/doc/gen/frame.rb +24 -7
- data/lib/wx/doc/gen/fs_file.rb +22 -0
- data/lib/wx/doc/gen/gauge.rb +8 -0
- data/lib/wx/doc/gen/gb_sizer_item.rb +5 -0
- data/lib/wx/doc/gen/gcdc.rb +2 -0
- data/lib/wx/doc/gen/gdi_common.rb +50 -0
- data/lib/wx/doc/gen/gdi_object.rb +1 -0
- data/lib/wx/doc/gen/generic_dir_ctrl.rb +7 -0
- data/lib/wx/doc/gen/graphics_context.rb +36 -7
- data/lib/wx/doc/gen/graphics_object.rb +24 -0
- data/lib/wx/doc/gen/grid/grid_cell_activatable_editor.rb +2 -0
- data/lib/wx/doc/gen/grid/grid_cell_attr.rb +14 -2
- data/lib/wx/doc/gen/grid/grid_cell_auto_wrap_string_editor.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_auto_wrap_string_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_bool_editor.rb +2 -0
- data/lib/wx/doc/gen/grid/grid_cell_bool_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_choice_editor.rb +2 -0
- data/lib/wx/doc/gen/grid/grid_cell_date_editor.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_date_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_date_time_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_editor.rb +9 -0
- data/lib/wx/doc/gen/grid/grid_cell_enum_editor.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_enum_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_float_editor.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_float_renderer.rb +2 -0
- data/lib/wx/doc/gen/grid/grid_cell_number_editor.rb +2 -0
- data/lib/wx/doc/gen/grid/grid_cell_number_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_renderer.rb +6 -0
- data/lib/wx/doc/gen/grid/grid_cell_string_renderer.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_cell_text_editor.rb +1 -0
- data/lib/wx/doc/gen/grid/grid_ctrl.rb +229 -7
- data/lib/wx/doc/gen/grid/grid_editor_created_event.rb +4 -1
- data/lib/wx/doc/gen/grid/grid_event.rb +4 -1
- data/lib/wx/doc/gen/grid/grid_range_select_event.rb +2 -1
- data/lib/wx/doc/gen/grid/grid_size_event.rb +2 -1
- data/lib/wx/doc/gen/grid/grid_string_table.rb +7 -0
- data/lib/wx/doc/gen/grid/grid_table_base.rb +27 -1
- data/lib/wx/doc/gen/grid/grid_table_message.rb +1 -0
- data/lib/wx/doc/gen/grid_bag_sizer.rb +24 -4
- data/lib/wx/doc/gen/grid_sizer.rb +11 -0
- data/lib/wx/doc/gen/gui_event_loop.rb +12 -0
- data/lib/wx/doc/gen/header_ctrl.rb +106 -0
- data/lib/wx/doc/gen/header_ctrl_event.rb +5 -1
- data/lib/wx/doc/gen/help_controller.rb +11 -0
- data/lib/wx/doc/gen/help_provider.rb +12 -3
- data/lib/wx/doc/gen/html/html_cell.rb +25 -0
- data/lib/wx/doc/gen/html/html_cell_event.rb +3 -1
- data/lib/wx/doc/gen/html/html_easy_printing.rb +13 -1
- data/lib/wx/doc/gen/html/html_help_controller.rb +18 -0
- data/lib/wx/doc/gen/html/html_help_data.rb +5 -0
- data/lib/wx/doc/gen/html/html_help_window.rb +8 -0
- data/lib/wx/doc/gen/html/html_link_event.rb +1 -0
- data/lib/wx/doc/gen/html/html_list_box.rb +49 -9
- data/lib/wx/doc/gen/html/html_printout.rb +7 -0
- data/lib/wx/doc/gen/html/html_window.rb +31 -0
- data/lib/wx/doc/gen/hyperlink_ctrl.rb +2 -1
- data/lib/wx/doc/gen/hyperlink_event.rb +1 -0
- data/lib/wx/doc/gen/icon.rb +19 -1
- data/lib/wx/doc/gen/icon_location.rb +1 -0
- data/lib/wx/doc/gen/image.rb +67 -10
- data/lib/wx/doc/gen/image_list.rb +12 -2
- data/lib/wx/doc/gen/info_bar.rb +12 -0
- data/lib/wx/doc/gen/keyboard_state.rb +11 -0
- data/lib/wx/doc/gen/list_box.rb +20 -3
- data/lib/wx/doc/gen/list_ctrl.rb +89 -0
- data/lib/wx/doc/gen/list_event.rb +11 -1
- data/lib/wx/doc/gen/listbook.rb +1 -0
- data/lib/wx/doc/gen/locale.rb +22 -0
- data/lib/wx/doc/gen/log.rb +42 -0
- data/lib/wx/doc/gen/mdi_client_window.rb +4 -1
- data/lib/wx/doc/gen/mdi_frame.rb +27 -4
- data/lib/wx/doc/gen/media_ctrl.rb +17 -0
- data/lib/wx/doc/gen/media_event.rb +2 -1
- data/lib/wx/doc/gen/memory_dc.rb +10 -0
- data/lib/wx/doc/gen/menu.rb +48 -7
- data/lib/wx/doc/gen/menu_bar.rb +32 -13
- data/lib/wx/doc/gen/menu_item.rb +26 -0
- data/lib/wx/doc/gen/message_dialog.rb +10 -0
- data/lib/wx/doc/gen/mini_frame.rb +5 -2
- data/lib/wx/doc/gen/mirror_dc.rb +1 -0
- data/lib/wx/doc/gen/mouse_state.rb +1 -0
- data/lib/wx/doc/gen/multi_choice_dialog.rb +3 -1
- data/lib/wx/doc/gen/non_owned_window.rb +3 -0
- data/lib/wx/doc/gen/notebook.rb +11 -1
- data/lib/wx/doc/gen/num_validator.rb +37 -0
- data/lib/wx/doc/gen/number_entry_dialog.rb +4 -0
- data/lib/wx/doc/gen/object.rb +3 -0
- data/lib/wx/doc/gen/owner_drawn_combo_box.rb +340 -0
- data/lib/wx/doc/gen/paint_dc.rb +1 -0
- data/lib/wx/doc/gen/palette.rb +5 -0
- data/lib/wx/doc/gen/panel.rb +10 -2
- data/lib/wx/doc/gen/pen.rb +30 -1
- data/lib/wx/doc/gen/pg/numeric_property_validator.rb +2 -1
- data/lib/wx/doc/gen/pg/pg_array_editor_dialog.rb +4 -1
- data/lib/wx/doc/gen/pg/pg_cell.rb +6 -1
- data/lib/wx/doc/gen/pg/pg_editor.rb +61 -15
- data/lib/wx/doc/gen/pg/pg_multi_button.rb +2 -0
- data/lib/wx/doc/gen/pg/pg_properties.rb +198 -81
- data/lib/wx/doc/gen/pg/pg_property.rb +129 -52
- data/lib/wx/doc/gen/pg/pg_validation_info.rb +2 -0
- data/lib/wx/doc/gen/pg/property_grid.rb +56 -14
- data/lib/wx/doc/gen/pg/property_grid_event.rb +16 -6
- data/lib/wx/doc/gen/pg/property_grid_interface.rb +98 -37
- data/lib/wx/doc/gen/pg/property_grid_manager.rb +29 -7
- data/lib/wx/doc/gen/pg/property_grid_page.rb +11 -4
- data/lib/wx/doc/gen/pg/property_grid_page_state.rb +7 -2
- data/lib/wx/doc/gen/picker_base.rb +11 -1
- data/lib/wx/doc/gen/platform_info.rb +31 -0
- data/lib/wx/doc/gen/popup_window.rb +5 -0
- data/lib/wx/doc/gen/progress_dialog.rb +4 -0
- data/lib/wx/doc/gen/property_sheet_dialog.rb +7 -1
- data/lib/wx/doc/gen/prt/page_setup_dialog.rb +2 -0
- data/lib/wx/doc/gen/prt/post_script_dc.rb +1 -0
- data/lib/wx/doc/gen/prt/preview_frame.rb +4 -0
- data/lib/wx/doc/gen/prt/print_abort_dialog.rb +1 -0
- data/lib/wx/doc/gen/prt/print_data.rb +27 -0
- data/lib/wx/doc/gen/prt/print_dialog.rb +4 -0
- data/lib/wx/doc/gen/prt/printer.rb +42 -5
- data/lib/wx/doc/gen/prt/printer_dc.rb +2 -0
- data/lib/wx/doc/gen/query_layout_info_event.rb +9 -0
- data/lib/wx/doc/gen/radio_box.rb +19 -0
- data/lib/wx/doc/gen/radio_button.rb +9 -0
- data/lib/wx/doc/gen/rbn/ribbon_art_provider.rb +63 -0
- data/lib/wx/doc/gen/rbn/ribbon_bar.rb +23 -0
- data/lib/wx/doc/gen/rbn/ribbon_bar_event.rb +2 -1
- data/lib/wx/doc/gen/rbn/ribbon_button_bar.rb +35 -9
- data/lib/wx/doc/gen/rbn/ribbon_button_bar_event.rb +2 -1
- data/lib/wx/doc/gen/rbn/ribbon_control.rb +10 -0
- data/lib/wx/doc/gen/rbn/ribbon_gallery.rb +17 -7
- data/lib/wx/doc/gen/rbn/ribbon_gallery_event.rb +2 -1
- data/lib/wx/doc/gen/rbn/ribbon_page.rb +12 -0
- data/lib/wx/doc/gen/rbn/ribbon_panel.rb +11 -0
- data/lib/wx/doc/gen/rbn/ribbon_panel_event.rb +2 -1
- data/lib/wx/doc/gen/rbn/ribbon_tool_bar.rb +25 -0
- data/lib/wx/doc/gen/rbn/ribbon_tool_bar_event.rb +2 -1
- data/lib/wx/doc/gen/rearrange_ctrl.rb +4 -0
- data/lib/wx/doc/gen/rearrange_list.rb +9 -0
- data/lib/wx/doc/gen/region.rb +42 -13
- data/lib/wx/doc/gen/region_iterator.rb +1 -0
- data/lib/wx/doc/gen/rtc/rich_text_box.rb +25 -8
- data/lib/wx/doc/gen/rtc/rich_text_buffer.rb +41 -4
- data/lib/wx/doc/gen/rtc/rich_text_buffer_data_object.rb +1 -0
- data/lib/wx/doc/gen/rtc/rich_text_composite_object.rb +23 -11
- data/lib/wx/doc/gen/rtc/rich_text_ctrl.rb +74 -0
- data/lib/wx/doc/gen/rtc/rich_text_event.rb +6 -1
- data/lib/wx/doc/gen/rtc/rich_text_file_handler.rb +8 -0
- data/lib/wx/doc/gen/rtc/rich_text_formatting_dialog.rb +6 -0
- data/lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb +1 -0
- data/lib/wx/doc/gen/rtc/rich_text_html_handler.rb +4 -0
- data/lib/wx/doc/gen/rtc/rich_text_image.rb +7 -0
- data/lib/wx/doc/gen/rtc/rich_text_object.rb +64 -4
- data/lib/wx/doc/gen/rtc/rich_text_paragraph_layout_box.rb +51 -4
- data/lib/wx/doc/gen/rtc/rich_text_printing.rb +13 -0
- data/lib/wx/doc/gen/rtc/rich_text_style_list_box.rb +9 -4
- data/lib/wx/doc/gen/rtc/rich_text_style_organiser_dialog.rb +3 -0
- data/lib/wx/doc/gen/rtc/rich_text_xml_handler.rb +2 -0
- data/lib/wx/doc/gen/rtc/symbol_picker_dialog.rb +1 -0
- data/lib/wx/doc/gen/sash_event.rb +5 -1
- data/lib/wx/doc/gen/sash_layout_window.rb +10 -0
- data/lib/wx/doc/gen/sash_window.rb +3 -0
- data/lib/wx/doc/gen/screen_dc.rb +1 -0
- data/lib/wx/doc/gen/scroll_bar.rb +11 -2
- data/lib/wx/doc/gen/scrolled_canvas.rb +20 -4
- data/lib/wx/doc/gen/scrolled_control.rb +20 -4
- data/lib/wx/doc/gen/scrolled_window.rb +20 -4
- data/lib/wx/doc/gen/search_ctrl.rb +6 -0
- data/lib/wx/doc/gen/simplebook.rb +7 -0
- data/lib/wx/doc/gen/single_choice_dialog.rb +3 -1
- data/lib/wx/doc/gen/sizer.rb +79 -9
- data/lib/wx/doc/gen/sizer_item.rb +16 -2
- data/lib/wx/doc/gen/slider.rb +23 -0
- data/lib/wx/doc/gen/spin_button.rb +9 -0
- data/lib/wx/doc/gen/spin_ctrl.rb +11 -0
- data/lib/wx/doc/gen/spin_ctrl_double.rb +7 -0
- data/lib/wx/doc/gen/spin_double_event.rb +4 -1
- data/lib/wx/doc/gen/spin_event.rb +2 -1
- data/lib/wx/doc/gen/splash_screen.rb +2 -0
- data/lib/wx/doc/gen/splitter_event.rb +10 -1
- data/lib/wx/doc/gen/splitter_window.rb +38 -14
- data/lib/wx/doc/gen/static_bitmap.rb +99 -2
- data/lib/wx/doc/gen/static_box.rb +6 -0
- data/lib/wx/doc/gen/static_box_sizer.rb +3 -0
- data/lib/wx/doc/gen/static_line.rb +4 -0
- data/lib/wx/doc/gen/static_text.rb +5 -0
- data/lib/wx/doc/gen/status_bar.rb +17 -3
- data/lib/wx/doc/gen/stc/styled_text_ctrl.rb +174 -6
- data/lib/wx/doc/gen/stc/styled_text_event.rb +27 -1
- data/lib/wx/doc/gen/std_dialog_button_sizer.rb +7 -0
- data/lib/wx/doc/gen/svg_file_dc.rb +9 -0
- data/lib/wx/doc/gen/system_options.rb +8 -0
- data/lib/wx/doc/gen/system_settings.rb +7 -0
- data/lib/wx/doc/gen/task_bar_button.rb +12 -0
- data/lib/wx/doc/gen/task_bar_icon.rb +5 -0
- data/lib/wx/doc/gen/task_bar_icon_event.rb +2 -1
- data/lib/wx/doc/gen/text_attr.rb +27 -0
- data/lib/wx/doc/gen/text_ctrl.rb +27 -3
- data/lib/wx/doc/gen/text_entry.rb +43 -5
- data/lib/wx/doc/gen/text_entry_dialog.rb +12 -0
- data/lib/wx/doc/gen/text_validator.rb +16 -0
- data/lib/wx/doc/gen/time_picker_ctrl.rb +6 -0
- data/lib/wx/doc/gen/timer.rb +8 -0
- data/lib/wx/doc/gen/timer_event.rb +1 -0
- data/lib/wx/doc/gen/tip_provider.rb +5 -0
- data/lib/wx/doc/gen/toggle_button.rb +68 -0
- data/lib/wx/doc/gen/tool_bar.rb +57 -14
- data/lib/wx/doc/gen/tool_tip.rb +6 -0
- data/lib/wx/doc/gen/toolbook.rb +3 -0
- data/lib/wx/doc/gen/top_level_window.rb +34 -3
- data/lib/wx/doc/gen/tree_ctrl.rb +49 -0
- data/lib/wx/doc/gen/tree_event.rb +7 -1
- data/lib/wx/doc/gen/treebook.rb +9 -0
- data/lib/wx/doc/gen/ui_action_simulator.rb +4 -0
- data/lib/wx/doc/gen/utils.rb +55 -0
- data/lib/wx/doc/gen/v_list_box.rb +21 -0
- data/lib/wx/doc/gen/v_scrolled_window.rb +15 -0
- data/lib/wx/doc/gen/validator.rb +9 -13
- data/lib/wx/doc/gen/variant.rb +6 -0
- data/lib/wx/doc/gen/window.rb +260 -52
- data/lib/wx/doc/gen/window_dc.rb +2 -0
- data/lib/wx/doc/gen/window_disabler.rb +1 -0
- data/lib/wx/doc/gen/with_images.rb +7 -1
- data/lib/wx/doc/gen/wizard.rb +18 -0
- data/lib/wx/doc/gen/wizard_event.rb +3 -1
- data/lib/wx/doc/gen/wizard_page.rb +5 -0
- data/lib/wx/doc/gen/wizard_page_simple.rb +4 -0
- data/lib/wx/doc/gen/wrap_sizer.rb +5 -0
- data/lib/wx/doc/gen/xml_node.rb +14 -0
- data/lib/wx/doc/gen/xml_resource.rb +22 -0
- data/lib/wx/doc/generic_validator.rb +95 -0
- data/lib/wx/doc/html/simple_html_listbox.rb +22 -0
- data/lib/wx/doc/num_validator.rb +387 -0
- data/lib/wx/doc/owner_drawn_combobox.rb +96 -0
- data/lib/wx/doc/pg/numeric_property_validator.rb +33 -0
- data/lib/wx/doc/static_bitmap.rb +25 -0
- data/lib/wx/doc/text_validator.rb +10 -0
- data/lib/wx/doc/validator.rb +113 -0
- data/lib/wx/doc/window.rb +30 -0
- data/lib/wx/html/events/evt_list.rb +0 -10
- data/lib/wx/html/simple_html_listbox.rb +24 -91
- data/lib/wx/keyword_defs.rb +34 -2
- data/lib/wx/rbn/ribbon_gallery.rb +0 -21
- data/lib/wx/version.rb +1 -1
- data/lib/wxruby_aui.so +0 -0
- data/lib/wxruby_core.so +0 -0
- data/lib/wxruby_grid.so +0 -0
- data/lib/wxruby_html.so +0 -0
- data/lib/wxruby_pg.so +0 -0
- data/lib/wxruby_prt.so +0 -0
- data/lib/wxruby_rbn.so +0 -0
- data/lib/wxruby_rtc.so +0 -0
- data/lib/wxruby_stc.so +0 -0
- data/rakelib/lib/config/mingw.rb +12 -0
- data/samples/aui/aui.rb +1237 -1233
- data/samples/calendar/calendar.rb +293 -289
- data/samples/controls/get_item_sample.rb +83 -79
- data/samples/controls/htlbox.rb +331 -327
- data/samples/dialogs/dialogs.rb +682 -694
- data/samples/dialogs/wizard.rb +52 -55
- data/samples/dragdrop/dragdrop.rb +146 -142
- data/samples/drawing/bitmap.rb +29 -26
- data/samples/drawing/bitmap_image.rb +84 -80
- data/samples/drawing/graphics_drawing.rb +209 -205
- data/samples/drawing/image_prt.rb +344 -340
- data/samples/drawing/maths_images.rb +18 -1
- data/samples/drawing/rmagic_bitmap_image.rb +88 -84
- data/samples/etc/caret.rb +306 -0
- data/samples/etc/miniframe.rb +65 -60
- data/samples/etc/sash.rb +109 -105
- data/samples/etc/scrollwin.rb +86 -80
- data/samples/etc/system_settings.rb +216 -209
- data/samples/event/activation.rb +72 -67
- data/samples/event/event.rb +160 -153
- data/samples/event/threaded.rb +8 -1
- data/samples/event/update_ui_event.rb +67 -60
- data/samples/grid/grid.rb +188 -181
- data/samples/grid/gridtablebase.rb +136 -129
- data/samples/html/html.rb +208 -204
- data/samples/mdi/mdi.rb +59 -54
- data/samples/minimal/minimal.rb +54 -51
- data/samples/minimal/nothing.rb +1 -0
- data/samples/printing/printing.rb +367 -377
- data/samples/printing/printing2.rb +203 -198
- data/samples/propgrid/propgrid.rb +2312 -2308
- data/samples/propgrid/propgrid_minimal.rb +57 -50
- data/samples/ribbon/ribbon.rb +780 -774
- data/samples/sampler/ext.rb +0 -33
- data/samples/sampler/sample.rb +4 -9
- data/samples/sampler.rb +1 -1
- data/samples/splash/splash.rb +118 -116
- data/samples/text/rich_textctrl.rb +207 -201
- data/samples/text/richtext.rb +1409 -1405
- data/samples/text/scintilla.rb +137 -128
- data/samples/text/textctrl.rb +89 -83
- data/samples/text/unicode.rb +175 -168
- data/samples/treectrl/treectrl.rb +1430 -1426
- data/samples/widgets/activityindicator.rb +95 -0
- data/samples/widgets/art/widgets/activityindicator.xpm +278 -0
- data/samples/widgets/art/widgets/bmpbtn.xpm +37 -0
- data/samples/widgets/art/widgets/bmpcombobox.xpm +54 -0
- data/samples/widgets/art/widgets/button.xpm +54 -0
- data/samples/widgets/art/widgets/checkbox.xpm +54 -0
- data/samples/{bigdemo/icons → widgets/art/widgets}/choice.xpm +1 -1
- data/samples/widgets/art/widgets/choicebk.xpm +54 -0
- data/samples/widgets/art/widgets/clrpicker.xpm +193 -0
- data/samples/widgets/art/widgets/combobox.xpm +54 -0
- data/samples/widgets/art/widgets/datepick.xpm +200 -0
- data/samples/widgets/art/widgets/dirctrl.xpm +54 -0
- data/samples/widgets/art/widgets/dirpicker.xpm +213 -0
- data/samples/widgets/art/widgets/filepicker.xpm +214 -0
- data/samples/widgets/art/widgets/fontpicker.xpm +185 -0
- data/samples/widgets/art/widgets/gauge.xpm +54 -0
- data/samples/widgets/art/widgets/header.xpm +54 -0
- data/samples/widgets/art/widgets/hyperlnk.xpm +54 -0
- data/samples/widgets/art/widgets/listbook.xpm +54 -0
- data/samples/widgets/art/widgets/listbox.xpm +54 -0
- data/samples/widgets/art/widgets/native.xpm +81 -0
- data/samples/widgets/art/widgets/notebook.xpm +54 -0
- data/samples/widgets/art/widgets/odcombobox.xpm +54 -0
- data/samples/widgets/art/widgets/radiobox.xpm +54 -0
- data/samples/widgets/art/widgets/scrolbar.xpm +54 -0
- data/samples/widgets/art/widgets/slider.xpm +54 -0
- data/samples/widgets/art/widgets/spinbtn.xpm +40 -0
- data/samples/widgets/art/widgets/statbmp.xpm +40 -0
- data/samples/widgets/art/widgets/statbox.xpm +54 -0
- data/samples/widgets/art/widgets/stattext.xpm +54 -0
- data/samples/widgets/art/widgets/text.xpm +54 -0
- data/samples/widgets/art/widgets/timepick.xpm +207 -0
- data/samples/widgets/art/widgets/toggle.xpm +54 -0
- data/samples/widgets/art/widgets/toucan.png +0 -0
- data/samples/widgets/bmpcombobox.rb +651 -0
- data/samples/widgets/button.rb +462 -0
- data/samples/widgets/checkbox.rb +211 -0
- data/samples/widgets/choice.rb +287 -0
- data/samples/widgets/clrpicker.rb +156 -0
- data/samples/widgets/combobox.rb +516 -0
- data/samples/widgets/datepick.rb +215 -0
- data/samples/widgets/dirctrl.rb +265 -0
- data/samples/widgets/dirpicker.rb +158 -0
- data/samples/widgets/editlbox.rb +122 -0
- data/samples/widgets/filectrl.rb +216 -0
- data/samples/widgets/filepicker.rb +214 -0
- data/samples/widgets/fontpicker.rb +135 -0
- data/samples/widgets/gauge.rb +311 -0
- data/samples/widgets/headerctrl.rb +236 -0
- data/samples/widgets/hyperlink.rb +203 -0
- data/samples/widgets/itemcontainer.rb +185 -0
- data/samples/widgets/listbox.rb +473 -0
- data/samples/widgets/notebook.rb +488 -0
- data/samples/widgets/odcombobox.rb +608 -0
- data/samples/widgets/radiobox.rb +328 -0
- data/samples/widgets/searchctrl.rb +159 -0
- data/samples/widgets/slider.rb +594 -0
- data/samples/widgets/spinbtn.rb +443 -0
- data/samples/widgets/statbmp.rb +130 -0
- data/samples/widgets/static.rb +436 -0
- data/samples/widgets/textctrl.rb +700 -0
- data/samples/widgets/timepick.rb +148 -0
- data/samples/widgets/tn_widgets.png +0 -0
- data/samples/widgets/toggle.rb +385 -0
- data/samples/widgets/widgets.rb +1233 -0
- data/samples/xrc/custom_xrc_sample.rb +47 -41
- data/samples/xrc/xrc_sample.rb +53 -47
- data/tests/test_event_handling.rb +52 -34
- data/tests/test_events.rb +7 -0
- data/tests/test_item_data.rb +24 -0
- data/tests/test_sizer.rb +44 -1
- data/tests/test_validators.rb +805 -0
- metadata +87 -137
- data/lib/wx/core/choice.rb +0 -14
- data/lib/wx/core/combo_ctrl.rb +0 -110
- data/samples/bigdemo/About.rbw +0 -39
- data/samples/bigdemo/ColorPanel.rbw +0 -23
- data/samples/bigdemo/GridSimple.rbw +0 -78
- data/samples/bigdemo/MDIDemo.rbw +0 -57
- data/samples/bigdemo/PopupMenu.rbw +0 -146
- data/samples/bigdemo/ShapedWindow.rbw +0 -128
- data/samples/bigdemo/Sizers.rbw +0 -541
- data/samples/bigdemo/bigdemo.rb +0 -817
- data/samples/bigdemo/demoTemplate.rbw +0 -33
- data/samples/bigdemo/helpfile.htb +0 -0
- data/samples/bigdemo/icons/Test 015.jpg +0 -0
- data/samples/bigdemo/icons/Test 015.png +0 -0
- data/samples/bigdemo/icons/choice.bmp +0 -0
- data/samples/bigdemo/icons/combo.bmp +0 -0
- data/samples/bigdemo/icons/combo.xpm +0 -27
- data/samples/bigdemo/icons/copy.xpm +0 -25
- data/samples/bigdemo/icons/cut.xpm +0 -24
- data/samples/bigdemo/icons/gauge.bmp +0 -0
- data/samples/bigdemo/icons/gauge.xpm +0 -27
- data/samples/bigdemo/icons/help.xpm +0 -25
- data/samples/bigdemo/icons/list.bmp +0 -0
- data/samples/bigdemo/icons/list.xpm +0 -27
- data/samples/bigdemo/icons/mondrian.ico +0 -0
- data/samples/bigdemo/icons/mondrian.xpm +0 -44
- data/samples/bigdemo/icons/new.xpm +0 -24
- data/samples/bigdemo/icons/ogl.ico +0 -0
- data/samples/bigdemo/icons/ogl.xpm +0 -45
- data/samples/bigdemo/icons/open.xpm +0 -26
- data/samples/bigdemo/icons/paste.bmp +0 -0
- data/samples/bigdemo/icons/paste.xpm +0 -38
- data/samples/bigdemo/icons/pointy.png +0 -0
- data/samples/bigdemo/icons/preview.xpm +0 -26
- data/samples/bigdemo/icons/print.xpm +0 -26
- data/samples/bigdemo/icons/radio.bmp +0 -0
- data/samples/bigdemo/icons/radio.xpm +0 -27
- data/samples/bigdemo/icons/robert.xpm +0 -415
- data/samples/bigdemo/icons/sashtest.ico +0 -0
- data/samples/bigdemo/icons/save.xpm +0 -25
- data/samples/bigdemo/icons/smiles.bmp +0 -0
- data/samples/bigdemo/icons/smiles.xpm +0 -39
- data/samples/bigdemo/icons/smiley.ico +0 -0
- data/samples/bigdemo/icons/smiley.xpm +0 -42
- data/samples/bigdemo/icons/stattext.xpm +0 -24
- data/samples/bigdemo/icons/test2.bmp +0 -0
- data/samples/bigdemo/icons/test2.png +0 -0
- data/samples/bigdemo/icons/test2.xpm +0 -79
- data/samples/bigdemo/icons/text.bmp +0 -0
- data/samples/bigdemo/icons/text.xpm +0 -27
- data/samples/bigdemo/icons/tog1.bmp +0 -0
- data/samples/bigdemo/icons/tog1.xpm +0 -38
- data/samples/bigdemo/icons/tog2.bmp +0 -0
- data/samples/bigdemo/icons/tog2.xpm +0 -38
- data/samples/bigdemo/icons/wxruby-128x128.png +0 -0
- data/samples/bigdemo/icons/wxwin.ico +0 -0
- data/samples/bigdemo/icons/wxwin16x16.png +0 -0
- data/samples/bigdemo/icons/wxwin16x16.xpm +0 -25
- data/samples/bigdemo/icons/wxwin32x32.png +0 -0
- data/samples/bigdemo/icons/wxwin48x48.png +0 -0
- data/samples/bigdemo/run.rb +0 -98
- data/samples/bigdemo/tips.txt +0 -7
- data/samples/bigdemo/utils.rb +0 -20
- data/samples/bigdemo/wxArtProvider.rbw +0 -282
- data/samples/bigdemo/wxBitmapButton.rbw +0 -65
- data/samples/bigdemo/wxButton.rbw +0 -64
- data/samples/bigdemo/wxCalendarCtrl.rbw +0 -59
- data/samples/bigdemo/wxCheckBox.rbw +0 -50
- data/samples/bigdemo/wxCheckListBox.rbw +0 -65
- data/samples/bigdemo/wxChoice.rbw +0 -47
- data/samples/bigdemo/wxChoicebook.rbw +0 -78
- data/samples/bigdemo/wxColourDialog.rbw +0 -33
- data/samples/bigdemo/wxComboBox.rbw +0 -77
- data/samples/bigdemo/wxCursor.rbw +0 -136
- data/samples/bigdemo/wxDialog.rbw +0 -74
- data/samples/bigdemo/wxDirDialog.rbw +0 -29
- data/samples/bigdemo/wxDragImage.rbw +0 -70
- data/samples/bigdemo/wxFileDialog.rbw +0 -37
- data/samples/bigdemo/wxFileDialog_Save.rbw +0 -35
- data/samples/bigdemo/wxFindReplaceDialog.rbw +0 -82
- data/samples/bigdemo/wxFontDialog.rbw +0 -200
- data/samples/bigdemo/wxFrame.rbw +0 -53
- data/samples/bigdemo/wxGauge.rbw +0 -65
- data/samples/bigdemo/wxGenericDirCtrl.rbw +0 -74
- data/samples/bigdemo/wxGrid.rbw +0 -66
- data/samples/bigdemo/wxHtmlHelpController.rbw +0 -52
- data/samples/bigdemo/wxListBox.rbw +0 -140
- data/samples/bigdemo/wxListCtrl_virtual.rbw +0 -112
- data/samples/bigdemo/wxMDIWindows.rbw +0 -50
- data/samples/bigdemo/wxMenu.rbw +0 -247
- data/samples/bigdemo/wxMessageDialog.rbw +0 -27
- data/samples/bigdemo/wxMiniFrame.rbw +0 -70
- data/samples/bigdemo/wxMultipleChoiceDialog.rbw +0 -29
- data/samples/bigdemo/wxNotebook.rbw +0 -136
- data/samples/bigdemo/wxProgressDialog.rbw +0 -43
- data/samples/bigdemo/wxRadioBox.rbw +0 -72
- data/samples/bigdemo/wxRadioButton.rbw +0 -125
- data/samples/bigdemo/wxSashWindow.rbw +0 -141
- data/samples/bigdemo/wxScrolledMessageDialog.rbw +0 -57
- data/samples/bigdemo/wxScrolledWindow.rbw +0 -199
- data/samples/bigdemo/wxSingleChoiceDialog.rbw +0 -33
- data/samples/bigdemo/wxSlider.rbw +0 -42
- data/samples/bigdemo/wxSpinButton.rbw +0 -50
- data/samples/bigdemo/wxSpinCtrl.rbw +0 -51
- data/samples/bigdemo/wxSplitterWindow.rbw +0 -63
- data/samples/bigdemo/wxStaticBitmap.rbw +0 -47
- data/samples/bigdemo/wxStaticText.rbw +0 -55
- data/samples/bigdemo/wxStatusBar.rbw +0 -126
- data/samples/bigdemo/wxTextCtrl.rbw +0 -149
- data/samples/bigdemo/wxTextEntryDialog.rbw +0 -31
- data/samples/bigdemo/wxToggleButton.rbw +0 -49
- data/samples/bigdemo/wxToolBar.rbw +0 -131
- data/samples/bigdemo/wxTreeCtrl.rbw +0 -191
- data/samples/caret/caret.rb +0 -298
- data/samples/caret/mondrian.xpm +0 -44
- data/samples/controls/books.rb +0 -189
- data/samples/controls/choice.xpm +0 -27
- data/samples/controls/combo.xpm +0 -27
- data/samples/controls/controls.rb +0 -1099
- data/samples/controls/gauge.xpm +0 -27
- data/samples/controls/list.xpm +0 -27
- data/samples/controls/mondrian.ico +0 -0
- data/samples/controls/mondrian.xpm +0 -44
- data/samples/controls/radio.xpm +0 -27
- data/samples/controls/stattext.xpm +0 -24
- data/samples/controls/test2.bmp +0 -0
- data/samples/controls/text.xpm +0 -27
- data/samples/controls/tn_books.png +0 -0
- data/samples/controls/tn_controls.png +0 -0
- data/samples/etc/choice.rb +0 -87
- data/samples/etc/tn_choice.png +0 -0
- data/samples/text/mondrian.ico +0 -0
- data/samples/text/mondrian.xpm +0 -44
- /data/samples/{caret → etc}/tn_caret.png +0 -0
data/lib/wx/doc/event.rb
CHANGED
@@ -27,4 +27,16 @@ module Wx
|
|
27
27
|
|
28
28
|
end
|
29
29
|
|
30
|
+
class CommandEvent < Event
|
31
|
+
|
32
|
+
alias :set_client_data :set_client_object
|
33
|
+
|
34
|
+
alias :client_data= :set_client_object
|
35
|
+
|
36
|
+
alias :get_client_data :get_client_object
|
37
|
+
|
38
|
+
alias :client_data :get_client_object
|
39
|
+
|
40
|
+
end
|
41
|
+
|
30
42
|
end
|
@@ -0,0 +1,89 @@
|
|
1
|
+
<!--
|
2
|
+
# @markup markdown
|
3
|
+
# @title 12. Client/User data with wxRuby
|
4
|
+
-->
|
5
|
+
|
6
|
+
# 12. Client/User data with wxRuby
|
7
|
+
|
8
|
+
## Introduction
|
9
|
+
|
10
|
+
The wxWidgets library has widespread support for attaching arbitrary client (or user) data to GUI elements like
|
11
|
+
windows (all event handlers actually), window items, sizer items etc.
|
12
|
+
To cater to various C++ use cases in most instances this support covers both specific wxWidgets defined types (like
|
13
|
+
wxClientData and wxObject instances) and untyped data pointers (represented as `void *`) with subtle but essential
|
14
|
+
differences.
|
15
|
+
|
16
|
+
wxRuby implements a fully compatible version of this support.
|
17
|
+
|
18
|
+
## Everything is an Object
|
19
|
+
|
20
|
+
As Ruby does not do untyped data (everything is an Object), and having two different options is confusing anyway,
|
21
|
+
wxRuby provides only a single option and more or less unifies the interface across the entire library.
|
22
|
+
In Ruby anywhere the original wxWidgets library supports some type of client (or user) data attachment wxRuby will
|
23
|
+
support the attachment of any arbitrary Ruby `Object` by either the method `#set_client_object` (where C++ supports
|
24
|
+
`SetClientData` and `SetClientObject`) or `#set_user_data` (where C++ supports `SetUserData`). Data retrieval
|
25
|
+
is supported by complementary `#get_client_object` or `#get_user_data` methods in all cases.
|
26
|
+
Wherever C++ supports `SetClientObject` wxRuby also provides the method aliases `#set_client_data` and `#get_client_data`.
|
27
|
+
|
28
|
+
Another difference with C++ is that for typed client data in wxWidgets developers could leverage object destruction as
|
29
|
+
callback trigger (through the implementation of virtual destructors) to handle any required 'unlinking' logic. This
|
30
|
+
obviously does not apply to untyped data (one of the 'subtle' differences).
|
31
|
+
As Ruby does not provide any usable object destruction hooks this does not work there.
|
32
|
+
Ruby however has 'Duck-typing' which is what wxRuby uses to provide support for a unlinking callback 'hook' for attached
|
33
|
+
client data.
|
34
|
+
|
35
|
+
> Any attached Ruby Object implementing (responding to) the method `#client_data_unlinked` will have that method called after the
|
36
|
+
> attached object has been detached from the element it was attached to (either because of data replacement or element
|
37
|
+
> deletion).
|
38
|
+
|
39
|
+
Regard the following example.
|
40
|
+
|
41
|
+
```ruby
|
42
|
+
frame = Wx::Frame.new(nil, Wx::ID_ANY)
|
43
|
+
|
44
|
+
# attach a hash with user data
|
45
|
+
frame.set_client_data({ text: 'A string', float: 3.14 })
|
46
|
+
|
47
|
+
# ... do something with frame
|
48
|
+
|
49
|
+
# replace the user data
|
50
|
+
frame.set_client_data([1,2,3,4])
|
51
|
+
|
52
|
+
# ... do something else with frame
|
53
|
+
```
|
54
|
+
|
55
|
+
In this case standard Ruby object are attached. After attachment the object can be retrieved using a call to `get_client_data`
|
56
|
+
anywhere access to the frame instance is available.
|
57
|
+
|
58
|
+
Using a specially derived (or adapted) object a developer can handle specific logic after the object has been unlinked
|
59
|
+
like in this example:
|
60
|
+
|
61
|
+
```ruby
|
62
|
+
# define a user data class
|
63
|
+
class MyUserData
|
64
|
+
def initialize(payload)
|
65
|
+
@payload = payload
|
66
|
+
end
|
67
|
+
attr_reader :payload
|
68
|
+
|
69
|
+
def client_data_unlinked
|
70
|
+
# handle some logic
|
71
|
+
end
|
72
|
+
end
|
73
|
+
|
74
|
+
# ...
|
75
|
+
|
76
|
+
# attach data to some window
|
77
|
+
win.set_client_data(MyUserData.new(some_payload_data))
|
78
|
+
|
79
|
+
# ...
|
80
|
+
|
81
|
+
# reset user data for some reason (will call MyUserData#client_data_unlinked after replacement)
|
82
|
+
win.set_client_data(nil)
|
83
|
+
```
|
84
|
+
|
85
|
+
# CommandEvent data
|
86
|
+
|
87
|
+
wxRuby also fully supports the propagation of attached client data to Wx::CommandEvent objects (see
|
88
|
+
{Wx::CommandEvent#get_client_object} and {Wx::CommandEvent#set_client_object}).
|
89
|
+
As mentioned above wxRuby provides the method aliases `#set_client_data` and `#get_client_data` here also.
|
@@ -0,0 +1,139 @@
|
|
1
|
+
<!--
|
2
|
+
# @markup markdown
|
3
|
+
# @title 13. Validators and data binding
|
4
|
+
-->
|
5
|
+
|
6
|
+
# 13. Validators and data binding
|
7
|
+
|
8
|
+
## Introduction
|
9
|
+
|
10
|
+
wxRuby fully supports validator classes offering input validation and/or data binding and/or event filtering.
|
11
|
+
|
12
|
+
## Validation
|
13
|
+
|
14
|
+
The base Wx::Validator class defines the method {Wx::Validator#validate} which is called when validation of the
|
15
|
+
value or content of the associated window is required.
|
16
|
+
|
17
|
+
The implementation of this method should (somehow) retrieve the value of the associated window and validate that
|
18
|
+
value, returning `true` if valid or `false` otherwise. The default implementation always returns `false`.
|
19
|
+
|
20
|
+
An example would be:
|
21
|
+
|
22
|
+
```ruby
|
23
|
+
# define custom validator
|
24
|
+
class MyTextValidator < Wx::Validator
|
25
|
+
|
26
|
+
def validate(_parent)
|
27
|
+
txt = get_window.value
|
28
|
+
# validate that the control text starts with a capital if not empty
|
29
|
+
txt.empty? || (?A..?Z).include?(txt[0])
|
30
|
+
end
|
31
|
+
|
32
|
+
end
|
33
|
+
|
34
|
+
# ...
|
35
|
+
|
36
|
+
# assign custom validator to text control
|
37
|
+
text = Wx::TextCtrl.new(parent, MY_TEXT_ID)
|
38
|
+
text.set_validator(MyTextValidator.new)
|
39
|
+
```
|
40
|
+
|
41
|
+
The derived, specialized, validator classes {Wx::TextValidator}, {Wx::IntegerValidator}, {Wx::IntegerValidator} and
|
42
|
+
{Wx::FloatValidator} all have implementations that can be configured through specific options and do not
|
43
|
+
normally require an override to be defined.
|
44
|
+
|
45
|
+
Examples of using the standard validators would be:
|
46
|
+
|
47
|
+
```ruby
|
48
|
+
text = Wx::TextCtrl.new(parent, MY_TEXT_ID)
|
49
|
+
|
50
|
+
# accept only hexadecimal characters
|
51
|
+
text.set_validator(Wx::TextValidator.new(Wx::TextValidatorStyle::FILTER_XDIGITS))
|
52
|
+
|
53
|
+
# or only numbers between -20 and 20
|
54
|
+
text.set_validator(Wx::IntegerValidator.new(-20, 20))
|
55
|
+
```
|
56
|
+
|
57
|
+
## Event filtering
|
58
|
+
|
59
|
+
All validator classes are event handlers and can have event handling routines defined (see
|
60
|
+
[Event Handling](05_event-handling.md)).
|
61
|
+
When processing events the core implementation will allow any validator associated with a window to handle an event
|
62
|
+
before the associated window itself thereby allowing it to filter events (see {Wx::EvtHandler#process_event} for more
|
63
|
+
details).
|
64
|
+
|
65
|
+
The standard specialized validators use this functionality to filter entry of allowable characters (by handling
|
66
|
+
Wx::EVT_CHAR events).
|
67
|
+
|
68
|
+
## Data binding
|
69
|
+
|
70
|
+
Data binding concerns the transfer of a validator's associated window's value to or from a user definable storage (a
|
71
|
+
variable, memory cache entry, persistent storage ...).
|
72
|
+
|
73
|
+
To integrate with the core C++ implementation but allow for Ruby specific differences the scheme implemented for this
|
74
|
+
differs somewhat (in naming and functionality) from the original wxWidgets interface.
|
75
|
+
|
76
|
+
The responsibilities of the standard wxRuby interface for handling validator data binding is distributed over 2 base
|
77
|
+
methods and a mixin module.
|
78
|
+
|
79
|
+
- The protected {Wx::Validator#do_transfer_from_window} and {Wx::Validator#do_transfer_to_window} methods are
|
80
|
+
responsible for collecting and transferring data from/to the associated window (possibly applying conversions).<br>
|
81
|
+
<br>
|
82
|
+
These methods have default implementations in all of the derived validator classes and should not be overridden for
|
83
|
+
specializations of these as they will be ignored.<br>
|
84
|
+
Overriding these methods is necessary to implement data binding for any user defined specialization of the base
|
85
|
+
{Wx::Validator} class.<br>
|
86
|
+
<br>
|
87
|
+
- The methods the {Wx::Validator::Binding} mixin module provide the means to store data after collection from or retrieve data
|
88
|
+
before transfer to the associated window.<br>
|
89
|
+
<br>
|
90
|
+
The methods {Wx::Validator::Binding#on_transfer_from_window} and {Wx::Validator::Binding#on_transfer_to_window} provide
|
91
|
+
the means to specify user defined binding handlers for storing the data transferred from the associated window or retrieving the
|
92
|
+
data to transfer to the associated window. Like with event handling the handlers can be specified using a `String` or
|
93
|
+
`Symbol`, a `Proc` or a `Method`.<br>
|
94
|
+
<br>
|
95
|
+
The methods {Wx::Validator::Binding#do_on_transfer_from_window} and {Wx::Validator::Binding#do_on_transfer_to_window} by
|
96
|
+
default call the binding handlers if defined.
|
97
|
+
These methods can be overridden to create derived validator classes with dedicated data binding functionality like
|
98
|
+
with {Wx::GenericValidator}.
|
99
|
+
|
100
|
+
An example of a custom validator providing data binding would be:
|
101
|
+
|
102
|
+
```ruby
|
103
|
+
class MyTextValidator < Wx::Validator
|
104
|
+
|
105
|
+
def do_transfer_from_window
|
106
|
+
get_window.get_value
|
107
|
+
end
|
108
|
+
|
109
|
+
def do_transfer_to_window(val)
|
110
|
+
get_window.set_value(val)
|
111
|
+
true
|
112
|
+
end
|
113
|
+
|
114
|
+
end
|
115
|
+
|
116
|
+
# ...
|
117
|
+
|
118
|
+
# use custom validator
|
119
|
+
@data = nil # attribute to store data
|
120
|
+
text.set_validator(MyTextValidator.new)
|
121
|
+
text.get_validator.on_transfer_to_window { @data }
|
122
|
+
text.get_validator.on_transfer_from_window { |v| @data = v }
|
123
|
+
```
|
124
|
+
|
125
|
+
All derived, specialized, validators implement a dedicated value cache which can be accessed through the `#value` attribute
|
126
|
+
accessor. Through this accessor the data collected from the associated window can get retrieved or the data to be transferred
|
127
|
+
to the associated window set.
|
128
|
+
With these classes it is therefor not necessary to define binding handlers. Defining binding handlers can however still be
|
129
|
+
useful to implement a custom, persistent, storage solution.
|
130
|
+
|
131
|
+
### Wx::GenericValidator
|
132
|
+
|
133
|
+
The {Wx::GenericValidator} class provides an extendable standard implementation for data binding in combination with a
|
134
|
+
large collection of controls (see class documentation).
|
135
|
+
The implementation provides a standard accessor {Wx::GenericValidator#value} to get the data value collected
|
136
|
+
from the associated window or set the data to transfer to the associated window.
|
137
|
+
|
138
|
+
To add support for any control unsupported by the standard implementation the method {Wx::GenericValidator.define_handler}
|
139
|
+
is provided (see documentation for an example).
|
data/lib/wx/doc/gdi_common.rb
CHANGED
@@ -61,8 +61,12 @@ module Wx
|
|
61
61
|
|
62
62
|
alias :get_x :get_width
|
63
63
|
alias :x :get_width
|
64
|
+
alias :set_x :set_width
|
65
|
+
alias :x= :set_width
|
64
66
|
alias :get_y :get_height
|
65
67
|
alias :y :get_height
|
68
|
+
alias :set_y :set_height
|
69
|
+
alias :y= :set_height
|
66
70
|
|
67
71
|
# Set this size to the given size's width,height values
|
68
72
|
# @param [Wx::Size] sz
|
@@ -7,6 +7,7 @@
|
|
7
7
|
module Wx
|
8
8
|
|
9
9
|
# This function shows the standard about dialog containing the information specified in info.
|
10
|
+
#
|
10
11
|
# If the current platform has a native about dialog which is capable of showing all the fields in info, the native dialog is used, otherwise the function falls back to the generic wxWidgets version of the dialog, i.e. does the same thing as {generic_about_box}.
|
11
12
|
# Here is an example of how this function may be used:
|
12
13
|
# ```ruby
|
@@ -28,6 +29,7 @@ module Wx
|
|
28
29
|
def self.about_box(info, parent=nil) end
|
29
30
|
|
30
31
|
# This function does the same thing as {about_box} except that it always uses the generic wxWidgets version of the dialog instead of the native one.
|
32
|
+
#
|
31
33
|
# This is mainly useful if you need to customize the dialog by e.g. adding custom controls to it (customizing the native dialog is not currently supported).
|
32
34
|
# See the Dialogs Sample for an example of about dialog customization.
|
33
35
|
# @see Wx::AboutDialogInfo
|
@@ -37,6 +39,7 @@ module Wx
|
|
37
39
|
def self.generic_about_box(info, parent=nil) end
|
38
40
|
|
39
41
|
# {Wx::AboutDialogInfo} contains information shown in the standard About dialog displayed by the {about_box} function.
|
42
|
+
#
|
40
43
|
# This class contains the general information about the program, such as its name, version, copyright and so on, as well as lists of the program developers, documentation writers, artists and translators. The simple properties from the former group are represented as a string with the exception of the program icon and the program web site, while the lists from the latter group are stored as {Wx::ArrayString} and can be either set entirely at once using {Wx::AboutDialogInfo#set_developers} and similar functions or built one by one using {Wx::AboutDialogInfo#add_developer} etc.
|
41
44
|
# Please also notice that while all the main platforms have the native implementation of the about dialog, they are often more limited than the generic version provided by wxWidgets and so the generic version is used if {Wx::AboutDialogInfo} has any fields not supported by the native version. Currently GTK+ version supports all the possible fields natively but MSW and Mac versions don't support URLs, licence text nor custom icons in the about dialog and if either of those is used, {about_box} will automatically use the generic version so you should avoid specifying these fields to achieve more native look and feel.
|
42
45
|
#
|
@@ -70,6 +73,7 @@ module Wx
|
|
70
73
|
|
71
74
|
# Adds an artist name to be shown in the program credits.
|
72
75
|
#
|
76
|
+
#
|
73
77
|
# @see Wx::AboutDialogInfo#set_artists
|
74
78
|
# @param artist [String]
|
75
79
|
# @return [void]
|
@@ -77,6 +81,7 @@ module Wx
|
|
77
81
|
|
78
82
|
# Adds a developer name to be shown in the program credits.
|
79
83
|
#
|
84
|
+
#
|
80
85
|
# @see Wx::AboutDialogInfo#set_developers
|
81
86
|
# @param developer [String]
|
82
87
|
# @return [void]
|
@@ -84,12 +89,14 @@ module Wx
|
|
84
89
|
|
85
90
|
# Adds a documentation writer name to be shown in the program credits.
|
86
91
|
#
|
92
|
+
#
|
87
93
|
# @see Wx::AboutDialogInfo#set_doc_writers
|
88
94
|
# @param docwriter [String]
|
89
95
|
# @return [void]
|
90
96
|
def add_doc_writer(docwriter) end
|
91
97
|
|
92
98
|
# Adds a translator name to be shown in the program credits.
|
99
|
+
#
|
93
100
|
# Notice that if no translator names are specified explicitly, {about_box} will try to use the translation of the string <code>translator-credits</code> from the currently used message catalog this can be used to show just the name of the translator of the program in the current language.
|
94
101
|
# @see Wx::AboutDialogInfo#set_translators
|
95
102
|
# @param translator [String]
|
@@ -97,6 +104,7 @@ module Wx
|
|
97
104
|
def add_translator(translator) end
|
98
105
|
|
99
106
|
# Get the name of the program.
|
107
|
+
#
|
100
108
|
# Name of the program
|
101
109
|
# @see Wx::AboutDialogInfo#set_name
|
102
110
|
# @return [String]
|
@@ -105,12 +113,14 @@ module Wx
|
|
105
113
|
|
106
114
|
# Returns true if a description string has been specified.
|
107
115
|
#
|
116
|
+
#
|
108
117
|
# @see Wx::AboutDialogInfo#get_description
|
109
118
|
# @return [Boolean]
|
110
119
|
def has_description; end
|
111
120
|
alias_method :has_description?, :has_description
|
112
121
|
|
113
122
|
# Get the description string.
|
123
|
+
#
|
114
124
|
# The description string, free-form.
|
115
125
|
# @return [Wx::String]
|
116
126
|
def get_description; end
|
@@ -118,12 +128,14 @@ module Wx
|
|
118
128
|
|
119
129
|
# Returns true if a copyright string has been specified.
|
120
130
|
#
|
131
|
+
#
|
121
132
|
# @see Wx::AboutDialogInfo#get_copyright
|
122
133
|
# @return [Boolean]
|
123
134
|
def has_copyright; end
|
124
135
|
alias_method :has_copyright?, :has_copyright
|
125
136
|
|
126
137
|
# Get the copyright string.
|
138
|
+
#
|
127
139
|
# The copyright string
|
128
140
|
# @return [Wx::String]
|
129
141
|
def get_copyright; end
|
@@ -131,6 +143,7 @@ module Wx
|
|
131
143
|
|
132
144
|
# Sets the list of artists to be shown in the program credits.
|
133
145
|
#
|
146
|
+
#
|
134
147
|
# @see Wx::AboutDialogInfo#add_artist
|
135
148
|
# @param artists [Array<String>]
|
136
149
|
# @return [void]
|
@@ -138,6 +151,7 @@ module Wx
|
|
138
151
|
alias_method :artists=, :set_artists
|
139
152
|
|
140
153
|
# Set the short string containing the program copyright information.
|
154
|
+
#
|
141
155
|
# Notice that any occurrences of <code>"(C)"</code> in copyright will be replaced by the copyright symbol (circled C) automatically, which means that you can avoid using this symbol in the program source code which can be problematic,
|
142
156
|
# @param copyright [String]
|
143
157
|
# @return [void]
|
@@ -152,6 +166,7 @@ module Wx
|
|
152
166
|
|
153
167
|
# Set the list of developers of the program.
|
154
168
|
#
|
169
|
+
#
|
155
170
|
# @see Wx::AboutDialogInfo#add_developer
|
156
171
|
# @param developers [Array<String>]
|
157
172
|
# @return [void]
|
@@ -160,6 +175,7 @@ module Wx
|
|
160
175
|
|
161
176
|
# Set the list of documentation writers.
|
162
177
|
#
|
178
|
+
#
|
163
179
|
# @see Wx::AboutDialogInfo#add_doc_writer
|
164
180
|
# @param docwriters [Array<String>]
|
165
181
|
# @return [void]
|
@@ -177,6 +193,7 @@ module Wx
|
|
177
193
|
alias_method :icon, :get_icon
|
178
194
|
|
179
195
|
# Set the icon to be shown in the dialog.
|
196
|
+
#
|
180
197
|
# By default the icon of the main frame will be shown if the native about dialog supports custom icons. If it doesn't but a valid icon is specified using this method, the generic about dialog is used instead so you should avoid calling this function for maximally native look and feel.
|
181
198
|
# @param icon [Wx::Icon]
|
182
199
|
# @return [void]
|
@@ -190,12 +207,14 @@ module Wx
|
|
190
207
|
|
191
208
|
# Returns the licence string.
|
192
209
|
#
|
210
|
+
#
|
193
211
|
# @see Wx::AboutDialogInfo#set_licence
|
194
212
|
# @return [Wx::String]
|
195
213
|
def get_licence; end
|
196
214
|
alias_method :licence, :get_licence
|
197
215
|
|
198
216
|
# Set the long, multiline string containing the text of the program licence.
|
217
|
+
#
|
199
218
|
# Only GTK+ version supports showing the licence text in the native about dialog currently so the generic version will be used under all the other platforms if this method is called. To preserve the native look and feel it is advised that you do not call this method but provide a separate menu item in the <code>"Help"</code> menu for displaying the text of your program licence.
|
200
219
|
# @param licence [String]
|
201
220
|
# @return [void]
|
@@ -209,6 +228,7 @@ module Wx
|
|
209
228
|
alias_method :license=, :set_license
|
210
229
|
|
211
230
|
# Set the name of the program.
|
231
|
+
#
|
212
232
|
# If this method is not called, the string returned by {Wx::App::GetAppName} will be shown in the dialog.
|
213
233
|
# @param name [String]
|
214
234
|
# @return [void]
|
@@ -216,6 +236,7 @@ module Wx
|
|
216
236
|
alias_method :name=, :set_name
|
217
237
|
|
218
238
|
# Set the list of translators.
|
239
|
+
#
|
219
240
|
# Please see {Wx::AboutDialogInfo#add_translator} for additional discussion.
|
220
241
|
# @param translators [Array<String>]
|
221
242
|
# @return [void]
|
@@ -223,6 +244,7 @@ module Wx
|
|
223
244
|
alias_method :translators=, :set_translators
|
224
245
|
|
225
246
|
# Set the version of the program.
|
247
|
+
#
|
226
248
|
# The word "version" shouldn't be included in version. Example version values: "1.2" and "RC2". In about dialogs with more space set aside for version information, longVersion is used. Example longVersion values: "Version 1.2" and "Release Candidate 2". If version is non-empty but longVersion is empty, a long version is constructed automatically, using version (by simply prepending "Version " to version).
|
227
249
|
# The generic about dialog and native GTK+ dialog use version only, as a suffix to the program name. The native MSW and macOS about dialogs use the long version.
|
228
250
|
# @param version [String]
|
@@ -233,6 +255,7 @@ module Wx
|
|
233
255
|
|
234
256
|
# Return the short version string.
|
235
257
|
#
|
258
|
+
#
|
236
259
|
# @see Wx::AboutDialogInfo#set_version
|
237
260
|
# @return [Wx::String]
|
238
261
|
def get_version; end
|
@@ -240,6 +263,7 @@ module Wx
|
|
240
263
|
|
241
264
|
# Return the long version string if set.
|
242
265
|
#
|
266
|
+
#
|
243
267
|
# @see Wx::AboutDialogInfo#set_version
|
244
268
|
# @return [Wx::String]
|
245
269
|
def get_long_version; end
|
@@ -261,6 +285,7 @@ module Wx
|
|
261
285
|
alias_method :web_site_description, :get_web_site_description
|
262
286
|
|
263
287
|
# Set the web site for the program and its description (which defaults to url itself if empty).
|
288
|
+
#
|
264
289
|
# Please notice that only GTK+ version currently supports showing the link in the native about dialog so if this method is called, the generic version will be used under all the other platforms.
|
265
290
|
# @param url [String]
|
266
291
|
# @param desc [String]
|
@@ -44,6 +44,7 @@ module Wx
|
|
44
44
|
NULL_ACCELERATOR_TABLE = nil
|
45
45
|
|
46
46
|
# An object used by an application wishing to create an accelerator table (see {Wx::AcceleratorTable}).
|
47
|
+
#
|
47
48
|
# Category: Data Structures
|
48
49
|
# @see Wx::AcceleratorTable
|
49
50
|
# @see Wx::Window#set_accelerator_table
|
@@ -99,17 +100,20 @@ module Wx
|
|
99
100
|
alias_method :ok?, :is_ok
|
100
101
|
|
101
102
|
# Returns a textual representation of this accelerator.
|
103
|
+
#
|
102
104
|
# The returned string is of the form <code>[Alt+][Ctrl+][RawCtrl+][Shift+]Key</code> where the modifier keys are present only if the corresponding flag is set.
|
103
105
|
# @return [String]
|
104
106
|
def to_string; end
|
105
107
|
|
106
108
|
# Returns a textual representation of this accelerator which is appropriate for saving in configuration files.
|
109
|
+
#
|
107
110
|
# Unlike the string returned by {Wx::AcceleratorEntry#to_string}, this one is never translated so, while it's not suitable for showing to the user, it can be used to uniquely identify the accelerator independently of the user language.
|
108
111
|
# The returned string can still be parsed by {Wx::AcceleratorEntry#from_string}.
|
109
112
|
# @return [String]
|
110
113
|
def to_raw_string; end
|
111
114
|
|
112
115
|
# Parses the given string and sets the accelerator accordingly.
|
116
|
+
#
|
113
117
|
# true if the given string correctly initialized this object (i.e. if {Wx::AcceleratorEntry#is_ok} returns true after this call)
|
114
118
|
# @param str [String] This string may be either in the same format as returned by {Wx::AcceleratorEntry#to_string}, i.e. contain the accelerator itself only, or have the format of a full menu item text with i.e. <code>Label TAB Accelerator</code>. In the latter case, the part of the string before the TAB is ignored. Notice that the latter format is only supported for the compatibility with the previous wxWidgets versions and the new code should pass only the accelerator string itself to this function.
|
115
119
|
# @return [Boolean]
|
@@ -122,6 +126,7 @@ module Wx
|
|
122
126
|
end # AcceleratorEntry
|
123
127
|
|
124
128
|
# An accelerator table allows the application to specify a table of keyboard shortcuts for menu or button commands.
|
129
|
+
#
|
125
130
|
# The object {Wx::NULL_ACCELERATOR_TABLE} is defined to be a table with no data, and is the initial accelerator table for a window.
|
126
131
|
# Example:
|
127
132
|
# ```ruby
|
@@ -138,7 +143,7 @@ module Wx
|
|
138
143
|
# <b>Remark:</b>
|
139
144
|
# <p>An accelerator takes precedence over normal processing and can be a convenient way to program some event handling. For example, you can use an accelerator table to enable a dialog with a multi-line text control to accept CTRL-Enter as meaning 'OK'.
|
140
145
|
# </p>
|
141
|
-
# </div
|
146
|
+
# </div>
|
142
147
|
#
|
143
148
|
# Category: Data Structures
|
144
149
|
# Predefined objects/pointers: {Wx::NULL_ACCELERATOR_TABLE}
|
@@ -158,6 +163,7 @@ module Wx
|
|
158
163
|
# @return [Wx::AcceleratorTable]
|
159
164
|
# @overload initialize(resource)
|
160
165
|
# Loads the accelerator table from a Windows resource (Windows only).
|
166
|
+
#
|
161
167
|
# Availability: only available for the WXMSW port.
|
162
168
|
# @param resource [String] Name of a Windows accelerator.
|
163
169
|
# @return [Wx::AcceleratorTable]
|
@@ -635,6 +635,7 @@ module Wx
|
|
635
635
|
end # AccSelectionFlags
|
636
636
|
|
637
637
|
# The {Wx::Accessible} class allows wxWidgets applications, and wxWidgets itself, to return extended information about user interface elements to client applications such as screen readers.
|
638
|
+
#
|
638
639
|
# This is the main way in which wxWidgets implements accessibility features.
|
639
640
|
# At present, only Microsoft Active Accessibility is supported by this class.
|
640
641
|
# To use this class, derive from {Wx::Accessible}, implement appropriate functions, and associate an object of the class with a window using {Wx::Window#set_accessible}.
|
@@ -653,12 +654,14 @@ module Wx
|
|
653
654
|
class Accessible < Object
|
654
655
|
|
655
656
|
# Constructor, taking an optional window.
|
657
|
+
#
|
656
658
|
# The object can be associated with a window later.
|
657
659
|
# @param win [Wx::Window]
|
658
660
|
# @return [Wx::Accessible]
|
659
661
|
def initialize(win=nil) end
|
660
662
|
|
661
663
|
# Performs the default action for the object.
|
664
|
+
#
|
662
665
|
# childId is 0 (the action for this object) or greater than 0 (the action for a child).
|
663
666
|
# {Wx::AccStatus::ACC_NOT_SUPPORTED} if there is no default action for this window (e.g. an edit control).
|
664
667
|
# @param childId [Integer]
|
@@ -666,6 +669,7 @@ module Wx
|
|
666
669
|
def do_default_action(childId) end
|
667
670
|
|
668
671
|
# Gets the specified child (starting from 1).
|
672
|
+
#
|
669
673
|
# If child is NULL and the return value is {Wx::AccStatus::ACC_OK}, this means that the child is a simple element and not an accessible object.
|
670
674
|
# @param childId [Integer]
|
671
675
|
# @return [Array(Wx::AccStatus,Wx::Accessible)]
|
@@ -678,6 +682,7 @@ module Wx
|
|
678
682
|
alias_method :child_count, :get_child_count
|
679
683
|
|
680
684
|
# Gets the default action for this object (0) or a child (greater than 0).
|
685
|
+
#
|
681
686
|
# Return {Wx::AccStatus::ACC_OK} even if there is no action. actionName is the action, or the empty string if there is no action. The retrieved string describes the action that is performed on an object, not what the object does as a result. For example, a toolbar button that prints a document has a default action of "Press" rather than "Prints
|
682
687
|
# the current document."
|
683
688
|
# @param childId [Integer]
|
@@ -692,6 +697,7 @@ module Wx
|
|
692
697
|
alias_method :description, :get_description
|
693
698
|
|
694
699
|
# Gets the window with the keyboard focus.
|
700
|
+
#
|
695
701
|
# If childId is 0 and child is NULL, no object in this subhierarchy has the focus. If this object has the focus, child should be 'this'.
|
696
702
|
# @return [Array(Wx::AccStatus,Integer,Wx::Accessible)]
|
697
703
|
def get_focus; end
|
@@ -704,6 +710,7 @@ module Wx
|
|
704
710
|
alias_method :help_text, :get_help_text
|
705
711
|
|
706
712
|
# Returns the keyboard shortcut for this object or child.
|
713
|
+
#
|
707
714
|
# Returns e.g. ALT+K.
|
708
715
|
# @param childId [Integer]
|
709
716
|
# @return [Array(Wx::AccStatus,String)]
|
@@ -711,6 +718,7 @@ module Wx
|
|
711
718
|
alias_method :keyboard_shortcut, :get_keyboard_shortcut
|
712
719
|
|
713
720
|
# Returns the rectangle for this object (id is 0) or a child element (id is greater than 0).
|
721
|
+
#
|
714
722
|
# rect is in screen coordinates.
|
715
723
|
# @param rect [Wx::Rect]
|
716
724
|
# @param elementId [Integer]
|
@@ -730,6 +738,7 @@ module Wx
|
|
730
738
|
alias_method :parent, :get_parent
|
731
739
|
|
732
740
|
# Returns a role constant describing this object.
|
741
|
+
#
|
733
742
|
# See {Wx::AccRole} for a list of these roles.
|
734
743
|
# @param childId [Integer]
|
735
744
|
# @return [Array(Wx::AccStatus,Wx::AccRole)]
|
@@ -737,6 +746,7 @@ module Wx
|
|
737
746
|
alias_method :role, :get_role
|
738
747
|
|
739
748
|
# Gets a variant representing the selected children of this object.
|
749
|
+
#
|
740
750
|
# Acceptable values are:
|
741
751
|
#
|
742
752
|
# - a null variant (<code>IsNull()</code> returns true) if no children are selected
|
@@ -752,6 +762,7 @@ module Wx
|
|
752
762
|
alias_method :selections, :get_selections
|
753
763
|
|
754
764
|
# Returns a state constant.
|
765
|
+
#
|
755
766
|
# See {Wx::AccStatus} for a list of these states.
|
756
767
|
# @param childId [Integer]
|
757
768
|
# @return [Array(Wx::AccStatus,Integer)]
|
@@ -770,6 +781,7 @@ module Wx
|
|
770
781
|
alias_method :window, :get_window
|
771
782
|
|
772
783
|
# Returns a status value and object id to indicate whether the given point was on this or a child object.
|
784
|
+
#
|
773
785
|
# Can return either a child object, or an integer representing the child element, starting from 1.
|
774
786
|
# pt is in screen coordinates.
|
775
787
|
# @param pt [Array(Integer, Integer), Wx::Point]
|
@@ -783,6 +795,7 @@ module Wx
|
|
783
795
|
def navigate(navDir, fromId) end
|
784
796
|
|
785
797
|
# Selects the object or child.
|
798
|
+
#
|
786
799
|
# See {Wx::AccSelectionFlags} for a list of the selection actions.
|
787
800
|
# @param childId [Integer]
|
788
801
|
# @param selectFlags [Wx::AccSelectionFlags]
|
@@ -7,6 +7,7 @@
|
|
7
7
|
module Wx
|
8
8
|
|
9
9
|
# Small control showing an animation indicating that the program is currently busy performing some background task.
|
10
|
+
#
|
10
11
|
# Category: {Wx::Controls} <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
|
11
12
|
# </td><td> WXGTK Appearance
|
12
13
|
# </td><td> WXOSX Appearance
|
@@ -17,10 +18,12 @@ module Wx
|
|
17
18
|
|
18
19
|
# @overload initialize()
|
19
20
|
# Default constructor.
|
21
|
+
#
|
20
22
|
# Use {Wx::ActivityIndicator#create} to really create the control after using this constructor.
|
21
23
|
# @return [Wx::ActivityIndicator]
|
22
24
|
# @overload initialize(parent, winid=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=("ACTIVITYINDICATOR"))
|
23
25
|
# Constructor fully creating the control.
|
26
|
+
#
|
24
27
|
# The arguments have the usual meanings and only parent is typically required.
|
25
28
|
# @param parent [Wx::Window]
|
26
29
|
# @param winid [Integer]
|
@@ -32,6 +35,7 @@ module Wx
|
|
32
35
|
def initialize(*args) end
|
33
36
|
|
34
37
|
# Create the control initialized using the default constructor.
|
38
|
+
#
|
35
39
|
# This method can be used to finish the control creation if it hadn't been done already by using the non-default constructor.
|
36
40
|
# @param parent [Wx::Window]
|
37
41
|
# @param winid [Integer]
|
@@ -43,16 +47,19 @@ module Wx
|
|
43
47
|
def create(parent, winid=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=("ACTIVITYINDICATOR")) end
|
44
48
|
|
45
49
|
# Starts animation of the indicator.
|
50
|
+
#
|
46
51
|
# Does nothing if the indicator is already running.
|
47
52
|
# @return [void]
|
48
53
|
def start; end
|
49
54
|
|
50
55
|
# Stops the animation of the indicator.
|
56
|
+
#
|
51
57
|
# Notice that the animation is stopped even if {Wx::ActivityIndicator#start} had been called multiple times before, i.e. the calls are not cumulative.
|
52
58
|
# @return [void]
|
53
59
|
def stop; end
|
54
60
|
|
55
61
|
# Returns true if the control is currently showing activity.
|
62
|
+
#
|
56
63
|
# Returns false initially, true once {Wx::ActivityIndicator#start} is called and false again after calling {Wx::ActivityIndicator#stop}.
|
57
64
|
# @return [Boolean]
|
58
65
|
def is_running; end
|