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.
Files changed (646) hide show
  1. checksums.yaml +4 -4
  2. data/INSTALL.md +35 -29
  3. data/README.md +24 -15
  4. data/ext/wxbase32u_gcc_custom.dll +0 -0
  5. data/ext/wxbase32u_net_gcc_custom.dll +0 -0
  6. data/ext/wxbase32u_xml_gcc_custom.dll +0 -0
  7. data/ext/wxmsw32u_aui_gcc_custom.dll +0 -0
  8. data/ext/wxmsw32u_core_gcc_custom.dll +0 -0
  9. data/ext/wxmsw32u_gl_gcc_custom.dll +0 -0
  10. data/ext/wxmsw32u_html_gcc_custom.dll +0 -0
  11. data/ext/wxmsw32u_media_gcc_custom.dll +0 -0
  12. data/ext/wxmsw32u_propgrid_gcc_custom.dll +0 -0
  13. data/ext/wxmsw32u_qa_gcc_custom.dll +0 -0
  14. data/ext/wxmsw32u_ribbon_gcc_custom.dll +0 -0
  15. data/ext/wxmsw32u_richtext_gcc_custom.dll +0 -0
  16. data/ext/wxmsw32u_stc_gcc_custom.dll +0 -0
  17. data/ext/wxmsw32u_webview_gcc_custom.dll +0 -0
  18. data/ext/wxmsw32u_xrc_gcc_custom.dll +0 -0
  19. data/lib/wx/core/bitmap_combobox.rb +17 -21
  20. data/lib/wx/core/combobox.rb +13 -3
  21. data/lib/wx/core/controlwithitems.rb +40 -130
  22. data/lib/wx/core/enum.rb +17 -1
  23. data/lib/wx/core/event.rb +6 -1
  24. data/lib/wx/core/events/evt_list.rb +5 -4
  25. data/lib/wx/core/evthandler.rb +8 -2
  26. data/lib/wx/core/generic_validator.rb +312 -0
  27. data/lib/wx/core/listbox.rb +2 -2
  28. data/lib/wx/core/log.rb +1 -1
  29. data/lib/wx/core/owner_drawn_combobox.rb +45 -0
  30. data/lib/wx/core/size.rb +4 -0
  31. data/lib/wx/core/sizer.rb +1 -2
  32. data/lib/wx/core/standard_paths.rb +22 -0
  33. data/lib/wx/core/text_entry.rb +4 -1
  34. data/lib/wx/core/validator.rb +70 -5
  35. data/lib/wx/core/window.rb +3 -7
  36. data/lib/wx/doc/art_locator.rb +1 -0
  37. data/lib/wx/doc/comboctrl.rb +18 -0
  38. data/lib/wx/doc/controlwithitems.rb +16 -0
  39. data/lib/wx/doc/date_picker_ctrl.rb +23 -0
  40. data/lib/wx/doc/editable_listbox.rb +44 -0
  41. data/lib/wx/doc/enum.rb +15 -0
  42. data/lib/wx/doc/event.rb +12 -0
  43. data/lib/wx/doc/extra/12_client_data.md +89 -0
  44. data/lib/wx/doc/extra/13_validators.md +139 -0
  45. data/lib/wx/doc/gdi_common.rb +4 -0
  46. data/lib/wx/doc/gen/about_dialog_info.rb +25 -0
  47. data/lib/wx/doc/gen/accelerator.rb +7 -1
  48. data/lib/wx/doc/gen/accessible.rb +13 -0
  49. data/lib/wx/doc/gen/activity_indicator.rb +7 -0
  50. data/lib/wx/doc/gen/animation.rb +12 -0
  51. data/lib/wx/doc/gen/animation_ctrl.rb +10 -0
  52. data/lib/wx/doc/gen/any_button.rb +17 -1
  53. data/lib/wx/doc/gen/app.rb +35 -1
  54. data/lib/wx/doc/gen/app_traits.rb +38 -5
  55. data/lib/wx/doc/gen/art_provider.rb +14 -0
  56. data/lib/wx/doc/gen/aui/aui_dock_art.rb +12 -0
  57. data/lib/wx/doc/gen/aui/aui_floating_frame.rb +1 -0
  58. data/lib/wx/doc/gen/aui/aui_manager.rb +24 -1
  59. data/lib/wx/doc/gen/aui/aui_manager_event.rb +9 -1
  60. data/lib/wx/doc/gen/aui/aui_mdi_child_frame.rb +3 -0
  61. data/lib/wx/doc/gen/aui/aui_mdi_client_window.rb +2 -0
  62. data/lib/wx/doc/gen/aui/aui_mdi_parent_frame.rb +3 -1
  63. data/lib/wx/doc/gen/aui/aui_notebook.rb +20 -2
  64. data/lib/wx/doc/gen/aui/aui_notebook_event.rb +2 -1
  65. data/lib/wx/doc/gen/aui/aui_pane_info.rb +30 -1
  66. data/lib/wx/doc/gen/aui/aui_tab_art.rb +6 -0
  67. data/lib/wx/doc/gen/aui/aui_tab_ctrl.rb +1 -0
  68. data/lib/wx/doc/gen/aui/aui_tool_bar.rb +11 -0
  69. data/lib/wx/doc/gen/aui/aui_tool_bar_art.rb +2 -0
  70. data/lib/wx/doc/gen/aui/aui_tool_bar_event.rb +2 -1
  71. data/lib/wx/doc/gen/aui/aui_tool_bar_item.rb +4 -0
  72. data/lib/wx/doc/gen/banner_window.rb +7 -0
  73. data/lib/wx/doc/gen/bitmap.rb +64 -3
  74. data/lib/wx/doc/gen/bitmap_button.rb +6 -1
  75. data/lib/wx/doc/gen/bitmap_combo_box.rb +9 -3
  76. data/lib/wx/doc/gen/book_ctrl_base.rb +17 -2
  77. data/lib/wx/doc/gen/book_ctrl_event.rb +3 -1
  78. data/lib/wx/doc/gen/box_sizer.rb +5 -0
  79. data/lib/wx/doc/gen/brush.rb +16 -1
  80. data/lib/wx/doc/gen/busy_info.rb +8 -0
  81. data/lib/wx/doc/gen/button.rb +11 -3
  82. data/lib/wx/doc/gen/calculate_layout_event.rb +4 -0
  83. data/lib/wx/doc/gen/calendar_ctrl.rb +22 -0
  84. data/lib/wx/doc/gen/calendar_date_attr.rb +1 -0
  85. data/lib/wx/doc/gen/calendar_event.rb +3 -1
  86. data/lib/wx/doc/gen/caret.rb +3 -0
  87. data/lib/wx/doc/gen/check_box.rb +10 -0
  88. data/lib/wx/doc/gen/check_list_box.rb +3 -0
  89. data/lib/wx/doc/gen/choice.rb +14 -2
  90. data/lib/wx/doc/gen/choicebook.rb +1 -0
  91. data/lib/wx/doc/gen/client_dc.rb +1 -0
  92. data/lib/wx/doc/gen/clipboard.rb +9 -0
  93. data/lib/wx/doc/gen/collapsible_pane.rb +3 -0
  94. data/lib/wx/doc/gen/collapsible_pane_event.rb +1 -0
  95. data/lib/wx/doc/gen/colour.rb +20 -0
  96. data/lib/wx/doc/gen/colour_dialog.rb +10 -0
  97. data/lib/wx/doc/gen/colour_picker_ctrl.rb +4 -0
  98. data/lib/wx/doc/gen/colour_picker_event.rb +1 -0
  99. data/lib/wx/doc/gen/combo_box.rb +20 -1
  100. data/lib/wx/doc/gen/combo_ctrl.rb +54 -295
  101. data/lib/wx/doc/gen/command_link_button.rb +8 -0
  102. data/lib/wx/doc/gen/context_help_button.rb +7 -1
  103. data/lib/wx/doc/gen/control.rb +12 -0
  104. data/lib/wx/doc/gen/control_with_items.rb +45 -9
  105. data/lib/wx/doc/gen/core.rb +2 -2
  106. data/lib/wx/doc/gen/cursor.rb +4 -0
  107. data/lib/wx/doc/gen/data_format.rb +1 -0
  108. data/lib/wx/doc/gen/data_object.rb +27 -5
  109. data/lib/wx/doc/gen/date_event.rb +2 -1
  110. data/lib/wx/doc/gen/date_picker_ctrl.rb +7 -1
  111. data/lib/wx/doc/gen/dc.rb +87 -3
  112. data/lib/wx/doc/gen/dial_up_event.rb +2 -0
  113. data/lib/wx/doc/gen/dial_up_manager.rb +12 -0
  114. data/lib/wx/doc/gen/dialog.rb +42 -3
  115. data/lib/wx/doc/gen/dir_dialog.rb +6 -1
  116. data/lib/wx/doc/gen/dir_filter_list_ctrl.rb +1 -0
  117. data/lib/wx/doc/gen/dir_picker_ctrl.rb +5 -0
  118. data/lib/wx/doc/gen/drag_drop.rb +20 -0
  119. data/lib/wx/doc/gen/drag_image.rb +7 -0
  120. data/lib/wx/doc/gen/editable_list_box.rb +5 -3
  121. data/lib/wx/doc/gen/event.rb +26 -11
  122. data/lib/wx/doc/gen/event_blocker.rb +2 -1
  123. data/lib/wx/doc/gen/event_filter.rb +3 -0
  124. data/lib/wx/doc/gen/event_list.rb +4 -4
  125. data/lib/wx/doc/gen/events.rb +165 -26
  126. data/lib/wx/doc/gen/evt_handler.rb +40 -2
  127. data/lib/wx/doc/gen/ext_help_controller.rb +9 -0
  128. data/lib/wx/doc/gen/file_ctrl.rb +11 -2
  129. data/lib/wx/doc/gen/file_ctrl_event.rb +5 -1
  130. data/lib/wx/doc/gen/file_dialog.rb +13 -0
  131. data/lib/wx/doc/gen/file_dialog_custom_control.rb +12 -0
  132. data/lib/wx/doc/gen/file_dialog_customize_hook.rb +9 -0
  133. data/lib/wx/doc/gen/file_dir_picker_event.rb +2 -1
  134. data/lib/wx/doc/gen/file_picker_ctrl.rb +4 -0
  135. data/lib/wx/doc/gen/file_system.rb +17 -1
  136. data/lib/wx/doc/gen/find_dialog_event.rb +2 -1
  137. data/lib/wx/doc/gen/find_replace_data.rb +1 -0
  138. data/lib/wx/doc/gen/find_replace_dialog.rb +3 -0
  139. data/lib/wx/doc/gen/flex_grid_sizer.rb +13 -0
  140. data/lib/wx/doc/gen/font.rb +75 -3
  141. data/lib/wx/doc/gen/font_data.rb +14 -0
  142. data/lib/wx/doc/gen/font_dialog.rb +6 -0
  143. data/lib/wx/doc/gen/font_picker_ctrl.rb +8 -0
  144. data/lib/wx/doc/gen/font_picker_event.rb +1 -0
  145. data/lib/wx/doc/gen/frame.rb +24 -7
  146. data/lib/wx/doc/gen/fs_file.rb +22 -0
  147. data/lib/wx/doc/gen/gauge.rb +8 -0
  148. data/lib/wx/doc/gen/gb_sizer_item.rb +5 -0
  149. data/lib/wx/doc/gen/gcdc.rb +2 -0
  150. data/lib/wx/doc/gen/gdi_common.rb +50 -0
  151. data/lib/wx/doc/gen/gdi_object.rb +1 -0
  152. data/lib/wx/doc/gen/generic_dir_ctrl.rb +7 -0
  153. data/lib/wx/doc/gen/graphics_context.rb +36 -7
  154. data/lib/wx/doc/gen/graphics_object.rb +24 -0
  155. data/lib/wx/doc/gen/grid/grid_cell_activatable_editor.rb +2 -0
  156. data/lib/wx/doc/gen/grid/grid_cell_attr.rb +14 -2
  157. data/lib/wx/doc/gen/grid/grid_cell_auto_wrap_string_editor.rb +1 -0
  158. data/lib/wx/doc/gen/grid/grid_cell_auto_wrap_string_renderer.rb +1 -0
  159. data/lib/wx/doc/gen/grid/grid_cell_bool_editor.rb +2 -0
  160. data/lib/wx/doc/gen/grid/grid_cell_bool_renderer.rb +1 -0
  161. data/lib/wx/doc/gen/grid/grid_cell_choice_editor.rb +2 -0
  162. data/lib/wx/doc/gen/grid/grid_cell_date_editor.rb +1 -0
  163. data/lib/wx/doc/gen/grid/grid_cell_date_renderer.rb +1 -0
  164. data/lib/wx/doc/gen/grid/grid_cell_date_time_renderer.rb +1 -0
  165. data/lib/wx/doc/gen/grid/grid_cell_editor.rb +9 -0
  166. data/lib/wx/doc/gen/grid/grid_cell_enum_editor.rb +1 -0
  167. data/lib/wx/doc/gen/grid/grid_cell_enum_renderer.rb +1 -0
  168. data/lib/wx/doc/gen/grid/grid_cell_float_editor.rb +1 -0
  169. data/lib/wx/doc/gen/grid/grid_cell_float_renderer.rb +2 -0
  170. data/lib/wx/doc/gen/grid/grid_cell_number_editor.rb +2 -0
  171. data/lib/wx/doc/gen/grid/grid_cell_number_renderer.rb +1 -0
  172. data/lib/wx/doc/gen/grid/grid_cell_renderer.rb +6 -0
  173. data/lib/wx/doc/gen/grid/grid_cell_string_renderer.rb +1 -0
  174. data/lib/wx/doc/gen/grid/grid_cell_text_editor.rb +1 -0
  175. data/lib/wx/doc/gen/grid/grid_ctrl.rb +229 -7
  176. data/lib/wx/doc/gen/grid/grid_editor_created_event.rb +4 -1
  177. data/lib/wx/doc/gen/grid/grid_event.rb +4 -1
  178. data/lib/wx/doc/gen/grid/grid_range_select_event.rb +2 -1
  179. data/lib/wx/doc/gen/grid/grid_size_event.rb +2 -1
  180. data/lib/wx/doc/gen/grid/grid_string_table.rb +7 -0
  181. data/lib/wx/doc/gen/grid/grid_table_base.rb +27 -1
  182. data/lib/wx/doc/gen/grid/grid_table_message.rb +1 -0
  183. data/lib/wx/doc/gen/grid_bag_sizer.rb +24 -4
  184. data/lib/wx/doc/gen/grid_sizer.rb +11 -0
  185. data/lib/wx/doc/gen/gui_event_loop.rb +12 -0
  186. data/lib/wx/doc/gen/header_ctrl.rb +106 -0
  187. data/lib/wx/doc/gen/header_ctrl_event.rb +5 -1
  188. data/lib/wx/doc/gen/help_controller.rb +11 -0
  189. data/lib/wx/doc/gen/help_provider.rb +12 -3
  190. data/lib/wx/doc/gen/html/html_cell.rb +25 -0
  191. data/lib/wx/doc/gen/html/html_cell_event.rb +3 -1
  192. data/lib/wx/doc/gen/html/html_easy_printing.rb +13 -1
  193. data/lib/wx/doc/gen/html/html_help_controller.rb +18 -0
  194. data/lib/wx/doc/gen/html/html_help_data.rb +5 -0
  195. data/lib/wx/doc/gen/html/html_help_window.rb +8 -0
  196. data/lib/wx/doc/gen/html/html_link_event.rb +1 -0
  197. data/lib/wx/doc/gen/html/html_list_box.rb +49 -9
  198. data/lib/wx/doc/gen/html/html_printout.rb +7 -0
  199. data/lib/wx/doc/gen/html/html_window.rb +31 -0
  200. data/lib/wx/doc/gen/hyperlink_ctrl.rb +2 -1
  201. data/lib/wx/doc/gen/hyperlink_event.rb +1 -0
  202. data/lib/wx/doc/gen/icon.rb +19 -1
  203. data/lib/wx/doc/gen/icon_location.rb +1 -0
  204. data/lib/wx/doc/gen/image.rb +67 -10
  205. data/lib/wx/doc/gen/image_list.rb +12 -2
  206. data/lib/wx/doc/gen/info_bar.rb +12 -0
  207. data/lib/wx/doc/gen/keyboard_state.rb +11 -0
  208. data/lib/wx/doc/gen/list_box.rb +20 -3
  209. data/lib/wx/doc/gen/list_ctrl.rb +89 -0
  210. data/lib/wx/doc/gen/list_event.rb +11 -1
  211. data/lib/wx/doc/gen/listbook.rb +1 -0
  212. data/lib/wx/doc/gen/locale.rb +22 -0
  213. data/lib/wx/doc/gen/log.rb +42 -0
  214. data/lib/wx/doc/gen/mdi_client_window.rb +4 -1
  215. data/lib/wx/doc/gen/mdi_frame.rb +27 -4
  216. data/lib/wx/doc/gen/media_ctrl.rb +17 -0
  217. data/lib/wx/doc/gen/media_event.rb +2 -1
  218. data/lib/wx/doc/gen/memory_dc.rb +10 -0
  219. data/lib/wx/doc/gen/menu.rb +48 -7
  220. data/lib/wx/doc/gen/menu_bar.rb +32 -13
  221. data/lib/wx/doc/gen/menu_item.rb +26 -0
  222. data/lib/wx/doc/gen/message_dialog.rb +10 -0
  223. data/lib/wx/doc/gen/mini_frame.rb +5 -2
  224. data/lib/wx/doc/gen/mirror_dc.rb +1 -0
  225. data/lib/wx/doc/gen/mouse_state.rb +1 -0
  226. data/lib/wx/doc/gen/multi_choice_dialog.rb +3 -1
  227. data/lib/wx/doc/gen/non_owned_window.rb +3 -0
  228. data/lib/wx/doc/gen/notebook.rb +11 -1
  229. data/lib/wx/doc/gen/num_validator.rb +37 -0
  230. data/lib/wx/doc/gen/number_entry_dialog.rb +4 -0
  231. data/lib/wx/doc/gen/object.rb +3 -0
  232. data/lib/wx/doc/gen/owner_drawn_combo_box.rb +340 -0
  233. data/lib/wx/doc/gen/paint_dc.rb +1 -0
  234. data/lib/wx/doc/gen/palette.rb +5 -0
  235. data/lib/wx/doc/gen/panel.rb +10 -2
  236. data/lib/wx/doc/gen/pen.rb +30 -1
  237. data/lib/wx/doc/gen/pg/numeric_property_validator.rb +2 -1
  238. data/lib/wx/doc/gen/pg/pg_array_editor_dialog.rb +4 -1
  239. data/lib/wx/doc/gen/pg/pg_cell.rb +6 -1
  240. data/lib/wx/doc/gen/pg/pg_editor.rb +61 -15
  241. data/lib/wx/doc/gen/pg/pg_multi_button.rb +2 -0
  242. data/lib/wx/doc/gen/pg/pg_properties.rb +198 -81
  243. data/lib/wx/doc/gen/pg/pg_property.rb +129 -52
  244. data/lib/wx/doc/gen/pg/pg_validation_info.rb +2 -0
  245. data/lib/wx/doc/gen/pg/property_grid.rb +56 -14
  246. data/lib/wx/doc/gen/pg/property_grid_event.rb +16 -6
  247. data/lib/wx/doc/gen/pg/property_grid_interface.rb +98 -37
  248. data/lib/wx/doc/gen/pg/property_grid_manager.rb +29 -7
  249. data/lib/wx/doc/gen/pg/property_grid_page.rb +11 -4
  250. data/lib/wx/doc/gen/pg/property_grid_page_state.rb +7 -2
  251. data/lib/wx/doc/gen/picker_base.rb +11 -1
  252. data/lib/wx/doc/gen/platform_info.rb +31 -0
  253. data/lib/wx/doc/gen/popup_window.rb +5 -0
  254. data/lib/wx/doc/gen/progress_dialog.rb +4 -0
  255. data/lib/wx/doc/gen/property_sheet_dialog.rb +7 -1
  256. data/lib/wx/doc/gen/prt/page_setup_dialog.rb +2 -0
  257. data/lib/wx/doc/gen/prt/post_script_dc.rb +1 -0
  258. data/lib/wx/doc/gen/prt/preview_frame.rb +4 -0
  259. data/lib/wx/doc/gen/prt/print_abort_dialog.rb +1 -0
  260. data/lib/wx/doc/gen/prt/print_data.rb +27 -0
  261. data/lib/wx/doc/gen/prt/print_dialog.rb +4 -0
  262. data/lib/wx/doc/gen/prt/printer.rb +42 -5
  263. data/lib/wx/doc/gen/prt/printer_dc.rb +2 -0
  264. data/lib/wx/doc/gen/query_layout_info_event.rb +9 -0
  265. data/lib/wx/doc/gen/radio_box.rb +19 -0
  266. data/lib/wx/doc/gen/radio_button.rb +9 -0
  267. data/lib/wx/doc/gen/rbn/ribbon_art_provider.rb +63 -0
  268. data/lib/wx/doc/gen/rbn/ribbon_bar.rb +23 -0
  269. data/lib/wx/doc/gen/rbn/ribbon_bar_event.rb +2 -1
  270. data/lib/wx/doc/gen/rbn/ribbon_button_bar.rb +35 -9
  271. data/lib/wx/doc/gen/rbn/ribbon_button_bar_event.rb +2 -1
  272. data/lib/wx/doc/gen/rbn/ribbon_control.rb +10 -0
  273. data/lib/wx/doc/gen/rbn/ribbon_gallery.rb +17 -7
  274. data/lib/wx/doc/gen/rbn/ribbon_gallery_event.rb +2 -1
  275. data/lib/wx/doc/gen/rbn/ribbon_page.rb +12 -0
  276. data/lib/wx/doc/gen/rbn/ribbon_panel.rb +11 -0
  277. data/lib/wx/doc/gen/rbn/ribbon_panel_event.rb +2 -1
  278. data/lib/wx/doc/gen/rbn/ribbon_tool_bar.rb +25 -0
  279. data/lib/wx/doc/gen/rbn/ribbon_tool_bar_event.rb +2 -1
  280. data/lib/wx/doc/gen/rearrange_ctrl.rb +4 -0
  281. data/lib/wx/doc/gen/rearrange_list.rb +9 -0
  282. data/lib/wx/doc/gen/region.rb +42 -13
  283. data/lib/wx/doc/gen/region_iterator.rb +1 -0
  284. data/lib/wx/doc/gen/rtc/rich_text_box.rb +25 -8
  285. data/lib/wx/doc/gen/rtc/rich_text_buffer.rb +41 -4
  286. data/lib/wx/doc/gen/rtc/rich_text_buffer_data_object.rb +1 -0
  287. data/lib/wx/doc/gen/rtc/rich_text_composite_object.rb +23 -11
  288. data/lib/wx/doc/gen/rtc/rich_text_ctrl.rb +74 -0
  289. data/lib/wx/doc/gen/rtc/rich_text_event.rb +6 -1
  290. data/lib/wx/doc/gen/rtc/rich_text_file_handler.rb +8 -0
  291. data/lib/wx/doc/gen/rtc/rich_text_formatting_dialog.rb +6 -0
  292. data/lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb +1 -0
  293. data/lib/wx/doc/gen/rtc/rich_text_html_handler.rb +4 -0
  294. data/lib/wx/doc/gen/rtc/rich_text_image.rb +7 -0
  295. data/lib/wx/doc/gen/rtc/rich_text_object.rb +64 -4
  296. data/lib/wx/doc/gen/rtc/rich_text_paragraph_layout_box.rb +51 -4
  297. data/lib/wx/doc/gen/rtc/rich_text_printing.rb +13 -0
  298. data/lib/wx/doc/gen/rtc/rich_text_style_list_box.rb +9 -4
  299. data/lib/wx/doc/gen/rtc/rich_text_style_organiser_dialog.rb +3 -0
  300. data/lib/wx/doc/gen/rtc/rich_text_xml_handler.rb +2 -0
  301. data/lib/wx/doc/gen/rtc/symbol_picker_dialog.rb +1 -0
  302. data/lib/wx/doc/gen/sash_event.rb +5 -1
  303. data/lib/wx/doc/gen/sash_layout_window.rb +10 -0
  304. data/lib/wx/doc/gen/sash_window.rb +3 -0
  305. data/lib/wx/doc/gen/screen_dc.rb +1 -0
  306. data/lib/wx/doc/gen/scroll_bar.rb +11 -2
  307. data/lib/wx/doc/gen/scrolled_canvas.rb +20 -4
  308. data/lib/wx/doc/gen/scrolled_control.rb +20 -4
  309. data/lib/wx/doc/gen/scrolled_window.rb +20 -4
  310. data/lib/wx/doc/gen/search_ctrl.rb +6 -0
  311. data/lib/wx/doc/gen/simplebook.rb +7 -0
  312. data/lib/wx/doc/gen/single_choice_dialog.rb +3 -1
  313. data/lib/wx/doc/gen/sizer.rb +79 -9
  314. data/lib/wx/doc/gen/sizer_item.rb +16 -2
  315. data/lib/wx/doc/gen/slider.rb +23 -0
  316. data/lib/wx/doc/gen/spin_button.rb +9 -0
  317. data/lib/wx/doc/gen/spin_ctrl.rb +11 -0
  318. data/lib/wx/doc/gen/spin_ctrl_double.rb +7 -0
  319. data/lib/wx/doc/gen/spin_double_event.rb +4 -1
  320. data/lib/wx/doc/gen/spin_event.rb +2 -1
  321. data/lib/wx/doc/gen/splash_screen.rb +2 -0
  322. data/lib/wx/doc/gen/splitter_event.rb +10 -1
  323. data/lib/wx/doc/gen/splitter_window.rb +38 -14
  324. data/lib/wx/doc/gen/static_bitmap.rb +99 -2
  325. data/lib/wx/doc/gen/static_box.rb +6 -0
  326. data/lib/wx/doc/gen/static_box_sizer.rb +3 -0
  327. data/lib/wx/doc/gen/static_line.rb +4 -0
  328. data/lib/wx/doc/gen/static_text.rb +5 -0
  329. data/lib/wx/doc/gen/status_bar.rb +17 -3
  330. data/lib/wx/doc/gen/stc/styled_text_ctrl.rb +174 -6
  331. data/lib/wx/doc/gen/stc/styled_text_event.rb +27 -1
  332. data/lib/wx/doc/gen/std_dialog_button_sizer.rb +7 -0
  333. data/lib/wx/doc/gen/svg_file_dc.rb +9 -0
  334. data/lib/wx/doc/gen/system_options.rb +8 -0
  335. data/lib/wx/doc/gen/system_settings.rb +7 -0
  336. data/lib/wx/doc/gen/task_bar_button.rb +12 -0
  337. data/lib/wx/doc/gen/task_bar_icon.rb +5 -0
  338. data/lib/wx/doc/gen/task_bar_icon_event.rb +2 -1
  339. data/lib/wx/doc/gen/text_attr.rb +27 -0
  340. data/lib/wx/doc/gen/text_ctrl.rb +27 -3
  341. data/lib/wx/doc/gen/text_entry.rb +43 -5
  342. data/lib/wx/doc/gen/text_entry_dialog.rb +12 -0
  343. data/lib/wx/doc/gen/text_validator.rb +16 -0
  344. data/lib/wx/doc/gen/time_picker_ctrl.rb +6 -0
  345. data/lib/wx/doc/gen/timer.rb +8 -0
  346. data/lib/wx/doc/gen/timer_event.rb +1 -0
  347. data/lib/wx/doc/gen/tip_provider.rb +5 -0
  348. data/lib/wx/doc/gen/toggle_button.rb +68 -0
  349. data/lib/wx/doc/gen/tool_bar.rb +57 -14
  350. data/lib/wx/doc/gen/tool_tip.rb +6 -0
  351. data/lib/wx/doc/gen/toolbook.rb +3 -0
  352. data/lib/wx/doc/gen/top_level_window.rb +34 -3
  353. data/lib/wx/doc/gen/tree_ctrl.rb +49 -0
  354. data/lib/wx/doc/gen/tree_event.rb +7 -1
  355. data/lib/wx/doc/gen/treebook.rb +9 -0
  356. data/lib/wx/doc/gen/ui_action_simulator.rb +4 -0
  357. data/lib/wx/doc/gen/utils.rb +55 -0
  358. data/lib/wx/doc/gen/v_list_box.rb +21 -0
  359. data/lib/wx/doc/gen/v_scrolled_window.rb +15 -0
  360. data/lib/wx/doc/gen/validator.rb +9 -13
  361. data/lib/wx/doc/gen/variant.rb +6 -0
  362. data/lib/wx/doc/gen/window.rb +260 -52
  363. data/lib/wx/doc/gen/window_dc.rb +2 -0
  364. data/lib/wx/doc/gen/window_disabler.rb +1 -0
  365. data/lib/wx/doc/gen/with_images.rb +7 -1
  366. data/lib/wx/doc/gen/wizard.rb +18 -0
  367. data/lib/wx/doc/gen/wizard_event.rb +3 -1
  368. data/lib/wx/doc/gen/wizard_page.rb +5 -0
  369. data/lib/wx/doc/gen/wizard_page_simple.rb +4 -0
  370. data/lib/wx/doc/gen/wrap_sizer.rb +5 -0
  371. data/lib/wx/doc/gen/xml_node.rb +14 -0
  372. data/lib/wx/doc/gen/xml_resource.rb +22 -0
  373. data/lib/wx/doc/generic_validator.rb +95 -0
  374. data/lib/wx/doc/html/simple_html_listbox.rb +22 -0
  375. data/lib/wx/doc/num_validator.rb +387 -0
  376. data/lib/wx/doc/owner_drawn_combobox.rb +96 -0
  377. data/lib/wx/doc/pg/numeric_property_validator.rb +33 -0
  378. data/lib/wx/doc/static_bitmap.rb +25 -0
  379. data/lib/wx/doc/text_validator.rb +10 -0
  380. data/lib/wx/doc/validator.rb +113 -0
  381. data/lib/wx/doc/window.rb +30 -0
  382. data/lib/wx/html/events/evt_list.rb +0 -10
  383. data/lib/wx/html/simple_html_listbox.rb +24 -91
  384. data/lib/wx/keyword_defs.rb +34 -2
  385. data/lib/wx/rbn/ribbon_gallery.rb +0 -21
  386. data/lib/wx/version.rb +1 -1
  387. data/lib/wxruby_aui.so +0 -0
  388. data/lib/wxruby_core.so +0 -0
  389. data/lib/wxruby_grid.so +0 -0
  390. data/lib/wxruby_html.so +0 -0
  391. data/lib/wxruby_pg.so +0 -0
  392. data/lib/wxruby_prt.so +0 -0
  393. data/lib/wxruby_rbn.so +0 -0
  394. data/lib/wxruby_rtc.so +0 -0
  395. data/lib/wxruby_stc.so +0 -0
  396. data/rakelib/lib/config/mingw.rb +12 -0
  397. data/samples/aui/aui.rb +1237 -1233
  398. data/samples/calendar/calendar.rb +293 -289
  399. data/samples/controls/get_item_sample.rb +83 -79
  400. data/samples/controls/htlbox.rb +331 -327
  401. data/samples/dialogs/dialogs.rb +682 -694
  402. data/samples/dialogs/wizard.rb +52 -55
  403. data/samples/dragdrop/dragdrop.rb +146 -142
  404. data/samples/drawing/bitmap.rb +29 -26
  405. data/samples/drawing/bitmap_image.rb +84 -80
  406. data/samples/drawing/graphics_drawing.rb +209 -205
  407. data/samples/drawing/image_prt.rb +344 -340
  408. data/samples/drawing/maths_images.rb +18 -1
  409. data/samples/drawing/rmagic_bitmap_image.rb +88 -84
  410. data/samples/etc/caret.rb +306 -0
  411. data/samples/etc/miniframe.rb +65 -60
  412. data/samples/etc/sash.rb +109 -105
  413. data/samples/etc/scrollwin.rb +86 -80
  414. data/samples/etc/system_settings.rb +216 -209
  415. data/samples/event/activation.rb +72 -67
  416. data/samples/event/event.rb +160 -153
  417. data/samples/event/threaded.rb +8 -1
  418. data/samples/event/update_ui_event.rb +67 -60
  419. data/samples/grid/grid.rb +188 -181
  420. data/samples/grid/gridtablebase.rb +136 -129
  421. data/samples/html/html.rb +208 -204
  422. data/samples/mdi/mdi.rb +59 -54
  423. data/samples/minimal/minimal.rb +54 -51
  424. data/samples/minimal/nothing.rb +1 -0
  425. data/samples/printing/printing.rb +367 -377
  426. data/samples/printing/printing2.rb +203 -198
  427. data/samples/propgrid/propgrid.rb +2312 -2308
  428. data/samples/propgrid/propgrid_minimal.rb +57 -50
  429. data/samples/ribbon/ribbon.rb +780 -774
  430. data/samples/sampler/ext.rb +0 -33
  431. data/samples/sampler/sample.rb +4 -9
  432. data/samples/sampler.rb +1 -1
  433. data/samples/splash/splash.rb +118 -116
  434. data/samples/text/rich_textctrl.rb +207 -201
  435. data/samples/text/richtext.rb +1409 -1405
  436. data/samples/text/scintilla.rb +137 -128
  437. data/samples/text/textctrl.rb +89 -83
  438. data/samples/text/unicode.rb +175 -168
  439. data/samples/treectrl/treectrl.rb +1430 -1426
  440. data/samples/widgets/activityindicator.rb +95 -0
  441. data/samples/widgets/art/widgets/activityindicator.xpm +278 -0
  442. data/samples/widgets/art/widgets/bmpbtn.xpm +37 -0
  443. data/samples/widgets/art/widgets/bmpcombobox.xpm +54 -0
  444. data/samples/widgets/art/widgets/button.xpm +54 -0
  445. data/samples/widgets/art/widgets/checkbox.xpm +54 -0
  446. data/samples/{bigdemo/icons → widgets/art/widgets}/choice.xpm +1 -1
  447. data/samples/widgets/art/widgets/choicebk.xpm +54 -0
  448. data/samples/widgets/art/widgets/clrpicker.xpm +193 -0
  449. data/samples/widgets/art/widgets/combobox.xpm +54 -0
  450. data/samples/widgets/art/widgets/datepick.xpm +200 -0
  451. data/samples/widgets/art/widgets/dirctrl.xpm +54 -0
  452. data/samples/widgets/art/widgets/dirpicker.xpm +213 -0
  453. data/samples/widgets/art/widgets/filepicker.xpm +214 -0
  454. data/samples/widgets/art/widgets/fontpicker.xpm +185 -0
  455. data/samples/widgets/art/widgets/gauge.xpm +54 -0
  456. data/samples/widgets/art/widgets/header.xpm +54 -0
  457. data/samples/widgets/art/widgets/hyperlnk.xpm +54 -0
  458. data/samples/widgets/art/widgets/listbook.xpm +54 -0
  459. data/samples/widgets/art/widgets/listbox.xpm +54 -0
  460. data/samples/widgets/art/widgets/native.xpm +81 -0
  461. data/samples/widgets/art/widgets/notebook.xpm +54 -0
  462. data/samples/widgets/art/widgets/odcombobox.xpm +54 -0
  463. data/samples/widgets/art/widgets/radiobox.xpm +54 -0
  464. data/samples/widgets/art/widgets/scrolbar.xpm +54 -0
  465. data/samples/widgets/art/widgets/slider.xpm +54 -0
  466. data/samples/widgets/art/widgets/spinbtn.xpm +40 -0
  467. data/samples/widgets/art/widgets/statbmp.xpm +40 -0
  468. data/samples/widgets/art/widgets/statbox.xpm +54 -0
  469. data/samples/widgets/art/widgets/stattext.xpm +54 -0
  470. data/samples/widgets/art/widgets/text.xpm +54 -0
  471. data/samples/widgets/art/widgets/timepick.xpm +207 -0
  472. data/samples/widgets/art/widgets/toggle.xpm +54 -0
  473. data/samples/widgets/art/widgets/toucan.png +0 -0
  474. data/samples/widgets/bmpcombobox.rb +651 -0
  475. data/samples/widgets/button.rb +462 -0
  476. data/samples/widgets/checkbox.rb +211 -0
  477. data/samples/widgets/choice.rb +287 -0
  478. data/samples/widgets/clrpicker.rb +156 -0
  479. data/samples/widgets/combobox.rb +516 -0
  480. data/samples/widgets/datepick.rb +215 -0
  481. data/samples/widgets/dirctrl.rb +265 -0
  482. data/samples/widgets/dirpicker.rb +158 -0
  483. data/samples/widgets/editlbox.rb +122 -0
  484. data/samples/widgets/filectrl.rb +216 -0
  485. data/samples/widgets/filepicker.rb +214 -0
  486. data/samples/widgets/fontpicker.rb +135 -0
  487. data/samples/widgets/gauge.rb +311 -0
  488. data/samples/widgets/headerctrl.rb +236 -0
  489. data/samples/widgets/hyperlink.rb +203 -0
  490. data/samples/widgets/itemcontainer.rb +185 -0
  491. data/samples/widgets/listbox.rb +473 -0
  492. data/samples/widgets/notebook.rb +488 -0
  493. data/samples/widgets/odcombobox.rb +608 -0
  494. data/samples/widgets/radiobox.rb +328 -0
  495. data/samples/widgets/searchctrl.rb +159 -0
  496. data/samples/widgets/slider.rb +594 -0
  497. data/samples/widgets/spinbtn.rb +443 -0
  498. data/samples/widgets/statbmp.rb +130 -0
  499. data/samples/widgets/static.rb +436 -0
  500. data/samples/widgets/textctrl.rb +700 -0
  501. data/samples/widgets/timepick.rb +148 -0
  502. data/samples/widgets/tn_widgets.png +0 -0
  503. data/samples/widgets/toggle.rb +385 -0
  504. data/samples/widgets/widgets.rb +1233 -0
  505. data/samples/xrc/custom_xrc_sample.rb +47 -41
  506. data/samples/xrc/xrc_sample.rb +53 -47
  507. data/tests/test_event_handling.rb +52 -34
  508. data/tests/test_events.rb +7 -0
  509. data/tests/test_item_data.rb +24 -0
  510. data/tests/test_sizer.rb +44 -1
  511. data/tests/test_validators.rb +805 -0
  512. metadata +87 -137
  513. data/lib/wx/core/choice.rb +0 -14
  514. data/lib/wx/core/combo_ctrl.rb +0 -110
  515. data/samples/bigdemo/About.rbw +0 -39
  516. data/samples/bigdemo/ColorPanel.rbw +0 -23
  517. data/samples/bigdemo/GridSimple.rbw +0 -78
  518. data/samples/bigdemo/MDIDemo.rbw +0 -57
  519. data/samples/bigdemo/PopupMenu.rbw +0 -146
  520. data/samples/bigdemo/ShapedWindow.rbw +0 -128
  521. data/samples/bigdemo/Sizers.rbw +0 -541
  522. data/samples/bigdemo/bigdemo.rb +0 -817
  523. data/samples/bigdemo/demoTemplate.rbw +0 -33
  524. data/samples/bigdemo/helpfile.htb +0 -0
  525. data/samples/bigdemo/icons/Test 015.jpg +0 -0
  526. data/samples/bigdemo/icons/Test 015.png +0 -0
  527. data/samples/bigdemo/icons/choice.bmp +0 -0
  528. data/samples/bigdemo/icons/combo.bmp +0 -0
  529. data/samples/bigdemo/icons/combo.xpm +0 -27
  530. data/samples/bigdemo/icons/copy.xpm +0 -25
  531. data/samples/bigdemo/icons/cut.xpm +0 -24
  532. data/samples/bigdemo/icons/gauge.bmp +0 -0
  533. data/samples/bigdemo/icons/gauge.xpm +0 -27
  534. data/samples/bigdemo/icons/help.xpm +0 -25
  535. data/samples/bigdemo/icons/list.bmp +0 -0
  536. data/samples/bigdemo/icons/list.xpm +0 -27
  537. data/samples/bigdemo/icons/mondrian.ico +0 -0
  538. data/samples/bigdemo/icons/mondrian.xpm +0 -44
  539. data/samples/bigdemo/icons/new.xpm +0 -24
  540. data/samples/bigdemo/icons/ogl.ico +0 -0
  541. data/samples/bigdemo/icons/ogl.xpm +0 -45
  542. data/samples/bigdemo/icons/open.xpm +0 -26
  543. data/samples/bigdemo/icons/paste.bmp +0 -0
  544. data/samples/bigdemo/icons/paste.xpm +0 -38
  545. data/samples/bigdemo/icons/pointy.png +0 -0
  546. data/samples/bigdemo/icons/preview.xpm +0 -26
  547. data/samples/bigdemo/icons/print.xpm +0 -26
  548. data/samples/bigdemo/icons/radio.bmp +0 -0
  549. data/samples/bigdemo/icons/radio.xpm +0 -27
  550. data/samples/bigdemo/icons/robert.xpm +0 -415
  551. data/samples/bigdemo/icons/sashtest.ico +0 -0
  552. data/samples/bigdemo/icons/save.xpm +0 -25
  553. data/samples/bigdemo/icons/smiles.bmp +0 -0
  554. data/samples/bigdemo/icons/smiles.xpm +0 -39
  555. data/samples/bigdemo/icons/smiley.ico +0 -0
  556. data/samples/bigdemo/icons/smiley.xpm +0 -42
  557. data/samples/bigdemo/icons/stattext.xpm +0 -24
  558. data/samples/bigdemo/icons/test2.bmp +0 -0
  559. data/samples/bigdemo/icons/test2.png +0 -0
  560. data/samples/bigdemo/icons/test2.xpm +0 -79
  561. data/samples/bigdemo/icons/text.bmp +0 -0
  562. data/samples/bigdemo/icons/text.xpm +0 -27
  563. data/samples/bigdemo/icons/tog1.bmp +0 -0
  564. data/samples/bigdemo/icons/tog1.xpm +0 -38
  565. data/samples/bigdemo/icons/tog2.bmp +0 -0
  566. data/samples/bigdemo/icons/tog2.xpm +0 -38
  567. data/samples/bigdemo/icons/wxruby-128x128.png +0 -0
  568. data/samples/bigdemo/icons/wxwin.ico +0 -0
  569. data/samples/bigdemo/icons/wxwin16x16.png +0 -0
  570. data/samples/bigdemo/icons/wxwin16x16.xpm +0 -25
  571. data/samples/bigdemo/icons/wxwin32x32.png +0 -0
  572. data/samples/bigdemo/icons/wxwin48x48.png +0 -0
  573. data/samples/bigdemo/run.rb +0 -98
  574. data/samples/bigdemo/tips.txt +0 -7
  575. data/samples/bigdemo/utils.rb +0 -20
  576. data/samples/bigdemo/wxArtProvider.rbw +0 -282
  577. data/samples/bigdemo/wxBitmapButton.rbw +0 -65
  578. data/samples/bigdemo/wxButton.rbw +0 -64
  579. data/samples/bigdemo/wxCalendarCtrl.rbw +0 -59
  580. data/samples/bigdemo/wxCheckBox.rbw +0 -50
  581. data/samples/bigdemo/wxCheckListBox.rbw +0 -65
  582. data/samples/bigdemo/wxChoice.rbw +0 -47
  583. data/samples/bigdemo/wxChoicebook.rbw +0 -78
  584. data/samples/bigdemo/wxColourDialog.rbw +0 -33
  585. data/samples/bigdemo/wxComboBox.rbw +0 -77
  586. data/samples/bigdemo/wxCursor.rbw +0 -136
  587. data/samples/bigdemo/wxDialog.rbw +0 -74
  588. data/samples/bigdemo/wxDirDialog.rbw +0 -29
  589. data/samples/bigdemo/wxDragImage.rbw +0 -70
  590. data/samples/bigdemo/wxFileDialog.rbw +0 -37
  591. data/samples/bigdemo/wxFileDialog_Save.rbw +0 -35
  592. data/samples/bigdemo/wxFindReplaceDialog.rbw +0 -82
  593. data/samples/bigdemo/wxFontDialog.rbw +0 -200
  594. data/samples/bigdemo/wxFrame.rbw +0 -53
  595. data/samples/bigdemo/wxGauge.rbw +0 -65
  596. data/samples/bigdemo/wxGenericDirCtrl.rbw +0 -74
  597. data/samples/bigdemo/wxGrid.rbw +0 -66
  598. data/samples/bigdemo/wxHtmlHelpController.rbw +0 -52
  599. data/samples/bigdemo/wxListBox.rbw +0 -140
  600. data/samples/bigdemo/wxListCtrl_virtual.rbw +0 -112
  601. data/samples/bigdemo/wxMDIWindows.rbw +0 -50
  602. data/samples/bigdemo/wxMenu.rbw +0 -247
  603. data/samples/bigdemo/wxMessageDialog.rbw +0 -27
  604. data/samples/bigdemo/wxMiniFrame.rbw +0 -70
  605. data/samples/bigdemo/wxMultipleChoiceDialog.rbw +0 -29
  606. data/samples/bigdemo/wxNotebook.rbw +0 -136
  607. data/samples/bigdemo/wxProgressDialog.rbw +0 -43
  608. data/samples/bigdemo/wxRadioBox.rbw +0 -72
  609. data/samples/bigdemo/wxRadioButton.rbw +0 -125
  610. data/samples/bigdemo/wxSashWindow.rbw +0 -141
  611. data/samples/bigdemo/wxScrolledMessageDialog.rbw +0 -57
  612. data/samples/bigdemo/wxScrolledWindow.rbw +0 -199
  613. data/samples/bigdemo/wxSingleChoiceDialog.rbw +0 -33
  614. data/samples/bigdemo/wxSlider.rbw +0 -42
  615. data/samples/bigdemo/wxSpinButton.rbw +0 -50
  616. data/samples/bigdemo/wxSpinCtrl.rbw +0 -51
  617. data/samples/bigdemo/wxSplitterWindow.rbw +0 -63
  618. data/samples/bigdemo/wxStaticBitmap.rbw +0 -47
  619. data/samples/bigdemo/wxStaticText.rbw +0 -55
  620. data/samples/bigdemo/wxStatusBar.rbw +0 -126
  621. data/samples/bigdemo/wxTextCtrl.rbw +0 -149
  622. data/samples/bigdemo/wxTextEntryDialog.rbw +0 -31
  623. data/samples/bigdemo/wxToggleButton.rbw +0 -49
  624. data/samples/bigdemo/wxToolBar.rbw +0 -131
  625. data/samples/bigdemo/wxTreeCtrl.rbw +0 -191
  626. data/samples/caret/caret.rb +0 -298
  627. data/samples/caret/mondrian.xpm +0 -44
  628. data/samples/controls/books.rb +0 -189
  629. data/samples/controls/choice.xpm +0 -27
  630. data/samples/controls/combo.xpm +0 -27
  631. data/samples/controls/controls.rb +0 -1099
  632. data/samples/controls/gauge.xpm +0 -27
  633. data/samples/controls/list.xpm +0 -27
  634. data/samples/controls/mondrian.ico +0 -0
  635. data/samples/controls/mondrian.xpm +0 -44
  636. data/samples/controls/radio.xpm +0 -27
  637. data/samples/controls/stattext.xpm +0 -24
  638. data/samples/controls/test2.bmp +0 -0
  639. data/samples/controls/text.xpm +0 -27
  640. data/samples/controls/tn_books.png +0 -0
  641. data/samples/controls/tn_controls.png +0 -0
  642. data/samples/etc/choice.rb +0 -87
  643. data/samples/etc/tn_choice.png +0 -0
  644. data/samples/text/mondrian.ico +0 -0
  645. data/samples/text/mondrian.xpm +0 -44
  646. /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).
@@ -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