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
@@ -61,6 +61,7 @@ module Wx
61
61
  EVT_CALCULATE_LAYOUT = 10012
62
62
 
63
63
  # {Wx::SashLayoutWindow} responds to OnCalculateLayout events generated by {Wx::LayoutAlgorithm}.
64
+ #
64
65
  # It allows the application to use simple accessors to specify how the window should be laid out, rather than having to respond to events.
65
66
  # The fact that the class derives from {Wx::SashWindow} allows sashes to be used if required, to allow the windows to be user-resizable.
66
67
  # The documentation for {Wx::LayoutAlgorithm} explains the purpose of this class in more detail.
@@ -111,12 +112,14 @@ module Wx
111
112
  alias_method :orientation, :get_orientation
112
113
 
113
114
  # The default handler for the event that is generated by {Wx::LayoutAlgorithm}.
115
+ #
114
116
  # The implementation of this function calls {Wx::CalculateLayoutEvent#set_rect} to shrink the provided size according to how much space this window takes up. For further details, see {Wx::LayoutAlgorithm} and {Wx::CalculateLayoutEvent}.
115
117
  # @param event [Wx::CalculateLayoutEvent]
116
118
  # @return [void]
117
119
  def on_calculate_layout(event) end
118
120
 
119
121
  # The default handler for the event that is generated by OnCalculateLayout to get size, alignment and orientation information for the window.
122
+ #
120
123
  # The implementation of this function uses member variables as set by accessors called by the application.
121
124
  # For further details, see {Wx::LayoutAlgorithm} and {Wx::QueryLayoutInfoEvent}.
122
125
  # @param event [Wx::QueryLayoutInfoEvent]
@@ -124,6 +127,7 @@ module Wx
124
127
  def on_query_layout_info(event) end
125
128
 
126
129
  # Sets the alignment of the window (which edge of the available parent client area the window is attached to).
130
+ #
127
131
  # alignment is one of {Wx::LayoutAlignment::LAYOUT_TOP}, {Wx::LayoutAlignment::LAYOUT_LEFT}, {Wx::LayoutAlignment::LAYOUT_RIGHT}, {Wx::LayoutAlignment::LAYOUT_BOTTOM}.
128
132
  # @param alignment [Wx::LayoutAlignment]
129
133
  # @return [void]
@@ -131,6 +135,7 @@ module Wx
131
135
  alias_method :alignment=, :set_alignment
132
136
 
133
137
  # Sets the default dimensions of the window.
138
+ #
134
139
  # The dimension other than the orientation will be fixed to this value, and the orientation dimension will be ignored and the window stretched to fit the available space.
135
140
  # @param size [Array(Integer, Integer), Wx::Size]
136
141
  # @return [void]
@@ -138,6 +143,7 @@ module Wx
138
143
  alias_method :default_size=, :set_default_size
139
144
 
140
145
  # Sets the orientation of the window (the direction the window will stretch in, to fill the available parent client area).
146
+ #
141
147
  # orientation is one of {Wx::LayoutOrientation::LAYOUT_HORIZONTAL}, {Wx::LayoutOrientation::LAYOUT_VERTICAL}.
142
148
  # @param orientation [Wx::LayoutOrientation]
143
149
  # @return [void]
@@ -147,6 +153,7 @@ module Wx
147
153
  end # SashLayoutWindow
148
154
 
149
155
  # {Wx::LayoutAlgorithm} implements layout of subwindows in MDI or SDI frames.
156
+ #
150
157
  # It sends a {Wx::CalculateLayoutEvent} event to children of the frame, asking them for information about their size. For MDI parent frames, the algorithm allocates the remaining space to the MDI client window (which contains the MDI child frames).
151
158
  # For SDI (normal) frames, a 'main' window is specified as taking up the remaining space.
152
159
  # Because the event system is used, this technique can be applied to any windows, which are not necessarily 'aware' of the layout classes (no virtual functions in {Wx::Window} refer to {Wx::LayoutAlgorithm} or its events). However, you may wish to use {Wx::SashLayoutWindow} for your subwindows since this class provides handlers for the required events, and accessors to specify the desired size of the window. The sash behaviour in the base class can be used, optionally, to make the windows user-resizable.
@@ -186,6 +193,7 @@ module Wx
186
193
  def initialize; end
187
194
 
188
195
  # Lays out the children of a normal frame.
196
+ #
189
197
  # mainWindow is set to occupy the remaining space. This function simply calls {Wx::LayoutAlgorithm#layout_window}.
190
198
  # @param frame [Wx::Frame]
191
199
  # @param mainWindow [Wx::Window]
@@ -193,6 +201,7 @@ module Wx
193
201
  def layout_frame(frame, mainWindow=nil) end
194
202
 
195
203
  # Lays out the children of an MDI parent frame.
204
+ #
196
205
  # If rect is non-NULL, the given rectangle will be used as a starting point instead of the frame's client area. The MDI client window is set to occupy the remaining space.
197
206
  # @param frame [Wx::MDIParentFrame]
198
207
  # @param rect [Wx::Rect]
@@ -200,6 +209,7 @@ module Wx
200
209
  def layout_mdi_frame(frame, rect=nil) end
201
210
 
202
211
  # Lays out the children of a normal frame or other window.
212
+ #
203
213
  # mainWindow is set to occupy the remaining space. If this is not specified, then the last window that responds to a calculate layout event in query mode will get the remaining space (that is, a non-query OnCalculateLayout event will not be sent to this window and the window will be set to the remaining size).
204
214
  # @param parent [Wx::Window]
205
215
  # @param mainWindow [Wx::Window]
@@ -7,6 +7,7 @@
7
7
  module Wx
8
8
 
9
9
  # {Wx::SashWindow} allows any of its edges to have a sash which can be dragged to resize the window.
10
+ #
10
11
  # The actual content window will be created by the application as a child of {Wx::SashWindow}.
11
12
  # The window (or an ancestor) will be notified of a drag via a {Wx::SashEvent} notification.
12
13
  # ### Styles
@@ -75,6 +76,7 @@ module Wx
75
76
 
76
77
  # Returns true if a sash is visible on the given edge, false otherwise.
77
78
  #
79
+ #
78
80
  # @see Wx::SashWindow#set_sash_visible
79
81
  # @param edge [Wx::SashEdgePosition] Edge. One of {Wx::SashEdgePosition::SASH_TOP}, {Wx::SashEdgePosition::SASH_RIGHT}, {Wx::SashEdgePosition::SASH_BOTTOM}, {Wx::SashEdgePosition::SASH_LEFT}.
80
82
  # @return [Boolean]
@@ -107,6 +109,7 @@ module Wx
107
109
 
108
110
  # Call this function to make a sash visible or invisible on a particular edge.
109
111
  #
112
+ #
110
113
  # @see Wx::SashWindow#get_sash_visible
111
114
  # @param edge [Wx::SashEdgePosition] Edge to change. One of {Wx::SashEdgePosition::SASH_TOP}, {Wx::SashEdgePosition::SASH_RIGHT}, {Wx::SashEdgePosition::SASH_BOTTOM}, {Wx::SashEdgePosition::SASH_LEFT}.
112
115
  # @param visible [Boolean] true to make the sash visible, false to make it invisible.
@@ -7,6 +7,7 @@
7
7
  module Wx
8
8
 
9
9
  # A {Wx::ScreenDC} can be used to paint on the screen.
10
+ #
10
11
  # This should normally be constructed as a temporary stack object; don't store a {Wx::ScreenDC} object.
11
12
  # When using multiple monitors, {Wx::ScreenDC} corresponds to the entire virtual screen composed of all of them. Notice that coordinates on {Wx::ScreenDC} can be negative in this case, see Wx::Display#get_geometry for more.
12
13
  #
@@ -7,13 +7,14 @@
7
7
  module Wx
8
8
 
9
9
  # A {Wx::ScrollBar} is a control that represents a horizontal or vertical scrollbar.
10
+ #
10
11
  # It is distinct from the two scrollbars that some windows provide automatically, but the two types of scrollbar share the way events are received.
11
12
  #
12
13
  # <div class="wxrb-remark">
13
14
  # <b>Remark:</b>
14
15
  # <p>A scrollbar has the following main attributes: range, thumb size, page size, and position. The range is the total number of units associated with the view represented by the scrollbar. For a table with 15 columns, the range would be 15. The thumb size is the number of units that are currently visible. For the table example, the window might be sized so that only 5 columns are currently visible, in which case the application would set the thumb size to 5. When the thumb size becomes the same as or greater than the range, the scrollbar will be automatically hidden on most platforms. The page size is the number of units that the scrollbar should scroll by, when 'paging' through the data. This value is normally the same as the thumb size length, because it is natural to assume that the visible window size defines a page. The scrollbar position is the current thumb position. Most applications will find it convenient to provide a function called AdjustScrollbars() which can be called initially, from an OnSize event handler, and whenever the application data changes in size. It will adjust the view, object and page size according to the size of the window and the size of the data.
15
16
  # </p>
16
- # </div>>
17
+ # </div>
17
18
  #
18
19
  # ### Styles
19
20
  #
@@ -92,6 +93,7 @@ module Wx
92
93
  # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::SB_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SCROLL_BAR_NAME_STR)
93
94
  # Constructor, creating and showing a scrollbar.
94
95
  #
96
+ #
95
97
  # @see Wx::ScrollBar#create
96
98
  # @see Wx::Validator
97
99
  # @param parent [Wx::Window] Parent window. Must be non-NULL.
@@ -105,6 +107,7 @@ module Wx
105
107
  def initialize(*args) end
106
108
 
107
109
  # Scrollbar creation function called by the scrollbar constructor.
110
+ #
108
111
  # See {Wx::ScrollBar#initialize} for details.
109
112
  # @param parent [Wx::Window]
110
113
  # @param id [Integer]
@@ -117,6 +120,7 @@ module Wx
117
120
  def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::SB_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SCROLL_BAR_NAME_STR) end
118
121
 
119
122
  # Returns the page size of the scrollbar.
123
+ #
120
124
  # This is the number of scroll units that will be scrolled when the user pages up or down. Often it is the same as the thumb size.
121
125
  # @see Wx::ScrollBar#set_scrollbar
122
126
  # @return [Integer]
@@ -125,6 +129,7 @@ module Wx
125
129
 
126
130
  # Returns the length of the scrollbar.
127
131
  #
132
+ #
128
133
  # @see Wx::ScrollBar#set_scrollbar
129
134
  # @return [Integer]
130
135
  def get_range; end
@@ -132,6 +137,7 @@ module Wx
132
137
 
133
138
  # Returns the current position of the scrollbar thumb.
134
139
  #
140
+ #
135
141
  # @see Wx::ScrollBar#set_thumb_position
136
142
  # @return [Integer]
137
143
  def get_thumb_position; end
@@ -139,12 +145,14 @@ module Wx
139
145
 
140
146
  # Returns the thumb or 'view' size.
141
147
  #
148
+ #
142
149
  # @see Wx::ScrollBar#set_scrollbar
143
150
  # @return [Integer]
144
151
  def get_thumb_size; end
145
152
  alias_method :thumb_size, :get_thumb_size
146
153
 
147
154
  # Sets the scrollbar properties.
155
+ #
148
156
  # <div class="wxrb-remark">
149
157
  # <b>Remark:</b>
150
158
  # <p>Let's say you wish to display 50 lines of text, using the same font. The window is sized so that you can only see 16 lines at a time. You would use:
@@ -153,7 +161,7 @@ module Wx
153
161
  # ```
154
162
  # The page size is 1 less than the thumb size so that the last line of the previous page will be visible on the next page, to help orient the user. Note that with the window at this size, the thumb position can never go above 50 minus 16, or 34. You can determine how many lines are currently visible by dividing the current view size by the character height in pixels. When defining your own scrollbar behaviour, you will always need to recalculate the scrollbar settings when the window size changes. You could therefore put your scrollbar calculations and {Wx::ScrollBar#set_scrollbar} call into a function named AdjustScrollbars, which can be called initially and also from a {Wx::SizeEvent} event handler function.
155
163
  # </p>
156
- # </div>>
164
+ # </div>
157
165
  # @param position [Integer] The position of the scrollbar in scroll units.
158
166
  # @param thumbSize [Integer] The size of the thumb, or visible portion of the scrollbar, in scroll units.
159
167
  # @param range [Integer] The maximum position of the scrollbar.
@@ -164,6 +172,7 @@ module Wx
164
172
 
165
173
  # Sets the position of the scrollbar.
166
174
  #
175
+ #
167
176
  # @see Wx::ScrollBar#get_thumb_position
168
177
  # @param viewStart [Integer] The position of the scrollbar thumb.
169
178
  # @return [void]
@@ -7,6 +7,7 @@
7
7
  module Wx
8
8
 
9
9
  # The {Wx::Scrolled} class manages scrolling for its client area, transforming the coordinates according to the scrollbar positions, and setting the scroll positions, thumb sizes and ranges according to the area in view.
10
+ #
10
11
  # There are two commonly used (but not the only possible!) specializations of this class:
11
12
  #
12
13
  # - {Wx::ScrolledWindow}, aka {Wx::Scrolled}<{Wx::Panel}>, is equivalent to {Wx::ScrolledWindow} from earlier versions. Derived from {Wx::Panel}, it shares {Wx::Panel}'s behaviour with regard to TAB traversal and focus handling. Use this if the scrolled window will have child controls.
@@ -75,7 +76,7 @@ module Wx
75
76
  # <b>Remark:</b>
76
77
  # <p>Use {Wx::Scrolled} for applications where the user scrolls by a fixed amount, and where a 'page' can be interpreted to be the current visible portion of the window. For more sophisticated applications, use the {Wx::Scrolled} implementation as a guide to build your own scroll behaviour or use {Wx::VScrolledWindow} or its variants.
77
78
  # </p>
78
- # </div>>
79
+ # </div>
79
80
  #
80
81
  # Category: Miscellaneous Windows
81
82
  # @see Wx::ScrollBar
@@ -94,11 +95,12 @@ module Wx
94
95
  # @return [Wx::ScrolledCanvas]
95
96
  # @overload initialize(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW"))
96
97
  # Constructor.
98
+ #
97
99
  # <div class="wxrb-remark">
98
100
  # <b>Remark:</b>
99
101
  # <p>The window is initially created without visible scrollbars. Call Wx::Scrolled#set_scrollbars to specify how big the virtual window size should be.
100
102
  # </p>
101
- # </div>>
103
+ # </div>
102
104
  # @param parent [Wx::Window] Parent window.
103
105
  # @param id [Integer] Window identifier. The value {Wx::StandardID::ID_ANY} indicates a default value.
104
106
  # @param pos [Array(Integer, Integer), Wx::Point] Window position. If a position of {Wx::DEFAULT_POSITION} is specified then a default position is chosen.
@@ -110,6 +112,7 @@ module Wx
110
112
 
111
113
  # @overload calc_scrolled_position(x, y)
112
114
  # Translates the logical coordinates to the device ones.
115
+ #
113
116
  # For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcScrolledPosition(0, 10, xx, yy) will return 0 in yy.
114
117
  # @see Wx::Scrolled#calc_unscrolled_position
115
118
  # @param x [Integer]
@@ -122,6 +125,7 @@ module Wx
122
125
 
123
126
  # @overload calc_unscrolled_position(x, y)
124
127
  # Translates the device coordinates to the logical ones.
128
+ #
125
129
  # For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcUnscrolledPosition(0, 0, xx, yy) will return 10 in yy.
126
130
  # @see Wx::Scrolled#calc_scrolled_position
127
131
  # @param x [Integer]
@@ -133,6 +137,7 @@ module Wx
133
137
  def calc_unscrolled_position(*args) end
134
138
 
135
139
  # Creates the window for two-step construction.
140
+ #
136
141
  # Derived classes should call or replace this function. If it is not replaced, bear in mind that it calls T::Create() through the global function {create_scrolled} so if T::Create() has a different signature than Wx::Scrolled#create you should implement overloaded {create_scrolled} which would call T::Create() in the correct manner.
137
142
  # @see Wx::Scrolled#initialize and create_scrolled for details.
138
143
  # @param parent [Wx::Window]
@@ -145,11 +150,13 @@ module Wx
145
150
  def create(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW")) end
146
151
 
147
152
  # Disable use of keyboard keys for scrolling.
153
+ #
148
154
  # By default cursor movement keys (including Home, End, Page Up and Down) are used to scroll the window appropriately. If the derived class uses these keys for something else, e.g. changing the currently selected item, this function can be used to disable this behaviour as it's not only not necessary then but can actually be actively harmful if another object forwards a keyboard event corresponding to one of the above keys to us using ProcessWindowEvent() because the event will always be processed which can be undesirable.
149
155
  # @return [void]
150
156
  def disable_keyboard_scrolling; end
151
157
 
152
158
  # Call this function to prepare the device context for drawing a scrolled image.
159
+ #
153
160
  # It sets the device origin according to the current scroll position. Wx::Scrolled#do_prepare_dc is called automatically within the default {Wx::EVT_PAINT} event handler, so your Wx::Scrolled#on_draw override will be passed an already 'pre-scrolled' device context. However, if you wish to draw from outside of Wx::Scrolled#on_draw (e.g. from your own {Wx::EVT_PAINT} handler), you must call this function yourself.
154
161
  # For example:
155
162
  # ```ruby
@@ -178,6 +185,7 @@ module Wx
178
185
  def do_prepare_dc(dc) end
179
186
 
180
187
  # Enable or disable use of {Wx::Window#scroll_window} for scrolling.
188
+ #
181
189
  # By default, when a scrolled window is logically scrolled, {Wx::Window#scroll_window} is called on the underlying window which scrolls the window contents and only invalidates the part of the window newly brought into view. If false is passed as an argument, then this "physical scrolling" is disabled and the window is entirely invalidated whenever it is scrolled by calling {Wx::Window#refresh}.
182
190
  # It should be rarely necessary to disable physical scrolling, so this method shouldn't be called in normal circumstances.
183
191
  # @param xScrolling [Boolean] If true, enables physical scrolling in the x direction.
@@ -186,6 +194,7 @@ module Wx
186
194
  def enable_scrolling(xScrolling, yScrolling) end
187
195
 
188
196
  # Set the scrollbar visibility.
197
+ #
189
198
  # By default the scrollbar in the corresponding direction is only shown if it is needed, i.e. if the virtual size of the scrolled window in this direction is greater than the current physical window size. Using this function the scrollbar visibility can be changed to be:
190
199
  #
191
200
  # - {Wx::ScrollbarVisibility::SHOW_SB_ALWAYS}: To always show the scrollbar, even if it is not needed currently ({Wx::ALWAYS_SHOW_SB} style can be used during the window creation to achieve the same effect but it applies in both directions).
@@ -199,6 +208,7 @@ module Wx
199
208
  def show_scrollbars(horz, vert) end
200
209
 
201
210
  # Get the number of pixels per scroll unit (line), in each direction, as set by Wx::Scrolled#set_scrollbars.
211
+ #
202
212
  # A value of zero indicates no scrolling in that direction.
203
213
  # @see Wx::Scrolled#set_scrollbars
204
214
  # @see Wx::Scrolled#get_virtual_size
@@ -212,11 +222,12 @@ module Wx
212
222
  alias_method :view_start, :get_view_start
213
223
 
214
224
  # Gets the size in device units of the scrollable window area (as opposed to the client size, which is the area of the window currently visible).
225
+ #
215
226
  # <div class="wxrb-remark">
216
227
  # <b>Remark:</b>
217
228
  # <p>Use {Wx::DC#device_to_logical_x} and {Wx::DC#device_to_logical_y} to translate these units to logical units.
218
229
  # </p>
219
- # </div>>
230
+ # </div>
220
231
  # @see Wx::Scrolled#set_scrollbars
221
232
  # @see Wx::Scrolled#get_scroll_pixels_per_unit
222
233
  # @return [Array(Integer,Integer)]
@@ -229,6 +240,7 @@ module Wx
229
240
  alias_method :retained?, :is_retained
230
241
 
231
242
  # This function is for backwards compatibility only and simply calls Wx::Scrolled#do_prepare_dc now.
243
+ #
232
244
  # Notice that it is not called by the default paint event handle (Wx::Scrolled#do_prepare_dc is), so overriding this method in your derived class is useless.
233
245
  # @param dc [Wx::DC]
234
246
  # @return [void]
@@ -236,11 +248,12 @@ module Wx
236
248
 
237
249
  # @overload scroll(x, y)
238
250
  # Scrolls a window so the view start is at the given point.
251
+ #
239
252
  # <div class="wxrb-remark">
240
253
  # <b>Remark:</b>
241
254
  # <p>The positions are in scroll units, not pixels, so to convert to pixels you will have to multiply by the number of pixels per scroll increment. If either parameter is {Wx::DEFAULT_COORD} (-1), that position will be ignored (no change in that direction).
242
255
  # </p>
243
- # </div>>
256
+ # </div>
244
257
  # @see Wx::Scrolled#set_scrollbars
245
258
  # @see Wx::Scrolled#get_scroll_pixels_per_unit
246
259
  # @param x [Integer] The x position to scroll to, in scroll units.
@@ -253,6 +266,7 @@ module Wx
253
266
  def scroll(*args) end
254
267
 
255
268
  # Set the horizontal and vertical scrolling increment only.
269
+ #
256
270
  # See the pixelsPerUnit parameter in Wx::Scrolled#set_scrollbars.
257
271
  # @param xstep [Integer]
258
272
  # @param ystep [Integer]
@@ -260,6 +274,7 @@ module Wx
260
274
  def set_scroll_rate(xstep, ystep) end
261
275
 
262
276
  # Sets up vertical and/or horizontal scrollbars.
277
+ #
263
278
  # The first pair of parameters give the number of pixels per 'scroll step', i.e. amount moved when the up or down scroll arrows are pressed. The second pair gives the length of scrollbar in scroll steps, which sets the size of the virtual window.
264
279
  # xPos and yPos optionally specify a position to scroll to immediately.
265
280
  # For example, the following gives a window horizontal and vertical scrollbars with 20 pixels per scroll step, and a size of 50 steps (1000 pixels) in each direction:
@@ -281,6 +296,7 @@ module Wx
281
296
  def set_scrollbars(pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY, xPos=0, yPos=0, noRefresh=false) end
282
297
 
283
298
  # Call this function to tell {Wx::Scrolled} to perform the actual scrolling on a different window (and not on itself).
299
+ #
284
300
  # This method is useful when only a part of the window should be scrolled. A typical example is a control consisting of a fixed header and the scrollable contents window: the scrollbars are attached to the main window itself, hence it, and not the contents window must be derived from {Wx::Scrolled}, but only the contents window scrolls when the scrollbars are used. To implement such setup, you need to call this method with the contents window as argument.
285
301
  # Notice that if this method is used, Wx::Scrolled#get_size_available_for_scroll_target method must be overridden.
286
302
  # @param window [Wx::Window]
@@ -7,6 +7,7 @@
7
7
  module Wx
8
8
 
9
9
  # The {Wx::Scrolled} class manages scrolling for its client area, transforming the coordinates according to the scrollbar positions, and setting the scroll positions, thumb sizes and ranges according to the area in view.
10
+ #
10
11
  # There are two commonly used (but not the only possible!) specializations of this class:
11
12
  #
12
13
  # - {Wx::ScrolledWindow}, aka {Wx::Scrolled}<{Wx::Panel}>, is equivalent to {Wx::ScrolledWindow} from earlier versions. Derived from {Wx::Panel}, it shares {Wx::Panel}'s behaviour with regard to TAB traversal and focus handling. Use this if the scrolled window will have child controls.
@@ -75,7 +76,7 @@ module Wx
75
76
  # <b>Remark:</b>
76
77
  # <p>Use {Wx::Scrolled} for applications where the user scrolls by a fixed amount, and where a 'page' can be interpreted to be the current visible portion of the window. For more sophisticated applications, use the {Wx::Scrolled} implementation as a guide to build your own scroll behaviour or use {Wx::VScrolledWindow} or its variants.
77
78
  # </p>
78
- # </div>>
79
+ # </div>
79
80
  #
80
81
  # Category: Miscellaneous Windows
81
82
  # @see Wx::ScrollBar
@@ -94,11 +95,12 @@ module Wx
94
95
  # @return [Wx::ScrolledControl]
95
96
  # @overload initialize(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW"))
96
97
  # Constructor.
98
+ #
97
99
  # <div class="wxrb-remark">
98
100
  # <b>Remark:</b>
99
101
  # <p>The window is initially created without visible scrollbars. Call Wx::Scrolled#set_scrollbars to specify how big the virtual window size should be.
100
102
  # </p>
101
- # </div>>
103
+ # </div>
102
104
  # @param parent [Wx::Window] Parent window.
103
105
  # @param id [Integer] Window identifier. The value {Wx::StandardID::ID_ANY} indicates a default value.
104
106
  # @param pos [Array(Integer, Integer), Wx::Point] Window position. If a position of {Wx::DEFAULT_POSITION} is specified then a default position is chosen.
@@ -110,6 +112,7 @@ module Wx
110
112
 
111
113
  # @overload calc_scrolled_position(x, y)
112
114
  # Translates the logical coordinates to the device ones.
115
+ #
113
116
  # For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcScrolledPosition(0, 10, xx, yy) will return 0 in yy.
114
117
  # @see Wx::Scrolled#calc_unscrolled_position
115
118
  # @param x [Integer]
@@ -122,6 +125,7 @@ module Wx
122
125
 
123
126
  # @overload calc_unscrolled_position(x, y)
124
127
  # Translates the device coordinates to the logical ones.
128
+ #
125
129
  # For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcUnscrolledPosition(0, 0, xx, yy) will return 10 in yy.
126
130
  # @see Wx::Scrolled#calc_scrolled_position
127
131
  # @param x [Integer]
@@ -133,6 +137,7 @@ module Wx
133
137
  def calc_unscrolled_position(*args) end
134
138
 
135
139
  # Creates the window for two-step construction.
140
+ #
136
141
  # Derived classes should call or replace this function. If it is not replaced, bear in mind that it calls T::Create() through the global function {create_scrolled} so if T::Create() has a different signature than Wx::Scrolled#create you should implement overloaded {create_scrolled} which would call T::Create() in the correct manner.
137
142
  # @see Wx::Scrolled#initialize and create_scrolled for details.
138
143
  # @param parent [Wx::Window]
@@ -145,11 +150,13 @@ module Wx
145
150
  def create(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW")) end
146
151
 
147
152
  # Disable use of keyboard keys for scrolling.
153
+ #
148
154
  # By default cursor movement keys (including Home, End, Page Up and Down) are used to scroll the window appropriately. If the derived class uses these keys for something else, e.g. changing the currently selected item, this function can be used to disable this behaviour as it's not only not necessary then but can actually be actively harmful if another object forwards a keyboard event corresponding to one of the above keys to us using ProcessWindowEvent() because the event will always be processed which can be undesirable.
149
155
  # @return [void]
150
156
  def disable_keyboard_scrolling; end
151
157
 
152
158
  # Call this function to prepare the device context for drawing a scrolled image.
159
+ #
153
160
  # It sets the device origin according to the current scroll position. Wx::Scrolled#do_prepare_dc is called automatically within the default {Wx::EVT_PAINT} event handler, so your Wx::Scrolled#on_draw override will be passed an already 'pre-scrolled' device context. However, if you wish to draw from outside of Wx::Scrolled#on_draw (e.g. from your own {Wx::EVT_PAINT} handler), you must call this function yourself.
154
161
  # For example:
155
162
  # ```ruby
@@ -178,6 +185,7 @@ module Wx
178
185
  def do_prepare_dc(dc) end
179
186
 
180
187
  # Enable or disable use of {Wx::Window#scroll_window} for scrolling.
188
+ #
181
189
  # By default, when a scrolled window is logically scrolled, {Wx::Window#scroll_window} is called on the underlying window which scrolls the window contents and only invalidates the part of the window newly brought into view. If false is passed as an argument, then this "physical scrolling" is disabled and the window is entirely invalidated whenever it is scrolled by calling {Wx::Window#refresh}.
182
190
  # It should be rarely necessary to disable physical scrolling, so this method shouldn't be called in normal circumstances.
183
191
  # @param xScrolling [Boolean] If true, enables physical scrolling in the x direction.
@@ -186,6 +194,7 @@ module Wx
186
194
  def enable_scrolling(xScrolling, yScrolling) end
187
195
 
188
196
  # Set the scrollbar visibility.
197
+ #
189
198
  # By default the scrollbar in the corresponding direction is only shown if it is needed, i.e. if the virtual size of the scrolled window in this direction is greater than the current physical window size. Using this function the scrollbar visibility can be changed to be:
190
199
  #
191
200
  # - {Wx::ScrollbarVisibility::SHOW_SB_ALWAYS}: To always show the scrollbar, even if it is not needed currently ({Wx::ALWAYS_SHOW_SB} style can be used during the window creation to achieve the same effect but it applies in both directions).
@@ -199,6 +208,7 @@ module Wx
199
208
  def show_scrollbars(horz, vert) end
200
209
 
201
210
  # Get the number of pixels per scroll unit (line), in each direction, as set by Wx::Scrolled#set_scrollbars.
211
+ #
202
212
  # A value of zero indicates no scrolling in that direction.
203
213
  # @see Wx::Scrolled#set_scrollbars
204
214
  # @see Wx::Scrolled#get_virtual_size
@@ -212,11 +222,12 @@ module Wx
212
222
  alias_method :view_start, :get_view_start
213
223
 
214
224
  # Gets the size in device units of the scrollable window area (as opposed to the client size, which is the area of the window currently visible).
225
+ #
215
226
  # <div class="wxrb-remark">
216
227
  # <b>Remark:</b>
217
228
  # <p>Use {Wx::DC#device_to_logical_x} and {Wx::DC#device_to_logical_y} to translate these units to logical units.
218
229
  # </p>
219
- # </div>>
230
+ # </div>
220
231
  # @see Wx::Scrolled#set_scrollbars
221
232
  # @see Wx::Scrolled#get_scroll_pixels_per_unit
222
233
  # @return [Array(Integer,Integer)]
@@ -229,6 +240,7 @@ module Wx
229
240
  alias_method :retained?, :is_retained
230
241
 
231
242
  # This function is for backwards compatibility only and simply calls Wx::Scrolled#do_prepare_dc now.
243
+ #
232
244
  # Notice that it is not called by the default paint event handle (Wx::Scrolled#do_prepare_dc is), so overriding this method in your derived class is useless.
233
245
  # @param dc [Wx::DC]
234
246
  # @return [void]
@@ -236,11 +248,12 @@ module Wx
236
248
 
237
249
  # @overload scroll(x, y)
238
250
  # Scrolls a window so the view start is at the given point.
251
+ #
239
252
  # <div class="wxrb-remark">
240
253
  # <b>Remark:</b>
241
254
  # <p>The positions are in scroll units, not pixels, so to convert to pixels you will have to multiply by the number of pixels per scroll increment. If either parameter is {Wx::DEFAULT_COORD} (-1), that position will be ignored (no change in that direction).
242
255
  # </p>
243
- # </div>>
256
+ # </div>
244
257
  # @see Wx::Scrolled#set_scrollbars
245
258
  # @see Wx::Scrolled#get_scroll_pixels_per_unit
246
259
  # @param x [Integer] The x position to scroll to, in scroll units.
@@ -253,6 +266,7 @@ module Wx
253
266
  def scroll(*args) end
254
267
 
255
268
  # Set the horizontal and vertical scrolling increment only.
269
+ #
256
270
  # See the pixelsPerUnit parameter in Wx::Scrolled#set_scrollbars.
257
271
  # @param xstep [Integer]
258
272
  # @param ystep [Integer]
@@ -260,6 +274,7 @@ module Wx
260
274
  def set_scroll_rate(xstep, ystep) end
261
275
 
262
276
  # Sets up vertical and/or horizontal scrollbars.
277
+ #
263
278
  # The first pair of parameters give the number of pixels per 'scroll step', i.e. amount moved when the up or down scroll arrows are pressed. The second pair gives the length of scrollbar in scroll steps, which sets the size of the virtual window.
264
279
  # xPos and yPos optionally specify a position to scroll to immediately.
265
280
  # For example, the following gives a window horizontal and vertical scrollbars with 20 pixels per scroll step, and a size of 50 steps (1000 pixels) in each direction:
@@ -281,6 +296,7 @@ module Wx
281
296
  def set_scrollbars(pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY, xPos=0, yPos=0, noRefresh=false) end
282
297
 
283
298
  # Call this function to tell {Wx::Scrolled} to perform the actual scrolling on a different window (and not on itself).
299
+ #
284
300
  # This method is useful when only a part of the window should be scrolled. A typical example is a control consisting of a fixed header and the scrollable contents window: the scrollbars are attached to the main window itself, hence it, and not the contents window must be derived from {Wx::Scrolled}, but only the contents window scrolls when the scrollbars are used. To implement such setup, you need to call this method with the contents window as argument.
285
301
  # Notice that if this method is used, Wx::Scrolled#get_size_available_for_scroll_target method must be overridden.
286
302
  # @param window [Wx::Window]
@@ -27,6 +27,7 @@ module Wx
27
27
  end # ScrollbarVisibility
28
28
 
29
29
  # The {Wx::Scrolled} class manages scrolling for its client area, transforming the coordinates according to the scrollbar positions, and setting the scroll positions, thumb sizes and ranges according to the area in view.
30
+ #
30
31
  # There are two commonly used (but not the only possible!) specializations of this class:
31
32
  #
32
33
  # - {Wx::ScrolledWindow}, aka {Wx::Scrolled}<{Wx::Panel}>, is equivalent to {Wx::ScrolledWindow} from earlier versions. Derived from {Wx::Panel}, it shares {Wx::Panel}'s behaviour with regard to TAB traversal and focus handling. Use this if the scrolled window will have child controls.
@@ -95,7 +96,7 @@ module Wx
95
96
  # <b>Remark:</b>
96
97
  # <p>Use {Wx::Scrolled} for applications where the user scrolls by a fixed amount, and where a 'page' can be interpreted to be the current visible portion of the window. For more sophisticated applications, use the {Wx::Scrolled} implementation as a guide to build your own scroll behaviour or use {Wx::VScrolledWindow} or its variants.
97
98
  # </p>
98
- # </div>>
99
+ # </div>
99
100
  #
100
101
  # Category: Miscellaneous Windows
101
102
  # @see Wx::ScrollBar
@@ -114,11 +115,12 @@ module Wx
114
115
  # @return [Wx::ScrolledWindow]
115
116
  # @overload initialize(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW"))
116
117
  # Constructor.
118
+ #
117
119
  # <div class="wxrb-remark">
118
120
  # <b>Remark:</b>
119
121
  # <p>The window is initially created without visible scrollbars. Call Wx::Scrolled#set_scrollbars to specify how big the virtual window size should be.
120
122
  # </p>
121
- # </div>>
123
+ # </div>
122
124
  # @param parent [Wx::Window] Parent window.
123
125
  # @param id [Integer] Window identifier. The value {Wx::StandardID::ID_ANY} indicates a default value.
124
126
  # @param pos [Array(Integer, Integer), Wx::Point] Window position. If a position of {Wx::DEFAULT_POSITION} is specified then a default position is chosen.
@@ -130,6 +132,7 @@ module Wx
130
132
 
131
133
  # @overload calc_scrolled_position(x, y)
132
134
  # Translates the logical coordinates to the device ones.
135
+ #
133
136
  # For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcScrolledPosition(0, 10, xx, yy) will return 0 in yy.
134
137
  # @see Wx::Scrolled#calc_unscrolled_position
135
138
  # @param x [Integer]
@@ -142,6 +145,7 @@ module Wx
142
145
 
143
146
  # @overload calc_unscrolled_position(x, y)
144
147
  # Translates the device coordinates to the logical ones.
148
+ #
145
149
  # For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcUnscrolledPosition(0, 0, xx, yy) will return 10 in yy.
146
150
  # @see Wx::Scrolled#calc_scrolled_position
147
151
  # @param x [Integer]
@@ -153,6 +157,7 @@ module Wx
153
157
  def calc_unscrolled_position(*args) end
154
158
 
155
159
  # Creates the window for two-step construction.
160
+ #
156
161
  # Derived classes should call or replace this function. If it is not replaced, bear in mind that it calls T::Create() through the global function {create_scrolled} so if T::Create() has a different signature than Wx::Scrolled#create you should implement overloaded {create_scrolled} which would call T::Create() in the correct manner.
157
162
  # @see Wx::Scrolled#initialize and create_scrolled for details.
158
163
  # @param parent [Wx::Window]
@@ -165,11 +170,13 @@ module Wx
165
170
  def create(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW")) end
166
171
 
167
172
  # Disable use of keyboard keys for scrolling.
173
+ #
168
174
  # By default cursor movement keys (including Home, End, Page Up and Down) are used to scroll the window appropriately. If the derived class uses these keys for something else, e.g. changing the currently selected item, this function can be used to disable this behaviour as it's not only not necessary then but can actually be actively harmful if another object forwards a keyboard event corresponding to one of the above keys to us using ProcessWindowEvent() because the event will always be processed which can be undesirable.
169
175
  # @return [void]
170
176
  def disable_keyboard_scrolling; end
171
177
 
172
178
  # Call this function to prepare the device context for drawing a scrolled image.
179
+ #
173
180
  # It sets the device origin according to the current scroll position. Wx::Scrolled#do_prepare_dc is called automatically within the default {Wx::EVT_PAINT} event handler, so your Wx::Scrolled#on_draw override will be passed an already 'pre-scrolled' device context. However, if you wish to draw from outside of Wx::Scrolled#on_draw (e.g. from your own {Wx::EVT_PAINT} handler), you must call this function yourself.
174
181
  # For example:
175
182
  # ```ruby
@@ -198,6 +205,7 @@ module Wx
198
205
  def do_prepare_dc(dc) end
199
206
 
200
207
  # Enable or disable use of {Wx::Window#scroll_window} for scrolling.
208
+ #
201
209
  # By default, when a scrolled window is logically scrolled, {Wx::Window#scroll_window} is called on the underlying window which scrolls the window contents and only invalidates the part of the window newly brought into view. If false is passed as an argument, then this "physical scrolling" is disabled and the window is entirely invalidated whenever it is scrolled by calling {Wx::Window#refresh}.
202
210
  # It should be rarely necessary to disable physical scrolling, so this method shouldn't be called in normal circumstances.
203
211
  # @param xScrolling [Boolean] If true, enables physical scrolling in the x direction.
@@ -206,6 +214,7 @@ module Wx
206
214
  def enable_scrolling(xScrolling, yScrolling) end
207
215
 
208
216
  # Set the scrollbar visibility.
217
+ #
209
218
  # By default the scrollbar in the corresponding direction is only shown if it is needed, i.e. if the virtual size of the scrolled window in this direction is greater than the current physical window size. Using this function the scrollbar visibility can be changed to be:
210
219
  #
211
220
  # - {Wx::ScrollbarVisibility::SHOW_SB_ALWAYS}: To always show the scrollbar, even if it is not needed currently ({Wx::ALWAYS_SHOW_SB} style can be used during the window creation to achieve the same effect but it applies in both directions).
@@ -219,6 +228,7 @@ module Wx
219
228
  def show_scrollbars(horz, vert) end
220
229
 
221
230
  # Get the number of pixels per scroll unit (line), in each direction, as set by Wx::Scrolled#set_scrollbars.
231
+ #
222
232
  # A value of zero indicates no scrolling in that direction.
223
233
  # @see Wx::Scrolled#set_scrollbars
224
234
  # @see Wx::Scrolled#get_virtual_size
@@ -232,11 +242,12 @@ module Wx
232
242
  alias_method :view_start, :get_view_start
233
243
 
234
244
  # Gets the size in device units of the scrollable window area (as opposed to the client size, which is the area of the window currently visible).
245
+ #
235
246
  # <div class="wxrb-remark">
236
247
  # <b>Remark:</b>
237
248
  # <p>Use {Wx::DC#device_to_logical_x} and {Wx::DC#device_to_logical_y} to translate these units to logical units.
238
249
  # </p>
239
- # </div>>
250
+ # </div>
240
251
  # @see Wx::Scrolled#set_scrollbars
241
252
  # @see Wx::Scrolled#get_scroll_pixels_per_unit
242
253
  # @return [Array(Integer,Integer)]
@@ -249,6 +260,7 @@ module Wx
249
260
  alias_method :retained?, :is_retained
250
261
 
251
262
  # This function is for backwards compatibility only and simply calls Wx::Scrolled#do_prepare_dc now.
263
+ #
252
264
  # Notice that it is not called by the default paint event handle (Wx::Scrolled#do_prepare_dc is), so overriding this method in your derived class is useless.
253
265
  # @param dc [Wx::DC]
254
266
  # @return [void]
@@ -256,11 +268,12 @@ module Wx
256
268
 
257
269
  # @overload scroll(x, y)
258
270
  # Scrolls a window so the view start is at the given point.
271
+ #
259
272
  # <div class="wxrb-remark">
260
273
  # <b>Remark:</b>
261
274
  # <p>The positions are in scroll units, not pixels, so to convert to pixels you will have to multiply by the number of pixels per scroll increment. If either parameter is {Wx::DEFAULT_COORD} (-1), that position will be ignored (no change in that direction).
262
275
  # </p>
263
- # </div>>
276
+ # </div>
264
277
  # @see Wx::Scrolled#set_scrollbars
265
278
  # @see Wx::Scrolled#get_scroll_pixels_per_unit
266
279
  # @param x [Integer] The x position to scroll to, in scroll units.
@@ -273,6 +286,7 @@ module Wx
273
286
  def scroll(*args) end
274
287
 
275
288
  # Set the horizontal and vertical scrolling increment only.
289
+ #
276
290
  # See the pixelsPerUnit parameter in Wx::Scrolled#set_scrollbars.
277
291
  # @param xstep [Integer]
278
292
  # @param ystep [Integer]
@@ -280,6 +294,7 @@ module Wx
280
294
  def set_scroll_rate(xstep, ystep) end
281
295
 
282
296
  # Sets up vertical and/or horizontal scrollbars.
297
+ #
283
298
  # The first pair of parameters give the number of pixels per 'scroll step', i.e. amount moved when the up or down scroll arrows are pressed. The second pair gives the length of scrollbar in scroll steps, which sets the size of the virtual window.
284
299
  # xPos and yPos optionally specify a position to scroll to immediately.
285
300
  # For example, the following gives a window horizontal and vertical scrollbars with 20 pixels per scroll step, and a size of 50 steps (1000 pixels) in each direction:
@@ -301,6 +316,7 @@ module Wx
301
316
  def set_scrollbars(pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY, xPos=0, yPos=0, noRefresh=false) end
302
317
 
303
318
  # Call this function to tell {Wx::Scrolled} to perform the actual scrolling on a different window (and not on itself).
319
+ #
304
320
  # This method is useful when only a part of the window should be scrolled. A typical example is a control consisting of a fixed header and the scrollable contents window: the scrollbars are attached to the main window itself, hence it, and not the contents window must be derived from {Wx::Scrolled}, but only the contents window scrolls when the scrollbars are used. To implement such setup, you need to call this method with the contents window as argument.
305
321
  # Notice that if this method is used, Wx::Scrolled#get_size_available_for_scroll_target method must be overridden.
306
322
  # @param window [Wx::Window]