wxruby3 0.9.1-x64-mingw-ucrt → 0.9.3-x64-mingw-ucrt

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

@@ -33,9 +33,10 @@ module Wx
   EVT_CHOICEBOOK_PAGE_CHANGING = 10102
   
   # {Wx::Choicebook} is a class similar to {Wx::Notebook}, but uses a {Wx::Choice} control to show the labels instead of the tabs.
+  # 
   # For usage documentation of this class, please refer to the base abstract class {Wx::BookCtrl}. You can also use the Notebook Sample to see {Wx::Choicebook} in action.
   # {Wx::Choicebook} allows the use of {Wx::BookCtrlBase#get_control_sizer}, allowing a program to add other controls next to the choice control. This is particularly useful when screen space is restricted, as it often is when {Wx::Choicebook} is being employed.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -49,7 +50,7 @@ module Wx
   # 
   # - {Wx::CHB_BOTTOM}: Place labels below the page area. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::BookCtrlEvent} events.
   # Event handler methods for events emitted by this class:
@@ -58,17 +59,16 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_choicebook_page_changing}(id, meth = nil, &block): The page selection is about to be changed. Processes a {Wx::EVT_CHOICEBOOK_PAGE_CHANGING} event. This event can be vetoed (using {Wx::NotifyEvent#veto}). 
   # 
-  # === 
-  # 
-  # Category:  Book Controls  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  Book 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 wxBookCtrl Overview
   # @see  Wx::Notebook
   # @see  Notebook Sample 
   # 
   # 
+  # @wxrb_require USE_CHOICEBOOK
   class Choicebook < BookCtrlBase
   
     # @overload initialize()

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

@@ -7,6 +7,7 @@
 module Wx
 
   # {Wx::ClientDC} is primarily useful for obtaining information about the window from outside EVT_PAINT() handler.
+  # 
   # Typical use of this class is to obtain the extent of some text string in order to allocate enough size for a window, e.g. 
   # ```ruby
   #    # Create the initially empty label with the size big enough to show
@@ -20,11 +21,14 @@ module Wx
   #           end
   # ```
   # 
-  # While {Wx::ClientDC} may also be used for drawing on the client area of a window from outside an EVT_PAINT() handler in some ports, this does not work on all platforms (neither wxOSX nor wxGTK with GTK 3 Wayland backend support this, so drawing using {Wx::ClientDC} simply doesn't have any effect there) and the only portable way of drawing is via {Wx::PaintDC}. To redraw a small part of the window, use {Wx::Window#refresh_rect} to invalidate just this part and check {Wx::Window#get_update_region} in the paint event handler to redraw this part only.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>While {Wx::ClientDC} may also be used for drawing on the client area of a window from outside an EVT_PAINT() handler in some ports, this does not work on all platforms (neither WXOSX nor WXGTK with GTK 3 Wayland backend support this, so drawing using {Wx::ClientDC} simply doesn't have any effect there) and the only portable way of drawing is via {Wx::PaintDC}. To redraw a small part of the window, use {Wx::Window#refresh_rect} to invalidate just this part and check {Wx::Window#get_update_region} in the paint event handler to redraw this part only.
+  # </p>
+  # </div>
   # 
   # {Wx::ClientDC} objects should normally be constructed as temporary stack objects, i.e. don't store a {Wx::ClientDC} object.
   # A {Wx::ClientDC} object is initialized to use the same font and colours as the window it is associated with.
-  # === 
   # 
   # Category:  Device Contexts
   # @see Wx::DC

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

@@ -7,6 +7,7 @@
 module Wx
 
   # A class for manipulating the clipboard.
+  # 
   # To use the clipboard, you call member functions of the global {Wx::Clipboard} object passed to the block for {Wx::Clipboard.open}.
   # See the {Wx::DataObject} Overview for further information.
   # Call {Wx::Clipboard.open} to get ownership of the (global) clipboard and execute the given block. You now 
@@ -39,13 +40,12 @@ module Wx
   # clipboard managers will automatically flush the clipboard after each new piece of data is added, while others 
   # will not. The {Wx::Clipboard#flush} function will force the clipboard manager to flush the data.
   # 
-  # === 
-  # 
   # Category:  Clipboard and Drag & Drop
   # @see  Wx::DataObject
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_CLIPBOARD
   class Clipboard < Object
   
     # Default constructor.
@@ -53,6 +53,7 @@ module Wx
     def initialize; end
     
     # Call this function to add the data object to the clipboard.
+    # 
     # This is an obsolete synonym for {Wx::Clipboard#set_data}.
     # @param data [Wx::DataObject] 
     # @return [Boolean]
@@ -67,14 +68,21 @@ module Wx
     def close; end
     
     # Flushes the clipboard: this means that the data which is currently on clipboard will stay available even after the application exits (possibly eating memory), otherwise the clipboard will be emptied on exit.
+    # 
     # Currently this method is implemented in MSW and GTK and always returns false otherwise.
-    # On GTK, only the non-primary selection can be flushed. Calling this function when the clipboard is using the primary selection will return false and not make any data available after the program exits.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>On GTK, only the non-primary selection can be flushed. Calling this function when the clipboard is using the primary selection will return false and not make any data available after the program exits.
+    # </p>
+    # </div>
     # 
     # false if the operation is unsuccessful for any reason.
     # @return [Boolean]
     def flush; end
     
     # Call this function to fill data with data on the clipboard, if available in the required format.
+    # 
     # Returns true on success.
     # @param data [Wx::DataObject] 
     # @return [Boolean]
@@ -87,6 +95,7 @@ module Wx
     alias_method :opened?, :is_opened
     
     # Returns true if there is data which matches the data format of the given data object currently <b>available</b> on the clipboard.
+    # 
     # TodoThe name of this function is misleading. This should be renamed to something that more accurately indicates what it does.
     # @param format [Wx::DataFormat] 
     # @return [Boolean]
@@ -95,18 +104,21 @@ module Wx
     
     # Returns true if we are using the primary selection, false if clipboard one.
     # 
+    # 
     # @see Wx::Clipboard#use_primary_selection 
     # @return [Boolean]
     def is_using_primary_selection; end
     alias_method :using_primary_selection?, :is_using_primary_selection
     
     # Call this function to open the clipboard before calling {Wx::Clipboard#set_data} and {Wx::Clipboard#get_data}.
+    # 
     # Call {Wx::Clipboard#close} when you have finished with the clipboard. You should keep the clipboard open for only a very short time.
     # true on success. This should be tested (as in the sample shown above).
     # @return [Boolean]
     def open; end
     
     # Call this function to set the data object to the clipboard.
+    # 
     # The new data object replaces any previously set one, so if the application wants to provide clipboard data in several different formats, it must use a composite data object supporting all of the formats instead of calling this function several times with different data objects as this would only leave data from the last one in the clipboard.
     # After this function has been called, the clipboard owns the data, so do not delete the data explicitly.
     # @param data [Wx::DataObject] 
@@ -115,6 +127,7 @@ module Wx
     alias_method :data=, :set_data
     
     # On platforms supporting it (all X11-based ports), {Wx::Clipboard} uses the CLIPBOARD X11 selection by default.
+    # 
     # When this function is called with true, all subsequent clipboard operations will use PRIMARY selection until this function is called again with false.
     # On the other platforms, there is no PRIMARY selection and so all clipboard operations will fail. This allows implementing the standard X11 handling of the clipboard which consists in copying data to the CLIPBOARD selection only when the user explicitly requests it (i.e. by selecting the "Copy" menu command) but putting the currently selected text into the PRIMARY selection automatically, without overwriting the normal clipboard contents with the currently selected text on the other platforms.
     # @param primary [Boolean] 

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

@@ -17,6 +17,7 @@ module Wx
   EVT_COLLAPSIBLEPANE_CHANGED = 10189
   
   # A collapsible pane is a container with an embedded button-like control which can be used by the user to collapse or expand the pane's contents.
+  # 
   # Once constructed you should use the {Wx::CollapsiblePane#get_pane} function to access the pane and add your controls inside it (i.e. use the returned pointer from {Wx::CollapsiblePane#get_pane} as parent for the controls which must go in the pane, <b>not</b> the {Wx::CollapsiblePane} itself!).
   # Note that because of its nature of control which can dynamically (and drastically) change its size at run-time under user-input, when putting {Wx::CollapsiblePane} inside a {Wx::Sizer} you should be careful to add it with a proportion value of zero; this is because otherwise all other windows with non-null proportion values will automatically resize each time the user expands or collapse the pane window usually resulting in a weird, flickering effect.
   # Usage sample:
@@ -36,7 +37,7 @@ module Wx
   # ```
   # 
   # It is only available if {Wx::Setup::USE_COLLPANE} is set to 1 (the default).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -44,7 +45,7 @@ module Wx
   # 
   # - {Wx::CP_NO_TLW_RESIZE}: By default {Wx::CollapsiblePane} resizes the top level window containing it when its own size changes. This allows easily implementing dialogs containing an optionally shown part, for example, and so is the default behaviour but can be inconvenient in some specific cases  use this flag to disable this automatic parent resizing then. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::NavigationKeyEvent} events.
   # Event handler methods for events emitted by this class:
@@ -53,16 +54,15 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_navigation_key}(meth = nil, &block): Process a navigation key event. 
   # 
-  # === 
-  # 
-  # 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::Panel
   # @see  Wx::CollapsiblePaneEvent 
   # 
   # 
+  # @wxrb_require USE_COLLPANE
   class CollapsiblePane < Control
   
     # @overload initialize()
@@ -81,6 +81,7 @@ module Wx
     #   @return [Wx::CollapsiblePane]
     def initialize(*args) end
     
+    # 
     # 
     # true if the control was successfully created or false if creation failed.
     # @param parent [Wx::Window]  Parent window, must not be non-NULL.
@@ -104,6 +105,7 @@ module Wx
     def expand; end
     
     # Returns a pointer to the pane window.
+    # 
     # Add controls to the returned {Wx::Window} to make them collapsible.
     # @return [Wx::Window]
     def get_pane; end

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

@@ -7,19 +7,19 @@
 module Wx
 
   # This event class is used for the events generated by {Wx::CollapsiblePane}.
-  # === Events using this class
+  # 
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CollapsiblePaneEvent} events.
   # Event handler methods:
   # 
   # - {Wx::EvtHandler#evt_collapsiblepane_changed}(id, meth = nil, &block): The user expanded or collapsed the collapsible pane. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::CollapsiblePane 
   # 
   # 
+  # @wxrb_require USE_COLLPANE
   class CollapsiblePaneEvent < CommandEvent
   
     # The constructor is not normally used by the user code.

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

@@ -31,6 +31,7 @@ module Wx
   NULL_COLOUR = nil
   
   # Converts string to a {Wx::Colour} best represented by the given string.
+  # 
   # Returns true on success.
   # @see wxToString(const wxColour&)
   # @param string [String] 
@@ -40,6 +41,7 @@ module Wx
   
   # Converts the given {Wx::Colour} into a string.
   # 
+  # 
   # @see wxFromString(const wxString&
   # @see  wxColour*)
   # @param colour [Wx::Colour,String,Symbol] 
@@ -47,14 +49,14 @@ module Wx
   def self.to_string(colour) end
   
   # A colour is an object representing a combination of Red, Green, and Blue (RGB) intensity values and an Alpha value, and is used to determine drawing colours.
+  # 
   # See the entry for {Wx::ColourDatabase} for how a pointer to a predefined, named colour may be returned instead of creating a new colour.
   # Valid RGB values are in the range 0 to 255.
   # You can retrieve the current system colour settings with {Wx::SystemSettings}.
   # 
-  # == Channel Accessor Functions
+  # ## Channel Accessor Functions
   # 
   # Note that this class provides pairs of functions for each of the colour channels, i.e. red, green, blue and alpha values. The one word functions {Wx::Colour#red}, {Wx::Colour#green}, {Wx::Colour#blue} and {Wx::Colour#alpha} return the values of type unsigned char, while {Wx::Colour#get_red}, {Wx::Colour#get_green}, {Wx::Colour#get_blue} and {Wx::Colour#get_alpha} returns the same value as unsigned int. According to the C++ integer promotion rules, the result of any arithmetic expression involving the former will be (signed) int, while that of the latter will be unsigned, which is what would be commonly expected, so the latter family of functions should be typically preferred (but they are only available since wxWidgets 3.1.6).
-  # === 
   # 
   # Category:  Graphics Device Interface (GDI)
   # Predefined objects/pointers:
@@ -81,6 +83,7 @@ module Wx
   class Colour < Object
   
     # Sets the RGB or RGBA colour values from a single 32 bit value.
+    # 
     # The arguments colRGB and colRGBA should be of the form 0x00BBGGRR and 0xAABBGGRR respectively where 0xRR, 0xGG, 0xBB and 0xAA are the values of the red, green, blue and alpha components.
     # Notice the right-to-left order of components!
     # @see Wx::Colour#get_rgb
@@ -91,6 +94,7 @@ module Wx
     alias_method :rgb=, :set_rgb
     
     # Sets the RGB or RGBA colour values from a single 32 bit value.
+    # 
     # The arguments colRGB and colRGBA should be of the form 0x00BBGGRR and 0xAABBGGRR respectively where 0xRR, 0xGG, 0xBB and 0xAA are the values of the red, green, blue and alpha components.
     # Notice the right-to-left order of components!
     # @see Wx::Colour#get_rgb
@@ -101,6 +105,7 @@ module Wx
     alias_method :rgba=, :set_rgba
     
     # Gets the RGB or RGBA colour values as a single 32 bit value.
+    # 
     # The returned value is of the same form as expected by {Wx::Colour#set_rgb} and {Wx::Colour#set_rgba}.
     # Notice that {Wx::Colour#get_rgb} returns the value with 0 as its highest byte independently of the value actually returned by {Wx::Colour#alpha}. So for a fully opaque colour, the return value of {Wx::Colour#get_rgba} is 0xFFBBGGRR while that of {Wx::Colour#get_rgb} is 0x00BBGGRR.
     # @return [Integer]
@@ -108,6 +113,7 @@ module Wx
     alias_method :rgb, :get_rgb
     
     # Gets the RGB or RGBA colour values as a single 32 bit value.
+    # 
     # The returned value is of the same form as expected by {Wx::Colour#set_rgb} and {Wx::Colour#set_rgba}.
     # Notice that {Wx::Colour#get_rgb} returns the value with 0 as its highest byte independently of the value actually returned by {Wx::Colour#alpha}. So for a fully opaque colour, the return value of {Wx::Colour#get_rgba} is 0xFFBBGGRR while that of {Wx::Colour#get_rgb} is 0x00BBGGRR.
     # @return [Integer]
@@ -116,6 +122,7 @@ module Wx
     
     # @overload set(red, green, blue, alpha=Wx::ALPHA_OPAQUE)
     #   Sets the RGB intensity values using the given values (first overload), extracting them from the packed long (second overload), using the given string (third overload).
+    #   
     #   When using third form, {Wx::Colour#set} accepts: colour names (those listed in {Wx::ColourDatabase}), the CSS-like <code>"rgb(r,g,b)"</code> or <code>"rgba(r,g,b,a)"</code> syntax (case insensitive) and the HTML-like syntax: <code>"#"</code> followed by 6 hexadecimal digits for red, green, blue components.
     #   Returns true if the conversion was successful, false otherwise.
     #   @param red [Integer] 
@@ -125,12 +132,14 @@ module Wx
     #   @return [void]
     # @overload set(rGB)
     #   Sets the RGB intensity values using the given values (first overload), extracting them from the packed long (second overload), using the given string (third overload).
+    #   
     #   When using third form, {Wx::Colour#set} accepts: colour names (those listed in {Wx::ColourDatabase}), the CSS-like <code>"rgb(r,g,b)"</code> or <code>"rgba(r,g,b,a)"</code> syntax (case insensitive) and the HTML-like syntax: <code>"#"</code> followed by 6 hexadecimal digits for red, green, blue components.
     #   Returns true if the conversion was successful, false otherwise.
     #   @param rGB [Integer] 
     #   @return [void]
     # @overload set(str)
     #   Sets the RGB intensity values using the given values (first overload), extracting them from the packed long (second overload), using the given string (third overload).
+    #   
     #   When using third form, {Wx::Colour#set} accepts: colour names (those listed in {Wx::ColourDatabase}), the CSS-like <code>"rgb(r,g,b)"</code> or <code>"rgba(r,g,b,a)"</code> syntax (case insensitive) and the HTML-like syntax: <code>"#"</code> followed by 6 hexadecimal digits for red, green, blue components.
     #   Returns true if the conversion was successful, false otherwise.
     #   @param str [String] 
@@ -160,12 +169,14 @@ module Wx
     
     # Returns the alpha value, on platforms where alpha is not yet supported, this always returns {Wx::ALPHA_OPAQUE}.
     # 
+    # 
     # @see Wx::Colour#get_alpha 
     # @return [Integer]
     def alpha; end
     
     # Returns the blue intensity.
     # 
+    # 
     # @see Wx::Colour#get_blue 
     # @return [Integer]
     def blue; end
@@ -187,15 +198,22 @@ module Wx
     def get_red; end
     
     # Converts this colour to a {Wx::String} using the given flags.
-    # The supported flags are {Wx::C2S_NAME}, to obtain the colour name (e.g. {colour(255,0,0)} == "red"), {Wx::C2S_CSS_SYNTAX}, to obtain the colour in the "rgb(r,g,b)" or "rgba(r,g,b,a)" syntax (e.g. {colour(255,0,0,85)} == "rgba(255,0,0,0.333)"), and {Wx::C2S_HTML_SYNTAX}, to obtain the colour as "#" followed by 6 hexadecimal digits (e.g. {colour(255,0,0)} == "#FF0000").
+    # 
+    # The supported flags are {Wx::C2S_NAME}, to obtain the colour name (e.g. {colour(255,0,0)} == "red"), {Wx::C2S_CSS_SYNTAX}, to obtain the colour in the "rgb(r,g,b)" or "rgba(r,g,b,a)" syntax (e.g. {colour(255,0,0,85)} == "rgba(255,0,0,0.333)"), and {Wx::C2S_HTML_SYNTAX}, to obtain the colour as "#" followed by 6 hexadecimal digits (e.g. {colour(255,0,0)} == "\#FF0000").
     # This function returns empty string if the colour is not initialized (see {Wx::Colour#is_ok}). Otherwise, the returned string is always non-empty, but the function asserts if the colour has alpha channel (i.e. is non opaque) but {Wx::C2S_CSS_SYNTAX} (which is the only one supporting alpha) is not specified in flags.
-    # For non-solid (i.e. non-RGB) colour this function returns "rgb(??, ?? ??)" or "#??????".
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>For non-solid (i.e. non-RGB) colour this function returns "rgb(??, ?? ??)" or "#??????".
+    # </p>
+    # </div>
     # @param flags [Integer] 
     # @return [String]
     def get_as_string(flags=(wxC2S_NAME|wxC2S_CSS_SYNTAX)) end
     alias_method :as_string, :get_as_string
     
     # Return the perceived brightness of the colour.
+    # 
     # This value is computed using the simple 
     # ```
     #   0.299*R + 0.587*G + 0.114*B 
@@ -207,6 +225,7 @@ module Wx
     
     # Returns the green intensity.
     # 
+    # 
     # @see Wx::Colour#get_green 
     # @return [Integer]
     def green; end
@@ -218,11 +237,13 @@ module Wx
     
     # Returns the red intensity.
     # 
+    # 
     # @see Wx::Colour#get_red 
     # @return [Integer]
     def red; end
     
     # Returns true if the color can be described using RGB values, i.e.
+    # 
     # is solid, false if it is a pattern (currently only possible on macOS)
     # @return [Boolean]
     def is_solid; end
@@ -234,6 +255,7 @@ module Wx
     def ==(colour) end
     
     # Make a disabled version of this colour.
+    # 
     # This method modifies the object in place and returns the object itself.
     # @param brightness [Integer] 
     # @return [Wx::Colour]
@@ -253,6 +275,7 @@ module Wx
     def change_lightness(ialpha) end
     
     # Utility function that simply darkens or lightens a color, based on the specified percentage ialpha.
+    # 
     # ialpha of 0 would be make the color completely black, 200 completely white and 100 would not change the color.
     # @param r [Integer] 
     # @param g [Integer] 
@@ -277,6 +300,7 @@ module Wx
     #   @return [Array(Integer,Integer,Integer)]
     # @overload self.create_grey(r, g, b, weight_r, weight_g, weight_b)
     #   Create a grey colour from (in/out) rgb parameters using floating point arithmetic.
+    #   
     #   Defaults to using the standard ITU-T BT.601 when converting to YUV, where every pixel equals (R * weight_r) + (G * weight_g) + (B * weight_b).
     #   @param r [Integer] 
     #   @param g [Integer] 

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

@@ -19,6 +19,7 @@ module Wx
   def self.get_colour_from_user(parent, colInit, caption=(''), data=nil) end
   
   # This class represents the colour chooser dialog.
+  # 
   # Starting from wxWidgets 3.1.3 and currently in the MSW port only, this dialog generates {Wx::EVT_COLOUR_CHANGED} events while it is being shown, i.e. from inside its {Wx::ColourDialog#show_modal} method, that notify the program about the change of the currently selected colour and allow it to e.g. preview the effect of selecting this colour. Note that if you react to this event, you should also correctly revert to the previously selected colour if the dialog is cancelled by the user.
   # Example of using this class with dynamic feedback for the selected colour: 
   # ```ruby
@@ -46,8 +47,6 @@ module Wx
   #   redraw(data.get_colour)
   # ```
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxColourDialog Overview
   # @see  Wx::Colour
@@ -56,9 +55,11 @@ module Wx
   # @see  get_colour_from_user 
   # 
   # 
+  # @wxrb_require USE_COLOURDLG
   class ColourDialog < Dialog
   
     # Constructor.
+    # 
     # Pass a parent window, and optionally a pointer to a block of colour data, which will be copied to the colour dialog's colour data.
     # Custom colours from colour data object will be used in the dialog's colour palette. Invalid entries in custom colours list will be ignored on some platforms(GTK) or replaced with white colour on platforms where custom colours palette has fixed size (MSW).
     # @see Wx::ColourData 
@@ -80,7 +81,6 @@ module Wx
   end # ColourDialog
   
   # This class holds a variety of information related to colour dialogs.
-  # === 
   # 
   # Category:  Common Dialogs, Data Structures
   # @see Wx::Colour
@@ -90,6 +90,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_COLOURDLG
   class ColourData < Object
   
     # 
@@ -97,11 +98,13 @@ module Wx
     NUM_CUSTOM = 16
     
     # Constructor.
+    # 
     # Initializes the custom colours to {Wx::NULL_COLOUR}, the data colour setting to black, and the choose full setting to true.
     # @return [Wx::ColourData]
     def initialize; end
     
     # Under Windows, determines whether the Windows colour dialog will display the full dialog with custom colour selection controls.
+    # 
     # Has no meaning under other platforms.
     # The default value is true.
     # @return [Boolean]
@@ -109,13 +112,15 @@ module Wx
     alias_method :choose_full, :get_choose_full
     
     # Indicates whether the colour dialog will display alpha values and an opacity selector.
-    # It is meaningful under wxGTK, wxOSX and with regards to generic colour dialog.
-    # The default value is false, except wxOSX where it is true (for the sake of backward compatibility).
+    # 
+    # It is meaningful under WXGTK, WXOSX and with regards to generic colour dialog.
+    # The default value is false, except WXOSX where it is true (for the sake of backward compatibility).
     # @return [Boolean]
     def get_choose_alpha; end
     alias_method :choose_alpha, :get_choose_alpha
     
     # Gets the current colour associated with the colour dialog.
+    # 
     # The default colour is black.
     # @return [Wx::Colour]
     def get_colour; end
@@ -128,6 +133,7 @@ module Wx
     alias_method :custom_colour, :get_custom_colour
     
     # Under Windows, tells the Windows colour dialog to display the full dialog with custom colour selection controls.
+    # 
     # Under other platforms, has no effect.
     # The default value is true.
     # @param flag [Boolean] 
@@ -136,14 +142,16 @@ module Wx
     alias_method :choose_full=, :set_choose_full
     
     # Tells the colour dialog to show alpha values and an opacity selector (slider).
-    # Currently it has effect under wxGTK, wxOSX and for generic colour dialog.
-    # The default value is false, except wxOSX where it is true for backward compatibility.
+    # 
+    # Currently it has effect under WXGTK, WXOSX and for generic colour dialog.
+    # The default value is false, except WXOSX where it is true for backward compatibility.
     # @param flag [Boolean] 
     # @return [void]
     def set_choose_alpha(flag) end
     alias_method :choose_alpha=, :set_choose_alpha
     
     # Sets the default colour for the colour dialog.
+    # 
     # The default colour is black.
     # @param colour [Wx::Colour,String,Symbol] 
     # @return [void]

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

@@ -7,8 +7,9 @@
 module Wx
 
   # This control allows the user to select a colour.
+  # 
   # The generic implementation is a button which brings up a {Wx::ColourDialog} when clicked. Native implementation may differ but this is usually a (small) widget which give access to the colour-chooser dialog. It is only available if {Wx::Setup::USE_COLOURPICKERCTRL} is set to 1 (the default).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -18,38 +19,39 @@ module Wx
   # 
   # - {Wx::CLRP_SHOW_LABEL}: Shows the colour in HTML form (AABBCC) as colour button label (instead of no label at all). 
   # 
-  # - {Wx::CLRP_SHOW_ALPHA}: Allows selecting opacity in the colour-chooser (effective under wxGTK and wxOSX). 
+  # - {Wx::CLRP_SHOW_ALPHA}: Allows selecting opacity in the colour-chooser (effective under WXGTK and WXOSX). 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::ColourPickerEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_colourpicker_changed}(id, meth = nil, &block): The user changed the colour selected in the control either using the button or using text control (see {Wx::CLRP_USE_TEXTCTRL}; note that in this case the event is fired only if the user's input is valid, i.e. recognizable). When using a popup dialog for changing the colour, this event is sent only when the changes in the dialog are accepted by the user, unlike EVT_COLOURPICKER_CURRENT_CHANGED. 
   # 
-  # - {Wx::EvtHandler#evt_colourpicker_current_changed}(id, meth = nil, &block): The user changed the currently selected colour in the dialog associated with the control. This event is sent immediately when the selection changes and you must also handle EVT_COLOUR_CANCELLED to revert to the previously selected colour if the selection ends up not being accepted. This event is new since wxWidgets 3.1.3 and currently is only implemented in wxMSW. 
-  # 
-  # - {Wx::EvtHandler#evt_colourpicker_dialog_cancelled}(id, meth = nil, &block): The user cancelled the colour dialog associated with the control, i.e. closed it without accepting the selection. This event is new since wxWidgets 3.1.3 and currently is only implemented in wxMSW. 
+  # - {Wx::EvtHandler#evt_colourpicker_current_changed}(id, meth = nil, &block): The user changed the currently selected colour in the dialog associated with the control. This event is sent immediately when the selection changes and you must also handle EVT_COLOUR_CANCELLED to revert to the previously selected colour if the selection ends up not being accepted. This event is new since wxWidgets 3.1.3 and currently is only implemented in WXMSW. 
   # 
-  # === 
+  # - {Wx::EvtHandler#evt_colourpicker_dialog_cancelled}(id, meth = nil, &block): The user cancelled the colour dialog associated with the control, i.e. closed it without accepting the selection. This event is new since wxWidgets 3.1.3 and currently is only implemented in WXMSW. 
   # 
-  # Category:  Picker Controls  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  Picker 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::ColourDialog
   # @see  Wx::ColourPickerEvent 
   # 
   # 
+  # @wxrb_require USE_COLOURPICKERCTRL,USE_COLOURDLG
   class ColourPickerCtrl < PickerBase
   
     # @overload set_colour(col)
     #   Sets the currently selected colour.
+    #   
     #   See {Wx::Colour#set}.
     #   @param col [Wx::Colour,String,Symbol] 
     #   @return [void]
     # @overload set_colour(colname)
     #   Sets the currently selected colour.
+    #   
     #   See {Wx::Colour#set}.
     #   @param colname [String] 
     #   @return [void]
@@ -72,6 +74,7 @@ module Wx
     def initialize(*args) end
     
     # Creates a colour picker with the given arguments.
+    # 
     # true if the control was successfully created or false if creation failed.
     # @param parent [Wx::Window]  Parent window, must not be non-NULL.
     # @param id [Integer]  The identifier for the control.

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

@@ -31,23 +31,23 @@ module Wx
   EVT_COLOURPICKER_DIALOG_CANCELLED = 10186
   
   # This event class is used for the events generated by {Wx::ColourPickerCtrl}.
-  # === Events using this class
+  # 
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::ColourPickerEvent} events.
   # Event handler methods:
   # 
   # - {Wx::EvtHandler#evt_colourpicker_changed}(id, meth = nil, &block): Generated whenever the selected colour changes. 
   # 
-  # - {Wx::EvtHandler#evt_colourpicker_current_changed}(id, meth = nil, &block): Generated whenever the currently selected colour in the dialog shown by the picker changes. This event is new since wxWidgets 3.1.3 and currently is only implemented in wxMSW. 
-  # 
-  # - {Wx::EvtHandler#evt_colourpicker_dialog_cancelled}(id, meth = nil, &block): Generated when the user cancels the colour dialog associated with the control, i.e. closes it without accepting the selection. This event is new since wxWidgets 3.1.3 and currently is only implemented in wxMSW. 
+  # - {Wx::EvtHandler#evt_colourpicker_current_changed}(id, meth = nil, &block): Generated whenever the currently selected colour in the dialog shown by the picker changes. This event is new since wxWidgets 3.1.3 and currently is only implemented in WXMSW. 
   # 
-  # === 
+  # - {Wx::EvtHandler#evt_colourpicker_dialog_cancelled}(id, meth = nil, &block): Generated when the user cancels the colour dialog associated with the control, i.e. closes it without accepting the selection. This event is new since wxWidgets 3.1.3 and currently is only implemented in WXMSW. 
   # 
   # Category:  {Wx::Events}
   # @see Wx::ColourPickerCtrl 
   # 
   # 
+  # @wxrb_require USE_COLOURPICKERCTRL,USE_COLOURDLG
   class ColourPickerEvent < CommandEvent
   
     # @overload initialize()