wxruby3 0.9.3-x64-mingw-ucrt → 0.9.5-x64-mingw-ucrt

Sign up to get free protection for your applications and to get access to all the features.
Files changed (160) hide show
  1. checksums.yaml +4 -4
  2. data/INSTALL.md +1 -1
  3. data/README.md +2 -2
  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/book_ctrl_base.rb +16 -0
  20. data/lib/wx/core/combo_ctrl.rb +171 -0
  21. data/lib/wx/core/config.rb +454 -83
  22. data/lib/wx/core/notebook.rb +10 -8
  23. data/lib/wx/core/peristent_object.rb +15 -0
  24. data/lib/wx/core/persistence_manager.rb +39 -0
  25. data/lib/wx/core/persistent_window.rb +16 -0
  26. data/lib/wx/core/top_level_window.rb +16 -0
  27. data/lib/wx/core/treebook.rb +18 -0
  28. data/lib/wx/core.rb +4 -0
  29. data/lib/wx/doc/book_ctrl_base.rb +19 -0
  30. data/lib/wx/doc/comboctrl.rb +128 -3
  31. data/lib/wx/doc/config.rb +101 -41
  32. data/lib/wx/doc/extra/14_config.md +101 -0
  33. data/lib/wx/doc/extra/15_persistence.md +148 -0
  34. data/lib/wx/doc/gen/app_traits.rb +2 -54
  35. data/lib/wx/doc/gen/art_provider.rb +0 -2
  36. data/lib/wx/doc/gen/aui/aui_dock_art.rb +77 -77
  37. data/lib/wx/doc/gen/aui/aui_manager.rb +0 -1
  38. data/lib/wx/doc/gen/aui/aui_manager_event.rb +1 -1
  39. data/lib/wx/doc/gen/aui/aui_mdi_client_window.rb +5 -4
  40. data/lib/wx/doc/gen/aui/aui_notebook_event.rb +1 -1
  41. data/lib/wx/doc/gen/aui/aui_tool_bar_event.rb +21 -21
  42. data/lib/wx/doc/gen/book_ctrl_event.rb +1 -1
  43. data/lib/wx/doc/gen/calendar_event.rb +1 -1
  44. data/lib/wx/doc/gen/colour.rb +0 -1
  45. data/lib/wx/doc/gen/colour_dialog.rb +1 -1
  46. data/lib/wx/doc/gen/combo_box.rb +3 -2
  47. data/lib/wx/doc/gen/combo_ctrl.rb +91 -227
  48. data/lib/wx/doc/gen/core.rb +2 -2
  49. data/lib/wx/doc/gen/date_event.rb +1 -1
  50. data/lib/wx/doc/gen/dc.rb +0 -3
  51. data/lib/wx/doc/gen/dialog.rb +0 -1
  52. data/lib/wx/doc/gen/event.rb +4 -4
  53. data/lib/wx/doc/gen/event_blocker.rb +1 -1
  54. data/lib/wx/doc/gen/event_filter.rb +0 -2
  55. data/lib/wx/doc/gen/events.rb +17 -39
  56. data/lib/wx/doc/gen/file_ctrl_event.rb +1 -1
  57. data/lib/wx/doc/gen/file_dialog.rb +0 -2
  58. data/lib/wx/doc/gen/file_dialog_customize_hook.rb +55 -63
  59. data/lib/wx/doc/gen/file_dir_picker_event.rb +1 -1
  60. data/lib/wx/doc/gen/file_system.rb +1 -58
  61. data/lib/wx/doc/gen/find_dialog_event.rb +1 -1
  62. data/lib/wx/doc/gen/frame.rb +0 -1
  63. data/lib/wx/doc/gen/gdi_common.rb +0 -8
  64. data/lib/wx/doc/gen/grid/grid_cell_activatable_editor.rb +0 -2
  65. data/lib/wx/doc/gen/grid/grid_cell_attr.rb +0 -2
  66. data/lib/wx/doc/gen/grid/grid_cell_auto_wrap_string_editor.rb +0 -2
  67. data/lib/wx/doc/gen/grid/grid_cell_auto_wrap_string_renderer.rb +0 -2
  68. data/lib/wx/doc/gen/grid/grid_cell_bool_editor.rb +0 -2
  69. data/lib/wx/doc/gen/grid/grid_cell_bool_renderer.rb +0 -2
  70. data/lib/wx/doc/gen/grid/grid_cell_choice_editor.rb +0 -2
  71. data/lib/wx/doc/gen/grid/grid_cell_date_editor.rb +0 -2
  72. data/lib/wx/doc/gen/grid/grid_cell_date_renderer.rb +0 -2
  73. data/lib/wx/doc/gen/grid/grid_cell_date_time_renderer.rb +0 -2
  74. data/lib/wx/doc/gen/grid/grid_cell_editor.rb +0 -2
  75. data/lib/wx/doc/gen/grid/grid_cell_enum_editor.rb +0 -2
  76. data/lib/wx/doc/gen/grid/grid_cell_enum_renderer.rb +0 -2
  77. data/lib/wx/doc/gen/grid/grid_cell_float_editor.rb +0 -2
  78. data/lib/wx/doc/gen/grid/grid_cell_float_renderer.rb +0 -2
  79. data/lib/wx/doc/gen/grid/grid_cell_number_editor.rb +0 -2
  80. data/lib/wx/doc/gen/grid/grid_cell_number_renderer.rb +0 -2
  81. data/lib/wx/doc/gen/grid/grid_cell_renderer.rb +0 -2
  82. data/lib/wx/doc/gen/grid/grid_cell_string_renderer.rb +0 -2
  83. data/lib/wx/doc/gen/grid/grid_cell_text_editor.rb +0 -2
  84. data/lib/wx/doc/gen/grid/grid_ctrl.rb +0 -12
  85. data/lib/wx/doc/gen/grid/grid_editor_created_event.rb +1 -1
  86. data/lib/wx/doc/gen/grid/grid_event.rb +1 -1
  87. data/lib/wx/doc/gen/grid/grid_range_select_event.rb +1 -1
  88. data/lib/wx/doc/gen/grid/grid_size_event.rb +1 -1
  89. data/lib/wx/doc/gen/gui_event_loop.rb +0 -2
  90. data/lib/wx/doc/gen/header_ctrl.rb +0 -7
  91. data/lib/wx/doc/gen/header_ctrl_event.rb +1 -1
  92. data/lib/wx/doc/gen/html/html_cell_event.rb +1 -1
  93. data/lib/wx/doc/gen/image.rb +0 -2
  94. data/lib/wx/doc/gen/list_ctrl.rb +0 -1
  95. data/lib/wx/doc/gen/list_event.rb +1 -1
  96. data/lib/wx/doc/gen/media_ctrl.rb +0 -6
  97. data/lib/wx/doc/gen/media_event.rb +1 -1
  98. data/lib/wx/doc/gen/menu.rb +0 -2
  99. data/lib/wx/doc/gen/notebook.rb +0 -1
  100. data/lib/wx/doc/gen/persistence_manager.rb +135 -0
  101. data/lib/wx/doc/gen/persistent_object.rb +52 -0
  102. data/lib/wx/doc/gen/persistent_window.rb +116 -0
  103. data/lib/wx/doc/gen/pg/pg_property.rb +0 -13
  104. data/lib/wx/doc/gen/pg/pg_validation_info.rb +0 -2
  105. data/lib/wx/doc/gen/pg/property_grid.rb +0 -2
  106. data/lib/wx/doc/gen/pg/property_grid_event.rb +1 -1
  107. data/lib/wx/doc/gen/pg/property_grid_interface.rb +2 -2
  108. data/lib/wx/doc/gen/pg/property_grid_manager.rb +0 -2
  109. data/lib/wx/doc/gen/pg/property_grid_page.rb +0 -2
  110. data/lib/wx/doc/gen/pg/property_grid_page_state.rb +0 -1
  111. data/lib/wx/doc/gen/prt/post_script_dc.rb +0 -1
  112. data/lib/wx/doc/gen/rbn/ribbon_bar_event.rb +1 -1
  113. data/lib/wx/doc/gen/rbn/ribbon_button_bar_event.rb +1 -1
  114. data/lib/wx/doc/gen/rbn/ribbon_gallery_event.rb +1 -1
  115. data/lib/wx/doc/gen/rbn/ribbon_panel_event.rb +1 -1
  116. data/lib/wx/doc/gen/rbn/ribbon_tool_bar_event.rb +1 -1
  117. data/lib/wx/doc/gen/rtc/rich_text_event.rb +1 -1
  118. data/lib/wx/doc/gen/rtc/rich_text_html_handler.rb +0 -1
  119. data/lib/wx/doc/gen/rtc/rich_text_style_list_box.rb +3 -0
  120. data/lib/wx/doc/gen/rtc/rich_text_xml_handler.rb +0 -1
  121. data/lib/wx/doc/gen/scroll_bar.rb +0 -1
  122. data/lib/wx/doc/gen/sizer.rb +0 -1
  123. data/lib/wx/doc/gen/slider.rb +0 -1
  124. data/lib/wx/doc/gen/spin_double_event.rb +1 -1
  125. data/lib/wx/doc/gen/spin_event.rb +1 -1
  126. data/lib/wx/doc/gen/splash_screen.rb +1 -1
  127. data/lib/wx/doc/gen/splitter_event.rb +1 -1
  128. data/lib/wx/doc/gen/stc/styled_text_ctrl.rb +0 -1
  129. data/lib/wx/doc/gen/stc/styled_text_event.rb +1 -2
  130. data/lib/wx/doc/gen/task_bar_icon.rb +0 -1
  131. data/lib/wx/doc/gen/task_bar_icon_event.rb +1 -1
  132. data/lib/wx/doc/gen/text_ctrl.rb +0 -5
  133. data/lib/wx/doc/gen/text_entry.rb +0 -4
  134. data/lib/wx/doc/gen/tree_ctrl.rb +0 -2
  135. data/lib/wx/doc/gen/tree_event.rb +1 -1
  136. data/lib/wx/doc/gen/utils.rb +0 -16
  137. data/lib/wx/doc/gen/v_scrolled_window.rb +0 -1
  138. data/lib/wx/doc/gen/wizard.rb +0 -1
  139. data/lib/wx/doc/gen/wizard_event.rb +1 -1
  140. data/lib/wx/doc/gen/wizard_page.rb +0 -1
  141. data/lib/wx/doc/owner_drawn_combobox.rb +5 -1
  142. data/lib/wx/doc/persistence_manager.rb +36 -0
  143. data/lib/wx/doc/persistent_object.rb +27 -0
  144. data/lib/wx/doc/top_level_window.rb +19 -0
  145. data/lib/wx/doc/treebook.rb +6 -1
  146. data/lib/wx/version.rb +1 -1
  147. data/lib/wxruby_aui.so +0 -0
  148. data/lib/wxruby_core.so +0 -0
  149. data/lib/wxruby_grid.so +0 -0
  150. data/lib/wxruby_html.so +0 -0
  151. data/lib/wxruby_pg.so +0 -0
  152. data/lib/wxruby_prt.so +0 -0
  153. data/lib/wxruby_rbn.so +0 -0
  154. data/lib/wxruby_rtc.so +0 -0
  155. data/lib/wxruby_stc.so +0 -0
  156. data/samples/widgets/widgets.rb +5 -9
  157. data/tests/test_combo_ctrl.rb +196 -0
  158. data/tests/test_config.rb +207 -42
  159. data/tests/test_persistence.rb +142 -0
  160. metadata +20 -2
@@ -18,8 +18,6 @@ module Wx::GRID
18
18
  # @see Wx::GRID::GridCellStringRenderer
19
19
  #
20
20
  #
21
- #
22
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
23
21
  # @wxrb_require USE_GRID
24
22
  class GridCellNumberRenderer < GridCellStringRenderer
25
23
 
@@ -20,8 +20,6 @@ module Wx::GRID
20
20
  # @see Wx::GRID::GridCellStringRenderer
21
21
  #
22
22
  #
23
- #
24
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
25
23
  # @wxrb_require USE_GRID
26
24
  class GridCellRenderer < ::Object
27
25
 
@@ -18,8 +18,6 @@ module Wx::GRID
18
18
  # @see Wx::GRID::GridCellNumberRenderer
19
19
  #
20
20
  #
21
- #
22
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
23
21
  # @wxrb_require USE_GRID
24
22
  class GridCellStringRenderer < GridCellRenderer
25
23
 
@@ -19,8 +19,6 @@ module Wx::GRID
19
19
  # @see Wx::GRID::GridCellDateEditor
20
20
  #
21
21
  #
22
- #
23
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
24
22
  # @wxrb_require USE_GRID
25
23
  class GridCellTextEditor < GridCellEditor
26
24
 
@@ -273,18 +273,6 @@ module Wx::GRID
273
273
  # @wxrb_require USE_GRID
274
274
  class CellSpan < Wx::Enum
275
275
 
276
- # This cell is inside a span covered by another cell.
277
- #
278
- CellSpan_Inside = Wx::GRID::Grid::CellSpan.new(-1)
279
-
280
- # This is a normal, non-spanning cell.
281
- #
282
- CellSpan_None = Wx::GRID::Grid::CellSpan.new(0)
283
-
284
- # This cell spans several physical {Wx::GRID::Grid} cells.
285
- #
286
- CellSpan_Main = Wx::GRID::Grid::CellSpan.new(1)
287
-
288
276
  end # CellSpan
289
277
 
290
278
  # Constants defining different support built-in TAB handling behaviours.
@@ -28,7 +28,7 @@ module Wx::GRID
28
28
  # @overload initialize(id, type, obj, row, col, ctrl)
29
29
  # Constructor for initializing all event attributes.
30
30
  # @param id [Integer]
31
- # @param type [Wx::StaticLine::EventType]
31
+ # @param type [Wx::Notebook::EventType]
32
32
  # @param obj [Wx::Object]
33
33
  # @param row [Integer]
34
34
  # @param col [Integer]
@@ -59,7 +59,7 @@ module Wx::GRID
59
59
  # @overload initialize(id, type, obj, row=-1, col=-1, x=-1, y=-1, sel=true, kbd=(Wx::KeyboardState.new()))
60
60
  # Constructor for initializing all event attributes.
61
61
  # @param id [Integer]
62
- # @param type [Wx::StaticLine::EventType]
62
+ # @param type [Wx::Notebook::EventType]
63
63
  # @param obj [Wx::Object]
64
64
  # @param row [Integer]
65
65
  # @param col [Integer]
@@ -35,7 +35,7 @@ module Wx::GRID
35
35
  # @overload initialize(id, type, obj, topLeft, bottomRight, sel=true, kbd=(Wx::KeyboardState.new()))
36
36
  # Constructor for initializing all event attributes.
37
37
  # @param id [Integer]
38
- # @param type [Wx::StaticLine::EventType]
38
+ # @param type [Wx::Notebook::EventType]
39
39
  # @param obj [Wx::Object]
40
40
  # @param topLeft [Array(Integer, Integer)]
41
41
  # @param bottomRight [Array(Integer, Integer)]
@@ -36,7 +36,7 @@ module Wx::GRID
36
36
  # @overload initialize(id, type, obj, rowOrCol=-1, x=-1, y=-1, kbd=(Wx::KeyboardState.new()))
37
37
  # Constructor for initializing all event attributes.
38
38
  # @param id [Integer]
39
- # @param type [Wx::StaticLine::EventType]
39
+ # @param type [Wx::Notebook::EventType]
40
40
  # @param obj [Wx::Object]
41
41
  # @param rowOrCol [Integer]
42
42
  # @param x [Integer]
@@ -10,8 +10,6 @@ module Wx
10
10
  #
11
11
  # Category: Application and Process Management
12
12
  #
13
- #
14
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
15
13
  class GUIEventLoop < ::Object
16
14
 
17
15
  # @return [Wx::GUIEventLoop]
@@ -62,7 +62,6 @@ module Wx
62
62
  # This control is implemented using the native header control under MSW systems and a generic implementation elsewhere.
63
63
  #
64
64
  # ## Future Improvements
65
- #
66
65
  # Some features are supported by the native MSW control and so could be easily implemented in this version of {Wx::HeaderCtrl} but need to be implemented in the generic version as well to be really useful. Please let us know if you need or, better, plan to work on implementing, any of them:
67
66
  #
68
67
  # - Displaying bitmaps instead of or together with the text
@@ -370,8 +369,6 @@ module Wx
370
369
  #
371
370
  # Category: {Wx::Controls}
372
371
  #
373
- #
374
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
375
372
  class HeaderColumn < ::Object
376
373
 
377
374
  # Get the text shown in the column header.
@@ -584,8 +581,6 @@ module Wx
584
581
  #
585
582
  # Category: {Wx::Controls}
586
583
  #
587
- #
588
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
589
584
  class SettableHeaderColumn < HeaderColumn
590
585
 
591
586
  # Set the text to display in the column header.
@@ -737,8 +732,6 @@ module Wx
737
732
  #
738
733
  # Category: {Wx::Controls}
739
734
  #
740
- #
741
- # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
742
735
  class HeaderColumnSimple < SettableHeaderColumn
743
736
 
744
737
  # @overload initialize(title, width=Wx::COL_WIDTH_DEFAULT, align=Wx::Alignment::ALIGN_NOT, flags=Wx::COL_DEFAULT_FLAGS)
@@ -83,7 +83,7 @@ module Wx
83
83
  class HeaderCtrlEvent < NotifyEvent
84
84
 
85
85
  # @overload initialize(commandType=Wx::EVT_NULL, winid=0)
86
- # @param commandType [Wx::StaticLine::EventType]
86
+ # @param commandType [Wx::Notebook::EventType]
87
87
  # @param winid [Integer]
88
88
  # @return [Wx::HeaderCtrlEvent]
89
89
  # @overload initialize(event)
@@ -23,7 +23,7 @@ module Wx::HTML
23
23
  class HtmlCellEvent < CommandEvent
24
24
 
25
25
  # The constructor is not normally used by the user code.
26
- # @param commandType [Wx::StaticLine::EventType]
26
+ # @param commandType [Wx::Notebook::EventType]
27
27
  # @param id [Integer]
28
28
  # @param cell [Wx::HTML::HtmlCell]
29
29
  # @param point [Array(Integer, Integer), Wx::Point]
@@ -253,13 +253,11 @@ module Wx
253
253
  # One colour value of the image may be used as a mask colour which will lead to the automatic creation of a {Wx::Mask} object associated to the bitmap object.
254
254
  #
255
255
  # ## Alpha channel support
256
- #
257
256
  # Starting from wxWidgets 2.5.0 {Wx::Image} supports alpha channel data, that is in addition to a byte for the red, green and blue colour components for each pixel it also stores a byte representing the pixel opacity.
258
257
  # An alpha value of 0 corresponds to a transparent pixel (null opacity) while a value of 255 means that the pixel is 100% opaque. The constants {Wx::IMAGE_ALPHA_TRANSPARENT} and {Wx::IMAGE_ALPHA_OPAQUE} can be used to indicate those values in a more readable form.
259
258
  # While all images have RGB data, not all images have an alpha channel. Before using {Wx::Image#get_alpha} you should check if this image contains an alpha channel with {Wx::Image#has_alpha}. Currently the BMP, PNG, TGA, and TIFF format handlers have full alpha channel support for loading so if you want to use alpha you have to use one of these formats. If you initialize the image alpha channel yourself using {Wx::Image#set_alpha}, you should save it in either PNG, TGA, or TIFF format to avoid losing it as these are the only handlers that currently support saving with alpha.
260
259
  #
261
260
  # ## Available image handlers
262
- #
263
261
  # The following image handlers are available. {Wx::BMPHandler} is always installed by default. In wxRuby all image handlers are loaded by default at startup by {init_all_image_handlers}.
264
262
  #
265
263
  # - {Wx::BMPHandler}: For loading (including alpha support) and saving, always installed.
@@ -329,7 +329,6 @@ module Wx
329
329
  # </div>
330
330
  #
331
331
  # ## Column Ordering
332
- #
333
332
  # By default, the columns of a list control appear on the screen in order of their indices, i.e. column 0 appears first, then column 1 next, and so on. However this can be changed by using the {Wx::ListCtrl#set_columns_order} function to arbitrarily reorder the columns visual order.
334
333
  # The user can also rearrange the columns interactively by dragging them. In this case, the index of the column is not the same as its order and the functions {Wx::ListCtrl#get_column_order} and {Wx::ListCtrl#get_column_index_from_order} should be used to translate between them.
335
334
  #
@@ -65,7 +65,7 @@ module Wx
65
65
  class ListEvent < NotifyEvent
66
66
 
67
67
  # Constructor.
68
- # @param commandType [Wx::StaticLine::EventType]
68
+ # @param commandType [Wx::Notebook::EventType]
69
69
  # @param id [Integer]
70
70
  # @return [Wx::ListEvent]
71
71
  def initialize(commandType=Wx::EVT_NULL, id=0) end
@@ -11,13 +11,11 @@ module Wx
11
11
  # {Wx::MediaCtrl} uses native backends to render media, for example on Windows there is a ActiveMovie/DirectShow backend, and on Macintosh there is a QuickTime backend.
12
12
  #
13
13
  # ## Rendering media
14
- #
15
14
  # Depending upon the backend, {Wx::MediaCtrl} can render and display pretty much any kind of media that the native system can - such as an image, mpeg video, or mp3 (without license restrictions - since it relies on native system calls that may not technically have mp3 decoding available, for example, it falls outside the realm of licensing restrictions).
16
15
  # For general operation, all you need to do is call {Wx::MediaCtrl#load} to load the file you want to render, catch the EVT_MEDIA_LOADED event, and then call {Wx::MediaCtrl#play} to show the video/audio of the media in that event.
17
16
  # More complex operations are generally more heavily dependent on the capabilities of the backend. For example, QuickTime cannot set the playback rate of certain streaming media - while DirectShow is slightly more flexible in that regard.
18
17
  #
19
18
  # ## Operation
20
- #
21
19
  # When {Wx::MediaCtrl} plays a file, it plays until the stop position is reached (currently the end of the file/stream). Right before it hits the end of the stream, it fires off a EVT_MEDIA_STOP event to its parent window, at which point the event handler can choose to veto the event, preventing the stream from actually stopping.
22
20
  # Example:
23
21
  #
@@ -40,16 +38,13 @@ module Wx
40
38
  # Note that when changing the state of the media through {Wx::MediaCtrl#play} and other methods, the media may not actually be in the {Wx::MediaState::MEDIASTATE_PLAYING}, for example. If you are relying on the media being in certain state, catch the event relevant to the state. See {Wx::MediaEvent} for the kinds of events that you can catch.
41
39
  #
42
40
  # ## Video size
43
- #
44
41
  # By default, {Wx::MediaCtrl} will scale the size of the video to the requested amount passed to either its constructor or {Wx::MediaCtrl#create}. After calling {Wx::MediaCtrl#load} or performing an equivalent operation, you can subsequently obtain the "real" size of the video (if there is any) by calling {Wx::MediaCtrl#get_best_size}. Note that the actual result on the display will be slightly different when {Wx::MediaCtrl#show_player_controls} is activated and the actual video size will be less than specified due to the extra controls provided by the native toolkit. In addition, the backend may modify {Wx::MediaCtrl#get_best_size} to include the size of the extra controls - so if you want the real size of the video just disable {Wx::MediaCtrl#show_player_controls}.
45
42
  # The idea with setting {Wx::MediaCtrl#get_best_size} to the size of the video is that {Wx::MediaCtrl#get_best_size} is a {Wx::Window}-derived function that is called when sizers on a window recalculate. What this means is that if you use sizers by default the video will show in its original size without any extra assistance needed from the user.
46
43
  #
47
44
  # ## Player controls
48
- #
49
45
  # Normally, when you use {Wx::MediaCtrl} it is just a window for the video to play in. However, some toolkits have their own media player interface. For example, QuickTime generally has a bar below the video with a slider. A special feature available to {Wx::MediaCtrl}, you can use the toolkits interface instead of making your own by using the {Wx::MediaCtrl#show_player_controls} function. There are several options for the flags parameter, with the two general flags being {Wx::MediaCtrlPlayerControls::MEDIACTRLPLAYERCONTROLS_NONE} which turns off the native interface, and {Wx::MediaCtrlPlayerControls::MEDIACTRLPLAYERCONTROLS_DEFAULT} which lets {Wx::MediaCtrl} decide what native controls on the interface. Be sure to review the caveats outlined in Video size before doing so.
50
46
  #
51
47
  # ## Choosing a backend
52
- #
53
48
  # Generally, you should almost certainly leave this part up to {Wx::MediaCtrl} - but if you need a certain backend for a particular reason, such as QuickTime for playing .mov files, all you need to do to choose a specific backend is to pass the name of the backend class to {Wx::MediaCtrl#create}.
54
49
  # The following are valid backend identifiers:
55
50
  #
@@ -59,7 +54,6 @@ module Wx
59
54
  # - <b>{Wx::MEDIABACKEND_WMP10}</b>, Use Windows Media Player 10 (Windows only). Works on systems with either Windows Media Player 9 or 10 installed.
60
55
  #
61
56
  # ## Creating a backend
62
- #
63
57
  # Creating a backend for {Wx::MediaCtrl} is a rather simple process. Simply derive from {Wx::MediaBackendCommonBase} and implement the methods you want. The methods in {Wx::MediaBackend} correspond to those in {Wx::MediaCtrl} except for {Wx::MediaCtrl::CreateControl} which does the actual creation of the control, in cases where a custom control is not needed you may simply call {Wx::Control#create}.
64
58
  # You need to make sure to use the {Wx::DECLARE_CLASS} and {Wx::IMPLEMENT_CLASS} macros.
65
59
  # The only real tricky part is that you need to make sure the file in compiled in, which if there are just backends in there will not happen and you may need to use a force link hack (see {Wx::FORCE_LINK_MODULE} usage in the mediactrl sample).
@@ -106,7 +106,7 @@ module Wx
106
106
  class MediaEvent < NotifyEvent
107
107
 
108
108
  # Default ctor.
109
- # @param commandType [Wx::StaticLine::EventType]
109
+ # @param commandType [Wx::Notebook::EventType]
110
110
  # @param winid [Integer]
111
111
  # @return [Wx::MediaEvent]
112
112
  def initialize(commandType=Wx::EVT_NULL, winid=0) end
@@ -21,12 +21,10 @@ module Wx
21
21
  # The radio items are similar to the check items except that all the other items in the same radio group are unchecked when a radio item is checked. The radio group is formed by a contiguous range of radio items, i.e. it starts at the first item of this kind and ends with the first item of a different kind (or the end of the menu). Notice that because the radio groups are defined in terms of the item positions inserting or removing the items in the menu containing the radio items risks to not work correctly.
22
22
  #
23
23
  # ## Allocation strategy
24
- #
25
24
  # All menus must be created on the <b>heap</b> because all menus attached to a menubar or to another menu will be deleted by their parent when it is deleted. The only exception to this rule are the popup menus (i.e. menus used with {Wx::Window#popup_menu}) as wxWidgets does not destroy them to allow reusing the same menu more than once. But the exception applies only to the menus themselves and not to any submenus of popup menus which are still destroyed by wxWidgets as usual and so must be heap-allocated.
26
25
  # As the frame menubar is deleted by the frame itself, it means that normally all menus used are deleted automatically.
27
26
  #
28
27
  # ## Event handling
29
- #
30
28
  # Event handlers for the commands generated by the menu items can be connected directly to the menu object itself using {Wx::EvtHandler#bind}. If this menu is a submenu of another one, the events from its items can also be processed in the parent menu and so on, recursively.
31
29
  # If the menu is part of a menu bar, then events can also be handled in {Wx::MenuBar} object.
32
30
  # Finally, menu events can also be handled in the associated window, which is either the {Wx::Frame} associated with the menu bar this menu belongs to or the window for which {Wx::Window#popup_menu} was called for the popup menus.
@@ -91,7 +91,6 @@ module Wx
91
91
  # - {Wx::EvtHandler#evt_notebook_page_changing}(id, meth = nil, &block): The page selection is about to be changed. Processes a {Wx::EVT_NOTEBOOK_PAGE_CHANGING} event. This event can be vetoed.
92
92
  #
93
93
  # ## Page backgrounds
94
- #
95
94
  # On Windows, the default theme paints a background on the notebook's pages. If you wish to suppress this theme, for aesthetic or performance reasons, there are three ways of doing it. You can use {Wx::NB_NOPAGETHEME} to disable themed drawing for a particular notebook, you can call {Wx::SystemOptions.set_option} to disable it for the whole application, or you can disable it for individual pages by using {Wx::Notebook#set_background_colour}.
96
95
  # To disable themed pages globally:
97
96
  # ```ruby
@@ -0,0 +1,135 @@
1
+ # :stopdoc:
2
+ # This file is automatically generated by the WXRuby3 documentation
3
+ # generator. Do not alter this file.
4
+ # :startdoc:
5
+
6
+
7
+ module Wx
8
+
9
+ # Provides support for automatically saving and restoring object properties to persistent storage.
10
+ #
11
+ # This class is the central element of wxWidgets persistence framework, see Persistent Objects Overview for its overview.
12
+ # This is a singleton class and its unique instance can be retrieved using {Wx::PersistenceManager.get} method.
13
+ #
14
+ # @wxrb_require USE_CONFIG
15
+ class PersistenceManager < ::Object
16
+
17
+ # @overload register_and_restore(obj)
18
+ # Combines both {Wx::PersistenceManager#register} and {Wx::PersistenceManager#restore} calls.
19
+ # @param obj [Object]
20
+ # @return [Boolean]
21
+ # @overload register_and_restore(obj, po)
22
+ # Combines both {Wx::PersistenceManager#register} and {Wx::PersistenceManager#restore} calls.
23
+ # @param obj [Object]
24
+ # @param po [Wx::PersistentObject]
25
+ # @return [Boolean]
26
+ def register_and_restore(*args) end
27
+
28
+ # Set the global persistence manager to use.
29
+ #
30
+ # Call this method to specify a non-default persistence manager to use. It should usually be called very early (e.g. in {Wx::App}-derived class constructor or in the beginning of overridden {Wx::App#on_init}) to affect creation of all persistent controls and the object passed to it must have a lifetime long enough to be still alive when the persistent controls are destroyed and need it to save their state so typically this would be a global or a {Wx::App} member.
31
+ # @param manager [Wx::PersistenceManager]
32
+ # @return [void]
33
+ def self.set(manager) end
34
+
35
+ # Returns the unique persistence manager object.
36
+ #
37
+ # If {Wx::PersistenceManager.set} hadn't been called before, a default persistence manager implementation is returned.
38
+ # @return [Wx::PersistenceManager]
39
+ def self.get; end
40
+
41
+ # Globally disable saving the persistence object properties.
42
+ #
43
+ # By default, saving properties in {Wx::PersistenceManager#save} is enabled but the program may wish to disable if, for example, it detects that it is running on a system which shouldn't be modified in any way and so configuration file (or Windows registry) shouldn't be written to.
44
+ # @see Wx::PersistenceManager#disable_restoring
45
+ # @return [void]
46
+ def disable_saving; end
47
+
48
+ # Globally disable restoring the persistence object properties.
49
+ #
50
+ # By default, restoring properties in {Wx::PersistenceManager#restore} is enabled but this function allows disabling it. This is mostly useful for testing.
51
+ # @see Wx::PersistenceManager#disable_saving
52
+ # @return [void]
53
+ def disable_restoring; end
54
+
55
+ # @overload register(obj)
56
+ # Register an object with the manager automatically creating a persistence adapter for it.
57
+ #
58
+ # This is equivalent to calling Register(void *, wxPersistentObject *) with {create_persistent_object(obj)} as the second argument.
59
+ # @param obj [Object] The object to register. {create_persistent_object} overload must be defined for the objects of this class.
60
+ # @return [Wx::PersistentObject]
61
+ # @overload register(obj, po)
62
+ # Register an object with the manager.
63
+ #
64
+ # Note that registering the object doesn't do anything except allowing to call {Wx::PersistenceManager#restore} for it later. If you want to register the object and restore its properties, use {Wx::PersistenceManager#register_and_restore}.
65
+ # The manager takes ownership of po and will delete it when it is unregistered.
66
+ # @param obj [Object] The object to register.
67
+ # @param po [Wx::PersistentObject] The {Wx::PersistentObject} to use for saving and restoring this object properties.
68
+ # @return [Wx::PersistentObject]
69
+ def register(*args) end
70
+
71
+ # Check if the object is registered and return the associated {Wx::PersistentObject} if it is or NULL otherwise.
72
+ # @param obj [Object]
73
+ # @return [Wx::PersistentObject]
74
+ def find(obj) end
75
+
76
+ # Unregister the object and delete the associated {Wx::PersistentObject}.
77
+ #
78
+ # For the persistent windows this is done automatically (via {Wx::PersistenceManager#save_and_unregister}) when the window is destroyed so you only need to call this function explicitly if you are using custom persistent objects or if you want to prevent the object properties from being saved.
79
+ # @param obj [Object] An object previously registered with {Wx::PersistenceManager#register}.
80
+ # @return [void]
81
+ def unregister(obj) end
82
+
83
+ # Save the object properties to persistent storage.
84
+ #
85
+ # This method does nothing if {Wx::PersistenceManager#disable_saving} had been called.
86
+ # @see Wx::PersistenceManager#save_and_unregister
87
+ # @param obj [Object] An object previously registered with {Wx::PersistenceManager#register}.
88
+ # @return [void]
89
+ def save(obj) end
90
+
91
+ # Restore the object properties previously saved by {Wx::PersistenceManager#save}.
92
+ #
93
+ # This method does nothing if {Wx::PersistenceManager#disable_restoring} had been called.
94
+ #
95
+ # true if the object properties were restored or false if nothing was found to restore or the saved settings were invalid.
96
+ # @see Wx::PersistenceManager#register_and_restore
97
+ # @param obj [Object] An object previously registered with {Wx::PersistenceManager#register}.
98
+ # @return [Boolean]
99
+ def restore(obj) end
100
+
101
+ # Combines both {Wx::PersistenceManager#save} and {Wx::PersistenceManager#unregister} calls.
102
+ # @param obj [Object]
103
+ # @return [void]
104
+ def save_and_unregister(obj) end
105
+
106
+
107
+ protected
108
+
109
+ # Protected default constructor.
110
+ #
111
+ # This constructor is only provided for the derived classes, to use an object of this class static {Wx::PersistenceManager.get} method should be called.
112
+ # @return [Wx::PersistenceManager]
113
+ def initialize; end
114
+
115
+ # Return the config object to use.
116
+ #
117
+ # By default the global {Wx::Config}, returned by {Wx::ConfigBase#get}, is used but a derived class could override this function to return a different one if necessary.
118
+ # @return [Wx::ConfigBase]
119
+ def get_config; end
120
+ alias_method :config, :get_config
121
+
122
+ # Return the path to use for saving the setting with the given name for the specified object.
123
+ #
124
+ # Notice that the name argument is the name of the setting, not the name of the object itself which can be retrieved with its GetName() method.
125
+ # This method can be overridden by a derived class to change where in {Wx::Config} the different options are stored. By default, all settings of the persistent controls are stored under "Persistent_Options" group and grouped by control type (e.g. "Window" for top level windows or "Splitter") and name, so that the position of a splitter called "sep" could be stored under "Persistent_Options/Splitter/sep/Position" key.
126
+ # @param who [Wx::PersistentObject]
127
+ # @param name [String]
128
+ # @return [String]
129
+ def get_key(who, name) end
130
+ alias_method :key, :get_key
131
+
132
+ end # PersistenceManager
133
+
134
+
135
+ end
@@ -0,0 +1,52 @@
1
+ # :stopdoc:
2
+ # This file is automatically generated by the WXRuby3 documentation
3
+ # generator. Do not alter this file.
4
+ # :startdoc:
5
+
6
+
7
+ module Wx
8
+
9
+ # Base class for persistent object adapters.
10
+ #
11
+ # See Persistent Objects Overview for an overview of persistent objects within wxWidgets.
12
+ # wxWidgets persistence framework is non-intrusive, i.e. can work with the classes which have no relationship to nor knowledge of it. To allow this, an intermediate persistence adapter is used: this is just a simple object which provides the methods used by {Wx::PersistenceManager} to save and restore the object properties and implements them using the concrete class methods.
13
+ # You may derive your own classes from {Wx::PersistentObject} to implement persistence support for your common classes, see Defining Custom Persistent Windows.
14
+ # @see wxPersistentWindow<>
15
+ #
16
+ #
17
+ # @wxrb_require USE_CONFIG
18
+ class PersistentObject < ::Object
19
+
20
+ # Save the object properties.
21
+ #
22
+ # The implementation of this method should use {Wx::PersistentObject#save_value}.
23
+ # @return [void]
24
+ def save; end
25
+
26
+ # Restore the object properties.
27
+ #
28
+ # The implementation of this method should use {Wx::PersistentObject#restore_value}.
29
+ # @return [Boolean]
30
+ def restore; end
31
+
32
+ # Returns the string uniquely identifying the objects supported by this adapter.
33
+ #
34
+ # This method is called from {Wx::PersistentObject#save_value} and {Wx::PersistentObject#restore_value} and normally returns some short (but not too cryptic) strings, e.g. <code>"Checkbox"</code>.
35
+ # @return [String]
36
+ def get_kind; end
37
+ alias_method :kind, :get_kind
38
+
39
+ # Returns the string uniquely identifying the object we're associated with among all the other objects of the same type.
40
+ #
41
+ # This method is used together with {Wx::PersistentObject#get_kind} to construct the unique full name of the object in e.g. a configuration file.
42
+ # @return [String]
43
+ def get_name; end
44
+ alias_method :name, :get_name
45
+
46
+
47
+ protected
48
+
49
+ end # PersistentObject
50
+
51
+
52
+ end
@@ -0,0 +1,116 @@
1
+ # :stopdoc:
2
+ # This file is automatically generated by the WXRuby3 documentation
3
+ # generator. Do not alter this file.
4
+ # :startdoc:
5
+
6
+
7
+ module Wx
8
+
9
+ # Base class for persistent windows.
10
+ #
11
+ # Compared to {Wx::PersistentObject} this class does three things:
12
+ #
13
+ # - Most importantly, {Wx::PersistentWindow} catches {Wx::WindowDestroyEvent} generated when the window is destroyed and saves its properties automatically when it happens.
14
+ # - It implements {Wx::PersistentWindow#get_name} using {Wx::Window#get_name} so that the derived classes don't need to do it.
15
+ # - It adds a convenient {Wx::PersistentWindow#get} accessor returning the window object of the correct type.
16
+ #
17
+ # @wxrb_require USE_CONFIG
18
+ class PersistentWindowBase < PersistentObject
19
+
20
+ # Constructor for a persistent window object.
21
+ #
22
+ # The constructor uses {Wx::EvtHandler#bind} to catch {Wx::WindowDestroyEvent} generated when the window is destroyed and call {Wx::PersistenceManager#save_and_unregister} when this happens. This ensures that the window properties are saved and that this object itself is deleted when the window is.
23
+ # @param win [Wx::Window]
24
+ # @return [Wx::PersistentWindowBase]
25
+ def initialize(win) end
26
+
27
+ # @return [Wx::Window]
28
+ def get; end
29
+
30
+ # Implements the base class pure virtual method using {Wx::Window#get_name}.
31
+ #
32
+ # Notice that window names are usually not unique while this function must return a unique (at least among the objects of this type) string. Because of this you need to specify a non-default window name in its constructor when creating it or explicitly call {Wx::Window#set_name} before saving or restoring persistent properties.
33
+ # @return [String]
34
+ def get_name; end
35
+ alias_method :name, :get_name
36
+
37
+
38
+ protected
39
+
40
+ end # PersistentWindowBase
41
+
42
+ # Persistence adapter for {Wx::TopLevelWindow}.
43
+ #
44
+ # This adapter saves and restores the geometry (i.e. position and size) and the state (iconized, maximized or normal) of top level windows. It can be used with both {Wx::Frame} and {Wx::Dialog}.
45
+ # Note that it does not save nor restore the window visibility.
46
+ #
47
+ # @wxrb_require USE_CONFIG
48
+ class PersistentTLW < PersistentWindow
49
+
50
+ # Constructor.
51
+ # @param book [Wx::TopLevelWindow] The associated window.
52
+ # @return [Wx::PersistentTLW]
53
+ def initialize(book) end
54
+
55
+ # Save the current window geometry.
56
+ # @return [void]
57
+ def save; end
58
+
59
+ # Restore the window geometry.
60
+ # @return [Boolean]
61
+ def restore; end
62
+
63
+ end # PersistentTLW
64
+
65
+ # Persistence adapter for {Wx::BookCtrlBase}.
66
+ #
67
+ # This adapter handles the selected page of {Wx::BookCtrlBase}, i.e. it saves its value when the associated book control is destroyed and restores it when it is recreated.
68
+ # @see Wx::PersistentTreeBookCtrl
69
+ #
70
+ #
71
+ # @wxrb_require USE_CONFIG
72
+ class PersistentBookCtrl < PersistentWindow
73
+
74
+ # Constructor.
75
+ # @param book [Wx::BookCtrlBase] The associated book control.
76
+ # @return [Wx::PersistentBookCtrl]
77
+ def initialize(book) end
78
+
79
+ # Save the currently selected page index.
80
+ # @return [void]
81
+ def save; end
82
+
83
+ # Restore the selected page index.
84
+ #
85
+ # The book control must be initialized before calling this function, i.e. all of its pages should be already added to it otherwise restoring the selection has no effect.
86
+ # @return [Boolean]
87
+ def restore; end
88
+
89
+ end # PersistentBookCtrl
90
+
91
+ # Persistence adapter for {Wx::Treebook}.
92
+ #
93
+ # This adapter saves and restores the expanded branches of the {Wx::TreeCtrl} used by {Wx::Treebook}, in addition to saving and restoring the selection as implemented by the base {Wx::PersistentBookCtrl} class.
94
+ #
95
+ # @wxrb_require USE_CONFIG
96
+ class PersistentTreeBookCtrl < PersistentBookCtrl
97
+
98
+ # Constructor.
99
+ # @param book [Wx::Treebook] The associated tree book control.
100
+ # @return [Wx::PersistentTreeBookCtrl]
101
+ def initialize(book) end
102
+
103
+ # Save the currently opened branches.
104
+ # @return [void]
105
+ def save; end
106
+
107
+ # Restore the opened branches.
108
+ #
109
+ # The book control must be initialized before calling this function, i.e. all of its pages should be already added to it.
110
+ # @return [Boolean]
111
+ def restore; end
112
+
113
+ end # PersistentTreeBookCtrl
114
+
115
+
116
+ end