wxruby3 0.9.0-x64-mingw-ucrt → 0.9.2-x64-mingw-ucrt

data/lib/wx/doc/gen/frame.rb

@@ -19,9 +19,14 @@ module Wx
   # It usually has thick borders and a title bar, and can optionally contain a menu bar, toolbar and status bar. A frame can contain any window that is not a frame or dialog.
   # A frame that has a status bar and toolbar, created via the {Wx::Frame#create_status_bar} and {Wx::Frame#create_tool_bar} functions, manages these windows and adjusts the value returned by {Wx::Frame#get_client_size} to reflect the remaining size available to application windows.
   # If a frame is to be used as an input form, the controls should not be created as its children. Instead, a {Wx::Panel} should be created as the sole child of the frame, serving as the parent of the actual controls (the frame will size the panel so it always fills its client area). Doing this will ensure that tabbing between the controls works and the frame background has the expected colour. Moreover, as a frame is by default resizable, it could be better to use {Wx::ScrolledWindow} instead of {Wx::Panel}, to make sure the controls are easily accessible regardless of the frame size. However, please consider whether it would not be better to use {Wx::Dialog} instead of {Wx::Frame}, where using a panel like this is not needed and {Wx::Dialog} also offers other benefits such as creating specialized sizers (e.g., for buttons, with their platform-correct order).
-  # An application should normally define a {Wx::CloseEvent} handler for the frame to respond to system close events, for example so that related data and subwindows can be cleaned up.
   # 
-  # == Default event processing
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>An application should normally define a {Wx::CloseEvent} handler for the frame to respond to system close events, for example so that related data and subwindows can be cleaned up.
+  # </p>
+  # </div>>
+  # 
+  # ## Default event processing
   # 
   # {Wx::Frame} processes the following events:
   # 
@@ -29,7 +34,7 @@ module Wx
   # 
   # - {Wx::EVT_MENU_HIGHLIGHT}: the default implementation displays the help string associated with the selected item in the first pane of the status bar, if there is one.
   # 
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -45,7 +50,7 @@ module Wx
   # 
   # - {Wx::MAXIMIZE}: Displays the frame maximized. Windows and GTK+ only. 
   # 
-  # - {Wx::MAXIMIZE_BOX}: Displays a maximize box on the frame. Notice that under wxGTK {Wx::RESIZE_BORDER} must be used as well or this style is ignored. 
+  # - {Wx::MAXIMIZE_BOX}: Displays a maximize box on the frame. Notice that under WXGTK {Wx::RESIZE_BORDER} must be used as well or this style is ignored. 
   # 
   # - {Wx::CLOSE_BOX}: Displays a close box on the frame. 
   # 
@@ -57,7 +62,7 @@ module Wx
   # 
   # - {Wx::FRAME_TOOL_WINDOW}: Causes a frame with a small title bar to be created; the frame does not appear in the taskbar under Windows or GTK+. 
   # 
-  # - {Wx::FRAME_NO_TASKBAR}: Creates an otherwise normal frame but it does not appear in the taskbar under Windows or GTK+ (note that it will minimize to the desktop window under Windows which may seem strange to the users and thus it might be better to use this style only without {Wx::MINIMIZE_BOX} style). In wxGTK, the flag is respected only if the window manager supports _NET_WM_STATE_SKIP_TASKBAR hint. 
+  # - {Wx::FRAME_NO_TASKBAR}: Creates an otherwise normal frame but it does not appear in the taskbar under Windows or GTK+ (note that it will minimize to the desktop window under Windows which may seem strange to the users and thus it might be better to use this style only without {Wx::MINIMIZE_BOX} style). In WXGTK, the flag is respected only if the window manager supports _NET_WM_STATE_SKIP_TASKBAR hint. 
   # 
   # - {Wx::FRAME_FLOAT_ON_PARENT}: The frame will always be on top of its parent (unlike {Wx::STAY_ON_TOP}). A frame created with this style must have a non-NULL parent. 
   # 
@@ -71,7 +76,7 @@ module Wx
   # 
   # See also the Window Styles.
   # 
-  # === Extra Styles
+  # ### Extra Styles
   # 
   # This class supports the following extra styles:
   # 
@@ -79,7 +84,7 @@ module Wx
   # 
   # - {Wx::FRAME_EX_METAL}: On macOS, frames with this style will be shown with a metallic look. This is an extra style. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # Event handler methods for events emitted by this class:
   # 
@@ -95,8 +100,6 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_menu_highlight_all}(meth = nil, &block): A menu item has been highlighted, i.e. the currently selected menu item has changed. See {Wx::MenuEvent}. 
   # 
-  # === 
-  # 
   # Category:  Managed Windows
   # @see Wx::MDIParentFrame
   # @see  Wx::MDIChildFrame
@@ -109,9 +112,13 @@ module Wx
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::Frame]
-    # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FrameNameStr)
+    # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FRAME_NAME_STR)
     #   Constructor, creating the window.
-    #   For Motif, MWM (the Motif Window Manager) should be running for any window styles to work (otherwise all styles take effect).
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>For Motif, MWM (the Motif Window Manager) should be running for any window styles to work (otherwise all styles take effect).
+    #   </p>
+    #   </div>>
     #   @see Wx::Frame#create 
     #   @param parent [Wx::Window]  The window parent. This may be, and often is, NULL. If it is non-NULL, the frame will be minimized when its parent is minimized and restored when it is restored (although it will still be possible to minimize and restore just this frame itself).
     #   @param id [Integer]  The window identifier. It may take a value of -1 to indicate a default value.
@@ -138,12 +145,16 @@ module Wx
     # @param style [Integer] 
     # @param name [String] 
     # @return [Boolean]
-    def create(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FrameNameStr) end
+    def create(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FRAME_NAME_STR) end
     
     # Creates a status bar at the bottom of the frame.
     # A pointer to the status bar if it was created successfully, NULL otherwise.
     # 
-    # The width of the status bar is the whole width of the frame (adjusted automatically when resizing), and the height and text size are chosen by the host windowing system.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The width of the status bar is the whole width of the frame (adjusted automatically when resizing), and the height and text size are chosen by the host windowing system.
+    # </p>
+    # </div>>
     # @see Wx::Frame#set_status_text
     # @see  Wx::Frame#on_create_status_bar
     # @see  Wx::Frame#get_status_bar 
@@ -152,12 +163,16 @@ module Wx
     # @param id [Integer]  The status bar window identifier. If -1, an identifier will be chosen by wxWidgets.
     # @param name [String]  The status bar window name.
     # @return [Wx::StatusBar]
-    def create_status_bar(number=1, style=Wx::STB_DEFAULT_STYLE, id=0, name=Wx::StatusBarNameStr) end
+    def create_status_bar(number=1, style=Wx::STB_DEFAULT_STYLE, id=0, name=Wx::STATUS_BAR_NAME_STR) end
     
     # Creates a toolbar at the top or left of the frame.
     # A pointer to the toolbar if it was created successfully, NULL otherwise.
     # 
-    # By default, the toolbar is an instance of {Wx::ToolBar}. To use a different class, override {Wx::Frame#on_create_tool_bar}. When a toolbar has been created with this function, or made known to the frame with {Wx::Frame#set_tool_bar}, the frame will manage the toolbar position and adjust the return value from {Wx::Window#get_client_size} to reflect the available space for application windows. Under Pocket PC, you should always use this function for creating the toolbar to be managed by the frame, so that wxWidgets can use a combined menubar and toolbar. Where you manage your own toolbars, create a {Wx::ToolBar} as usual.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>By default, the toolbar is an instance of {Wx::ToolBar}. To use a different class, override {Wx::Frame#on_create_tool_bar}. When a toolbar has been created with this function, or made known to the frame with {Wx::Frame#set_tool_bar}, the frame will manage the toolbar position and adjust the return value from {Wx::Window#get_client_size} to reflect the available space for application windows. Under Pocket PC, you should always use this function for creating the toolbar to be managed by the frame, so that wxWidgets can use a combined menubar and toolbar. Where you manage your own toolbars, create a {Wx::ToolBar} as usual.
+    # </p>
+    # </div>>
     # @see Wx::Frame#create_status_bar
     # @see  Wx::Frame#on_create_tool_bar
     # @see  Wx::Frame#set_tool_bar
@@ -166,7 +181,7 @@ module Wx
     # @param id [Integer]  The toolbar window identifier. If -1, an identifier will be chosen by wxWidgets.
     # @param name [String]  The toolbar window name.
     # @return [Wx::ToolBar]
-    def create_tool_bar(style=Wx::TB_DEFAULT_STYLE, id=Wx::StandardID::ID_ANY, name=Wx::ToolBarNameStr) end
+    def create_tool_bar(style=Wx::TB_DEFAULT_STYLE, id=Wx::StandardID::ID_ANY, name=Wx::TOOL_BAR_NAME_STR) end
     
     # Method used to show help string of the selected menu toolbar item.
     # This method is called by the default {Wx::EVT_MENU_HIGHLIGHT} event handler and also by {Wx::ToolBar} to show the optional help string associated with the selected menu or toolbar item. It can be overridden if the default behaviour of showing this string in the frame status bar is not appropriate.
@@ -221,7 +236,11 @@ module Wx
     def process_command(id) end
     
     # Tells the frame to show the given menu bar.
-    # If the frame is destroyed, the menu bar and its menus will be destroyed also, so do not delete the menu bar explicitly (except by resetting the frame's menu bar to another frame or NULL). Under Windows, a size event is generated, so be sure to initialize data members properly before calling {Wx::Frame#set_menu_bar}. Note that on some platforms, it is not possible to call this function twice for the same frame object.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>If the frame is destroyed, the menu bar and its menus will be destroyed also, so do not delete the menu bar explicitly (except by resetting the frame's menu bar to another frame or NULL). Under Windows, a size event is generated, so be sure to initialize data members properly before calling {Wx::Frame#set_menu_bar}. Note that on some platforms, it is not possible to call this function twice for the same frame object.
+    # </p>
+    # </div>>
     # @see Wx::Frame#get_menu_bar
     # @see  Wx::MenuBar
     # @see  Wx::Menu. 
@@ -250,7 +269,11 @@ module Wx
     # Sets the status bar text and updates the status bar display.
     # This is a simple wrapper for {Wx::StatusBar#set_status_text} which doesn't do anything if the frame has no status bar, i.e. {Wx::Frame#get_status_bar} returns NULL.
     # 
-    # Use an empty string to clear the status bar.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use an empty string to clear the status bar.
+    # </p>
+    # </div>>
     # @see Wx::Frame#create_status_bar
     # @see  Wx::StatusBar 
     # @param text [String]  The text for the status field.
@@ -260,7 +283,11 @@ module Wx
     alias_method :status_text=, :set_status_text
     
     # Sets the widths of the fields in the status bar.
-    # The widths of the variable fields are calculated from the total width of all fields, minus the sum of widths of the non-variable fields, divided by the number of variable fields.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The widths of the variable fields are calculated from the total width of all fields, minus the sum of widths of the non-variable fields, divided by the number of variable fields.
+    # </p>
+    # </div>>
     # @param widths_field [Array<Integer>]  Must contain an array of n integers, each of which is a status field width in pixels. A value of -1 indicates that the field is variable width; at least one field must be -1. You should delete this array after calling {Wx::Frame#set_status_widths}.
     # @return [void]
     def set_status_widths(widths_field) end
@@ -271,6 +298,20 @@ module Wx
     def set_tool_bar(toolBar) end
     alias_method :tool_bar=, :set_tool_bar
     
+    # MSW-specific function for accessing the taskbar button under Windows 7 or later.
+    # Returns a {Wx::TaskBarButton} pointer representing the taskbar button of the window under Windows 7 or later. The returned {Wx::TaskBarButton} may be used, if non-NULL, to access the functionality including thumbnail representations, thumbnail toolbars, notification and status overlays, and progress indicators.
+    # The returned pointer must not be deleted, it is owned by the frame and will be only deleted when the frame itself is destroyed.
+    # This function is not available in the other ports by design, any occurrences of it in the portable code must be guarded by 
+    # ```ruby
+    #   if Wx::PLATFORM == 'WXMSW'
+    #     #...
+    #   end
+    # ```
+    #  preprocessor guards.
+    # @return [Wx::TaskBarButton]
+    # @wxrb_require WXMSW,USE_TASKBARBUTTON
+    def msw_get_task_bar_button; end
+    
     # @param text [String] 
     # @param number [Integer] 
     # @return [void]

data/lib/wx/doc/gen/fs_file.rb

@@ -10,6 +10,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class FileSystemOpenFlags < Wx::Enum
   
     # Open for reading.
@@ -24,6 +25,7 @@ module Wx
   
   # Parameter indicating how file offset should be interpreted.
   # 
+  # @wxrb_require USE_FILESYSTEM
   class SeekMode < Wx::Enum
   
     # Seek from the file beginning.
@@ -42,6 +44,7 @@ module Wx
   
   # IO stream error codes.
   # 
+  # @wxrb_require USE_FILESYSTEM
   class StreamError < Wx::Enum
   
     # No error occurred.
@@ -64,9 +67,12 @@ module Wx
   
   # This class represents a single file opened by {Wx::FileSystem}.
   # It provides more information than wxWidgets' input streams (stream, filename, mime type, anchor).
-  # Any pointer returned by a method of {Wx::FSFile} is valid only as long as the {Wx::FSFile} object exists. For example a call to {Wx::FSFile#get_stream} doesn't create the stream but only returns the pointer to it. In other words after 10 calls to {Wx::FSFile#get_stream} you will have obtained ten identical pointers.
   # 
-  # === 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Any pointer returned by a method of {Wx::FSFile} is valid only as long as the {Wx::FSFile} object exists. For example a call to {Wx::FSFile#get_stream} doesn't create the stream but only returns the pointer to it. In other words after 10 calls to {Wx::FSFile#get_stream} you will have obtained ten identical pointers.
+  # </p>
+  # </div>
   # 
   # Category:  Virtual File System, File Handling
   # @see Wx::FileSystemHandler
@@ -74,6 +80,7 @@ module Wx
   # @see  wxFileSystem Overview 
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class FSFile < Object
   
     # Constructor.
@@ -96,19 +103,19 @@ module Wx
     
     # Returns anchor (if present).
     # The term of <b>anchor</b> can be easily explained using few examples:
-    # index.htm#anchor                      // 'anchor' is anchor
+    # index.htm\#anchor                      // 'anchor' is anchor
     # index/{Wx::001}.htm                       // NO anchor here!
-    # archive/main.zip#zip:index.htm#global // 'global'
-    # archive/main.zip#zip:index.htm        // NO anchor here!
+    # archive/main.zip\#zip:index.htm\#global // 'global'
+    # archive/main.zip\#zip:index.htm        // NO anchor here!
     # 
-    # Usually an anchor is presented only if the MIME type is 'text/html'. But it may have some meaning with other files; for example myanim.avi#200 may refer to position in animation or reality.wrl::MyView may refer to a predefined view in VRML.
+    # Usually an anchor is presented only if the MIME type is 'text/html'. But it may have some meaning with other files; for example myanim.avi\#200 may refer to position in animation or reality.wrl::MyView may refer to a predefined view in VRML.
     # @return [Wx::String]
     def get_anchor; end
     alias_method :anchor, :get_anchor
     
     # Returns full location of the file, including path and protocol.
     # Examples: http://www.{Wx::widgets}.org
-    # http://www.ms.mff.cuni.cz/~vsla8348/{Wx::html}/archive.zip#zip:info.txt
+    # http://www.ms.mff.cuni.cz/~vsla8348/{Wx::html}/archive.zip\#zip:info.txt
     # file:/home/vasek/index.htm
     # relative-file.htm
     # @return [Wx::String]
@@ -136,7 +143,6 @@ module Wx
   
   # This class is the base class of most stream related classes in wxWidgets.
   # It must not be used directly.
-  # === 
   # 
   # Category:  {Wx::Streams}
   # @see Wx::StreamBuffer 
@@ -144,6 +150,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class StreamBase < ::Object
   
     # Creates a dummy stream object.
@@ -193,12 +200,12 @@ module Wx
   # {Wx::InputStream} is an abstract base class which may not be used directly.
   # It is the base class of all streams which provide a {Wx::InputStream#read} function, i.e. which can be used to read data from a source (e.g. a file, a socket, etc).
   # If you want to create your own input stream, you'll need to derive from this class and implement the protected {Wx::InputStream#on_sys_read} function only.
-  # === 
   # 
   # Category:  {Wx::Streams}
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class InputStream < StreamBase
   
     # Creates a dummy input stream.
@@ -259,12 +266,12 @@ module Wx
   # {Wx::OutputStream} is an abstract base class which may not be used directly.
   # It is the base class of all streams which provide a {Wx::OutputStream#write} function, i.e. which can be used to output data (e.g. to a file, to a socket, etc).
   # If you want to create your own output stream, you'll need to derive from this class and implement the protected {Wx::OutputStream#on_sys_write} function only.
-  # === 
   # 
   # Category:  {Wx::Streams}
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class OutputStream < StreamBase
   
     # Creates a dummy {Wx::OutputStream} object.

data/lib/wx/doc/gen/gauge.rb

@@ -26,7 +26,7 @@ module Wx
   # The first is the usual working mode (see {Wx::Gauge#set_value} and {Wx::Gauge#set_range}) while the second can be used when the program is doing some processing but you don't know how much progress is being done. In this case, you can periodically call the {Wx::Gauge#pulse} function to make the progress bar switch to indeterminate mode (graphically it's usually a set of blocks which move or bounce in the bar control).
   # {Wx::Gauge} supports dynamic switch between these two work modes.
   # There are no user commands for the gauge.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -40,22 +40,21 @@ module Wx
   # 
   # - {Wx::GA_PROGRESS}: Reflect the value of gauge in the application taskbar button under Windows 7 and later and the dock icon under macOS, ignored under the other platforms. This flag is only available in wxWidgets 3.1.0 and later. 
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Wx::Slider
   # @see  Wx::ScrollBar 
   # 
   # 
+  # @wxrb_require USE_GAUGE
   class Gauge < Control
   
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::Gauge]
-    # @overload initialize(parent, id, range, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::GA_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::GaugeNameStr)
+    # @overload initialize(parent, id, range, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::GA_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::GAUGE_NAME_STR)
     #   Constructor, creating and showing a gauge.
     #   
     #   @see Wx::Gauge#create 
@@ -81,7 +80,7 @@ module Wx
     # @param validator [Wx::Validator] 
     # @param name [String] 
     # @return [Boolean]
-    def create(parent, id, range, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::GA_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::GaugeNameStr) end
+    def create(parent, id, range, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::GA_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::GAUGE_NAME_STR) end
     
     # Returns the maximum position of the gauge.
     # 
@@ -103,13 +102,17 @@ module Wx
     alias_method :vertical?, :is_vertical
     
     # Switch the gauge to indeterminate mode (if required) and makes the gauge move a bit to indicate the user that some progress has been made.
-    # After calling this function the value returned by {Wx::Gauge#get_value} is undefined and thus you need to explicitly call {Wx::Gauge#set_value} if you want to restore the determinate mode.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>After calling this function the value returned by {Wx::Gauge#get_value} is undefined and thus you need to explicitly call {Wx::Gauge#set_value} if you want to restore the determinate mode. 
+    # </p>
+    # </div>
     # @return [void]
     def pulse; end
     
     # Sets the range (maximum value) of the gauge.
     # This function makes the gauge switch to determinate mode, if it's not already.
-    # When the gauge is in indeterminate mode, under wxMSW the gauge repeatedly goes from zero to range and back; under other ports when in indeterminate mode, the range setting is ignored.
+    # When the gauge is in indeterminate mode, under WXMSW the gauge repeatedly goes from zero to range and back; under other ports when in indeterminate mode, the range setting is ignored.
     # @see Wx::Gauge#get_range 
     # @param range [Integer] 
     # @return [void]

data/lib/wx/doc/gen/gb_sizer_item.rb

@@ -8,7 +8,6 @@ module Wx
 
   # The {Wx::GBSizerItem} class is used by the {Wx::GridBagSizer} for tracking the items in the sizer.
   # It adds grid position and spanning information to the normal {Wx::SizerItem} by adding {Wx::GBPosition} and {Wx::GBSpan} attributes. Most of the time you will not need to use a {Wx::GBSizerItem} directly in your code, but there are a couple of cases where it is handy.
-  # === 
   # 
   # Category:  Window Layout
   # 

data/lib/wx/doc/gen/gcdc.rb

@@ -15,8 +15,6 @@ module Wx
   # - Similarly, {Wx::RasterOperationMode} parameter of {Wx::GCDC#blit} and {Wx::GCDC#stretch_blit} can only be one of the supported logical functions listed above, using any other function will result in an assertion failure and not drawing anything.
   # - For Direct2D-based {Wx::GraphicsContext}, only true-type fonts can be used in the font-related functions.
   # 
-  # === 
-  # 
   # Category:  Device Contexts
   # @see Wx::DC
   # @see  Wx::GraphicsContext 
@@ -24,6 +22,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_GRAPHICS_CONTEXT
   class GCDC < DC
   
     # Retrieves associated {Wx::GraphicsContext}.

data/lib/wx/doc/gen/gdi_common.rb

@@ -120,7 +120,7 @@ module Wx
   
   # Standard cursors.
   # 
-  # Notice that under wxMSW some of these cursors are defined in wx.rc file and not by the system itself so you should include this file from your own resource file (possibly creating a trivial resource file just containing a single include line if you don't need it otherwise) to be able to use them.
+  # Notice that under WXMSW some of these cursors are defined in wx.rc file and not by the system itself so you should include this file from your own resource file (possibly creating a trivial resource file just containing a single include line if you don't need it otherwise) to be able to use them.
   # See {Wx::Cursor}.
   # 
   class StockCursor < Wx::Enum
@@ -300,12 +300,24 @@ module Wx
   DEFAULT_SIZE = nil
   
   # Returns true if the display is colour, false otherwise.
-  # Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_depth to retrieve the depth of the appropriate display and compare it with 1 instead.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_depth to retrieve the depth of the appropriate display and compare it with 1 instead.
+  # </p>
+  # </div>
+  # 
+  # Include file: \#include <wx/gdicmn.h>
   # @return [Boolean]
   def self.colour_display; end
   
   # Returns the depth of the display (a value of 1 denotes a monochrome display).
-  # Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_depth to retrieve the depth of the appropriate display instead.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_depth to retrieve the depth of the appropriate display instead.
+  # </p>
+  # </div>
+  # 
+  # Include file: \#include <wx/gdicmn.h>
   # @return [Integer]
   def self.display_depth; end
   
@@ -325,13 +337,26 @@ module Wx
   
   # Returns the display resolution in pixels per inch.
   # The x component of the returned {Wx::Size} object contains the horizontal resolution and the y one  the vertical resolution.
-  # Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_ppi to retrieve the resolution of the appropriate display instead.
+  # 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_ppi to retrieve the resolution of the appropriate display instead.
+  # </p>
+  # </div>
+  # 
+  # Include file: \#include <wx/gdicmn.h>
   # @see Wx::Display
   # @return [Wx::Size]
   def self.get_display_ppi; end
   
   # Returns the display size in pixels.
-  # Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_geometry to retrieve the size of the appropriate display instead.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Use of this function is not recommended in the new code as it only works for the primary display. Use Wx::Display#get_geometry to retrieve the size of the appropriate display instead.
+  # </p>
+  # </div>
+  # 
+  # Include file: \#include <wx/gdicmn.h>
   # @see Wx::Display
   # @return [Wx::Size]
   def self.get_display_size; end
@@ -345,7 +370,6 @@ module Wx
   # A {Wx::Point} is a useful data structure for graphics operations.
   # It contains integer x and y members. See {Wx::RealPoint} for a floating point version.
   # Note that the width and height stored inside a {Wx::Point} object may be negative and that {Wx::Point} functions do not perform any check against negative values (this is used to e.g. store the special -1 value in {Wx::DEFAULT_POSITION} instance).
-  # === 
   # 
   # Category:  Data Structures
   # Predefined objects/pointers: {Wx::DEFAULT_POSITION}
@@ -426,7 +450,6 @@ module Wx
   # It simply contains integer x and y members.
   # Note that the width and height stored inside a {Wx::Size} object may be negative and that {Wx::Size} functions do not perform any check against negative values (this is used to e.g. store the special -1 value in {Wx::DEFAULT_SIZE} instance). See also {Wx::Size#is_fully_specified} and {Wx::Size#set_defaults} for utility functions regarding the special -1 value.
   # {Wx::Size} is used throughout wxWidgets as well as {Wx::Point} which, although almost equivalent to {Wx::Size}, has a different meaning: {Wx::Point} represents a position while {Wx::Size} represents the size.
-  # === 
   # 
   # Category:  Data Structures
   # Predefined objects/pointers: {Wx::DEFAULT_SIZE}
@@ -589,7 +612,6 @@ module Wx
   # 
   # In other words, the rectangle left and right boundaries are at x and <code>x+width-1</code> and its top and bottom boundaries are at y and <code>y+height-1</code> respectively.
   # Note that the x and y coordinates may be negative, but width and height are always strictly positive for non-empty rectangles.
-  # === 
   # 
   # Category:  Data Structures
   # @see Wx::Point
@@ -895,7 +917,6 @@ module Wx
   # A {Wx::RealPoint} is a useful data structure for graphics operations.
   # It contains floating point x and y members. See {Wx::Point} for an integer version.
   # Note that the coordinates stored inside a {Wx::RealPoint} object may be negative and that {Wx::RealPoint} functions do not perform any check against negative values.
-  # === 
   # 
   # Category:  Data Structures
   # @see Wx::Point 
@@ -1083,8 +1104,6 @@ module Wx
   # 
   #  YELLOW GREEN  
   # 
-  # === 
-  # 
   # Category:  Graphics Device Interface (GDI)
   # @see Wx::Colour 
   # 

data/lib/wx/doc/gen/gdi_object.rb

@@ -9,7 +9,6 @@ module Wx
   # This class allows platforms to implement functionality to optimise GDI objects, such as {Wx::Pen}, {Wx::Brush} and {Wx::Font}.
   # On Windows, the underling GDI objects are a scarce resource and are cleaned up when a usage count goes to zero. On some platforms this class may not have any special functionality.
   # Since the functionality of this class is platform-specific, it is not documented here in detail.
-  # === 
   # 
   # Category:  Graphics Device Interface (GDI)
   # @see Wx::Pen

data/lib/wx/doc/gen/generic_dir_ctrl.rb

@@ -8,7 +8,7 @@ module Wx
 
   # This control can be used to place a directory listing (with optional files) on an arbitrary window.
   # The control contains a {Wx::TreeCtrl} window representing the directory hierarchy, and optionally, a {Wx::Choice} window containing a list of filters.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -24,13 +24,11 @@ module Wx
   # 
   # - {Wx::DIRCTRL_MULTIPLE}: Allows multiple files and folders to be selected. 
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # Event handler methods for events emitted by this class:
   # 
@@ -38,12 +36,13 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_dirctrl_fileactivated}(id, meth = nil, &block): The user activated a file by double-clicking or pressing Enter. Available since wxWidgets 2.9.5.
   # 
+  # @wxrb_require USE_DIRDLG|USE_FILEDLG
   class GenericDirCtrl < Control
   
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::GenericDirCtrl]
-    # @overload initialize(parent, id=Wx::StandardID::ID_ANY, dir=Wx::DIR_DIALOG_DEFAULT_FOLDER_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DIRCTRL_DEFAULT_STYLE, filter=(''), defaultFilter=0, name=Wx::TreeCtrlNameStr)
+    # @overload initialize(parent, id=Wx::StandardID::ID_ANY, dir=Wx::DIR_DIALOG_DEFAULT_FOLDER_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DIRCTRL_DEFAULT_STYLE, filter=(''), defaultFilter=0, name=Wx::TREE_CTRL_NAME_STR)
     #   Main constructor.
     #   @param parent [Wx::Window]  Parent window.
     #   @param id [Integer]  Window identifier.
@@ -78,7 +77,7 @@ module Wx
     # @param defaultFilter [Integer] 
     # @param name [String] 
     # @return [Boolean]
-    def create(parent, id=Wx::StandardID::ID_ANY, dir=Wx::DIR_DIALOG_DEFAULT_FOLDER_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DIRCTRL_DEFAULT_STYLE, filter=(''), defaultFilter=0, name=Wx::TreeCtrlNameStr) end
+    def create(parent, id=Wx::StandardID::ID_ANY, dir=Wx::DIR_DIALOG_DEFAULT_FOLDER_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DIRCTRL_DEFAULT_STYLE, filter=(''), defaultFilter=0, name=Wx::TREE_CTRL_NAME_STR) end
     
     # Tries to expand as much of the given path as possible, so that the filename or directory is visible in the tree control.
     # @param path [String]