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

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

@@ -11,7 +11,7 @@ module Wx
   # A combobox permits a single selection only. Combobox items are numbered from zero.
   # If you need a customized combobox, have a look at {Wx::ComboCtrl}, {Wx::OwnerDrawnComboBox}, {Wx::ComboPopup} and the ready-to-use {Wx::BitmapComboBox}.
   # Please refer to {Wx::TextEntry} documentation for the description of methods operating with the text entry part of the combobox and to {Wx::ItemContainer} for the methods operating with the list of strings. Notice that at least under MSW {Wx::ComboBox} doesn't behave correctly if it contains strings differing in case only so portable programs should avoid adding such strings to this control.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -25,7 +25,7 @@ module Wx
   # 
   # - {Wx::TE_PROCESS_ENTER}: The control will generate the event {Wx::EVT_TEXT_ENTER} that can be handled by the program. Otherwise, i.e. either if this style not specified at all, or it is used, but there is no event handler for this event or the event handler called {Wx::Event#skip} to avoid overriding the default handling, pressing Enter key is either processed internally by the control or used to activate the default button of the dialog, if any. 
   # 
-  # === 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::CommandEvent} events.
   # Event handler methods for events emitted by this class:
@@ -36,15 +36,13 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_text_enter}(id, meth = nil, &block): Process a {Wx::EVT_TEXT_ENTER} event, when RETURN is pressed in the combobox (notice that the combobox must have been created with {Wx::TE_PROCESS_ENTER} style to receive this event). 
   # 
-  # - {Wx::EvtHandler#evt_combobox_dropdown}(id, meth = nil, &block): Process a {Wx::EVT_COMBOBOX_DROPDOWN} event, which is generated when the list box part of the combo box is shown (drops down). Notice that this event is only supported by wxMSW, wxGTK with GTK+ 2.10 or later, and wxOSX/Cocoa. 
+  # - {Wx::EvtHandler#evt_combobox_dropdown}(id, meth = nil, &block): Process a {Wx::EVT_COMBOBOX_DROPDOWN} event, which is generated when the list box part of the combo box is shown (drops down). Notice that this event is only supported by WXMSW, WXGTK with GTK+ 2.10 or later, and WXOSX/Cocoa. 
   # 
   # - {Wx::EvtHandler#evt_combobox_closeup}(id, meth = nil, &block): Process a {Wx::EVT_COMBOBOX_CLOSEUP} event, which is generated when the list box of the combo box disappears (closes up). This event is only generated for the same platforms as {Wx::EVT_COMBOBOX_DROPDOWN} above. 
   # 
-  # === 
-  # 
-  # 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::ListBox
   # @see  Wx::TextCtrl
@@ -52,11 +50,12 @@ module Wx
   # @see  Wx::CommandEvent 
   # 
   # 
+  # @wxrb_require USE_COMBOBOX
   class ComboBox < ControlWithItems
   
     include Wx::TextEntry
   
-    # @overload create(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=((const Wx::String *) nil), style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload create(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=((CONST Wx::STRING *) nil), style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Creates the combobox for two-step construction.
     #   Derived classes should call or replace this function. See {Wx::ComboBox#initialize} for further details.
     #   @param parent [Wx::Window] 
@@ -69,7 +68,7 @@ module Wx
     #   @param validator [Wx::Validator] 
     #   @param name [String] 
     #   @return [Boolean]
-    # @overload create(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload create(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Creates the combobox for two-step construction.
     #   Derived classes should call or replace this function. See {Wx::ComboBox#initialize} for further details.
     #   @param parent [Wx::Window] 
@@ -87,7 +86,7 @@ module Wx
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::ComboBox]
-    # @overload initialize(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload initialize(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Constructor, creating and showing a combobox.
     #   
     #   @see Wx::ComboBox#create
@@ -102,7 +101,7 @@ module Wx
     #   @param validator [Wx::Validator]  Window validator.
     #   @param name [String]  Window name.
     #   @return [Wx::ComboBox]
-    # @overload initialize(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload initialize(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Constructor, creating and showing a combobox.
     #   
     #   @see Wx::ComboBox#create
@@ -126,7 +125,11 @@ module Wx
     alias_method :current_selection, :get_current_selection
     
     # Same as {Wx::TextEntry#get_insertion_point}.
-    # Under wxMSW, this function always returns 0 if the combobox doesn't have the focus.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Under WXMSW, this function always returns 0 if the combobox doesn't have the focus. 
+    # </p>
+    # </div>
     # @return [Integer]
     def get_insertion_point; end
     alias_method :insertion_point, :get_insertion_point
@@ -168,14 +171,14 @@ module Wx
     alias_method :value=, :set_value
     
     # Shows the list box portion of the combo box.
-    # Currently this method is implemented in wxMSW, wxGTK and wxOSX/Cocoa.
-    # Notice that calling this function will generate a {Wx::EVT_COMBOBOX_DROPDOWN} event except under wxOSX where generation of this event is not supported at all.
+    # Currently this method is implemented in WXMSW, WXGTK and WXOSX/Cocoa.
+    # Notice that calling this function will generate a {Wx::EVT_COMBOBOX_DROPDOWN} event except under WXOSX where generation of this event is not supported at all.
     # @return [void]
     def popup; end
     
     # Hides the list box portion of the combo box.
-    # Currently this method is implemented in wxMSW, wxGTK and wxOSX/Cocoa.
-    # Notice that calling this function will generate a {Wx::EVT_COMBOBOX_CLOSEUP} event except under wxOSX where generation of this event is not supported at all.
+    # Currently this method is implemented in WXMSW, WXGTK and WXOSX/Cocoa.
+    # Notice that calling this function will generate a {Wx::EVT_COMBOBOX_CLOSEUP} event except under WXOSX where generation of this event is not supported at all.
     # @return [void]
     def dismiss; end
     

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

@@ -18,6 +18,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_COMBOCTRL
   class OwnerDrawnComboBoxPaintingFlags < Wx::Enum
   
     # Combo control is being painted, instead of a list item.
@@ -41,15 +42,15 @@ module Wx
   # A combo control is a generic combobox that allows totally custom popup.
   # In addition it has other customization features. For instance, position and size of the dropdown button can be changed.
   # 
-  # == Setting Custom Popup for wxComboCtrl
+  # ## Setting Custom Popup for wxComboCtrl
   # 
   # {Wx::ComboCtrl} needs to be told somehow which control to use and this is done by {Wx::ComboCtrl#set_popup_control}. However, we need something more than just a {Wx::Control} in this method as, for example, we need to call SetStringValue("initial text value") and {Wx::Control} doesn't have such method. So we also need a {Wx::ComboPopup} which is an interface which must be implemented by a control to be usable as a popup.
   # We couldn't derive {Wx::ComboPopup} from {Wx::Control} as this would make it impossible to have a class deriving from a wxWidgets control and from it, so instead it is just a mix-in.
   # Here's a minimal sample of {Wx::ListView} popup:
   # 
   # ```
-  #   #include <wx/combo.h>
-  #   #include <wx/listctrl.h>
+  #   \#include <wx/combo.h>
+  #   \#include <wx/listctrl.h>
   #   
   #   class wxListViewComboPopup : public wxListView, public wxComboPopup
   #   {
@@ -131,7 +132,7 @@ module Wx
   #   popupCtrl->InsertItem(popupCtrl->GetItemCount(), "Third Item");
   # ```
   # 
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -145,7 +146,7 @@ module Wx
   # 
   # - {Wx::CC_STD_BUTTON}: Drop button will behave more like a standard push button. 
   # 
-  # === 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::CommandEvent} events.
   # Event handler methods for events emitted by this class:
@@ -158,11 +159,9 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_combobox_closeup}(id, meth = nil, &block): Process a {Wx::EVT_COMBOBOX_CLOSEUP} event, which is generated when the popup window of the combo control disappears (closes up). You should avoid adding or deleting items in this 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::ComboBox
   # @see  Wx::Choice
@@ -171,6 +170,7 @@ module Wx
   # @see  Wx::CommandEvent 
   # 
   # 
+  # @wxrb_require USE_COMBOCTRL
   class ComboCtrl < Control
   
     include Wx::TextEntry
@@ -194,7 +194,7 @@ module Wx
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::ComboCtrl]
-    # @overload initialize(parent, id=Wx::StandardID::ID_ANY, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload initialize(parent, id=Wx::StandardID::ID_ANY, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Constructor, creating and showing a combo control.
     #   
     #   @see Wx::ComboCtrl#create
@@ -225,7 +225,7 @@ module Wx
     # @param validator [Wx::Validator] 
     # @param name [String] 
     # @return [Boolean]
-    def create(parent, id=Wx::StandardID::ID_ANY, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr) end
+    def create(parent, id=Wx::StandardID::ID_ANY, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR) end
     
     # Copies the selected text to the clipboard and removes the selection.
     # @return [void]
@@ -304,7 +304,11 @@ module Wx
     alias_method :hint, :get_hint
     
     # Returns the insertion point for the combo control's text field.
-    # Under Windows, this function always returns 0 if the combo control doesn't have the focus.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Under Windows, this function always returns 0 if the combo control doesn't have the focus. 
+    # </p>
+    # </div>
     # @return [Integer]
     def get_insertion_point; end
     alias_method :insertion_point, :get_insertion_point
@@ -316,7 +320,12 @@ module Wx
     
     # Returns the margins used by the control.
     # The x field of the returned point is the horizontal margin and the y field is the vertical one.
-    # If given margin cannot be accurately determined, its value will be set to -1.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>If given margin cannot be accurately determined, its value will be set to -1.
+    # </p>
+    # </div>>
     # @see Wx::ComboCtrl#set_margins
     # @return [Wx::Point]
     def get_margins; end
@@ -371,7 +380,12 @@ module Wx
     
     # Implement in a derived class to define what happens on dropdown button click.
     # Default action is to show the popup.
-    # If you implement this to do something else than show the popup, you must then also implement {Wx::ComboCtrl#do_set_popup_control} to always return NULL.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>If you implement this to do something else than show the popup, you must then also implement {Wx::ComboCtrl#do_set_popup_control} to always return NULL. 
+    # </p>
+    # </div>
     # @return [void]
     def on_button_click; end
     
@@ -485,14 +499,22 @@ module Wx
     alias_method :popup_control=, :set_popup_control
     
     # Extends popup size horizontally, relative to the edges of the combo control.
-    # Popup minimum width may override arguments. It is up to the popup to fully take this into account.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Popup minimum width may override arguments. It is up to the popup to fully take this into account. 
+    # </p>
+    # </div>>
     # @param extLeft [Integer]  How many pixel to extend beyond the left edge of the control. Default is 0.
     # @param extRight [Integer]  How many pixel to extend beyond the right edge of the control. Default is 0.
     # @return [void]
     def set_popup_extents(extLeft, extRight) end
     
     # Sets preferred maximum height of the popup.
-    # Value -1 indicates the default.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Value -1 indicates the default. 
+    # </p>
+    # </div>>
     # @param height [Integer] 
     # @return [void]
     def set_popup_max_height(height) end
@@ -500,7 +522,12 @@ module Wx
     
     # Sets minimum width of the popup.
     # If wider than combo control, it will extend to the left.
-    # Value -1 indicates the default. Also, popup implementation may choose to ignore this.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Value -1 indicates the default. Also, popup implementation may choose to ignore this. 
+    # </p>
+    # </div>>
     # @param width [Integer] 
     # @return [void]
     def set_popup_min_width(width) end
@@ -536,7 +563,11 @@ module Wx
     alias_method :text_ctrl_style=, :set_text_ctrl_style
     
     # Sets the text for the combo control text field.
-    # For a combo control with {Wx::CB_READONLY} style the string must be accepted by the popup (for instance, exist in the dropdown list), otherwise the call to {Wx::ComboCtrl#set_value} is ignored.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>For a combo control with {Wx::CB_READONLY} style the string must be accepted by the popup (for instance, exist in the dropdown list), otherwise the call to {Wx::ComboCtrl#set_value} is ignored. 
+    # </p>
+    # </div>
     # @param value [String] 
     # @return [void]
     def set_value(value) end
@@ -579,7 +610,12 @@ module Wx
     
     # This member function is not normally called in application code.
     # Instead, it can be implemented in a derived class to return default {Wx::ComboPopup}, in case popup is NULL.
-    # If you have implemented {Wx::ComboCtrl#on_button_click} to do something else than show the popup, then {Wx::ComboCtrl#do_set_popup_control} must always set popup to NULL.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>If you have implemented {Wx::ComboCtrl#on_button_click} to do something else than show the popup, then {Wx::ComboCtrl#do_set_popup_control} must always set popup to NULL. 
+    # </p>
+    # </div>
     # @param popup [Wx::ComboPopup] 
     # @return [void]
     def do_set_popup_control(popup) end
@@ -595,7 +631,6 @@ module Wx
   
   # In order to use a custom popup with {Wx::ComboCtrl}, an interface class must be derived from {Wx::ComboPopup}.
   # For more information on how to use it, see Setting Custom Popup for wxComboCtrl.
-  # === 
   # 
   # Category:  {Wx::Controls}
   # @see Wx::ComboCtrl 
@@ -603,6 +638,7 @@ module Wx
   # 
   # 
   # @note  In wxRuby this is a mixin module instead of a (base) class.
+  # @wxrb_require USE_COMBOCTRL
   module ComboPopup
   
     # Default constructor.
@@ -627,14 +663,22 @@ module Wx
     def dismiss; end
     
     # Implement to customize matching of value string to an item container entry.
-    # Default implementation always return true and does not alter trueItem.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Default implementation always return true and does not alter trueItem. 
+    # </p>
+    # </div>>
     # @param item [String]  String entered, usually by user or from SetValue() call.
     # @param trueItem [String]  When item matches an entry, but the entry's string representation is not exactly the same (case mismatch, for example), then the true item string should be written back to here, if it is not a NULL pointer.
     # @return [Boolean]
     def find_item(item, trueItem=nil) end
     
     # The derived class may implement this to return adjusted size for the popup control, according to the variables given.
-    # This function is called each time popup is about to be shown.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This function is called each time popup is about to be shown. 
+    # </p>
+    # </div>>
     # @param minWidth [Integer]  Preferred minimum width.
     # @param prefHeight [Integer]  Preferred height. May be -1 to indicate no preference.
     # @param maxHeight [Integer]  Max height for window, as limited by screen size.
@@ -670,7 +714,12 @@ module Wx
     
     # The derived class may implement this to return true if it wants to delay call to {Wx::ComboPopup#create} until the popup is shown for the first time.
     # It is more efficient, but on the other hand it is often more convenient to have the control created immediately.
-    # Base implementation returns false.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Base implementation returns false. 
+    # </p>
+    # </div>>
     # @return [Boolean]
     def lazy_create; end
     
@@ -710,7 +759,7 @@ module Wx
   # {Wx::OwnerDrawnComboBox} is a combobox with owner-drawn list items.
   # In essence, it is a {Wx::ComboCtrl} with {Wx::VListBox} popup and {Wx::ControlWithItems} interface.
   # Implementing item drawing and measuring is similar to {Wx::VListBox}. Application needs to subclass {Wx::OwnerDrawnComboBox} and implement {Wx::OwnerDrawnComboBox#on_draw_item}, {Wx::OwnerDrawnComboBox#on_measure_item} and {Wx::OwnerDrawnComboBox#on_measure_item_width}.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -718,18 +767,16 @@ module Wx
   # 
   # - {Wx::ODCB_STD_CONTROL_PAINT}: Control itself is not custom painted using OnDrawItem. Even if this style is not used, writable {Wx::OwnerDrawnComboBox} is never custom painted unless {Wx::OwnerDrawnComboBox#set_custom_paint_width} is called. 
   # 
-  # === 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::CommandEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_combobox}(id, meth = nil, &block): Process a {Wx::EVT_COMBOBOX} event, when an item on the list is selected. Note that calling {Wx::OwnerDrawnComboBox#get_value} returns the new value of selection. 
   # 
-  # === 
-  # 
-  # 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::ComboCtrl window styles and Window Styles.
   # 
@@ -741,12 +788,18 @@ module Wx
   # @see  Wx::CommandEvent 
   # 
   # 
+  # @wxrb_require USE_COMBOCTRL
   class OwnerDrawnComboBox < ComboCtrl
   
-    # @overload create(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload create(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Creates the combobox for two-step construction.
     #   See {Wx::OwnerDrawnComboBox#initialize} for further details.
-    #   Derived classes should call or replace this function.
+    #   
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>Derived classes should call or replace this function. 
+    #   </p>
+    #   </div>>
     #   @param parent [Wx::Window] 
     #   @param id [Integer] 
     #   @param value [String] 
@@ -756,10 +809,15 @@ module Wx
     #   @param validator [Wx::Validator] 
     #   @param name [String] 
     #   @return [Boolean]
-    # @overload create(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ComboBoxNameStr)
+    # @overload create(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Creates the combobox for two-step construction.
     #   See {Wx::OwnerDrawnComboBox#initialize} for further details.
-    #   Derived classes should call or replace this function.
+    #   
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>Derived classes should call or replace this function. 
+    #   </p>
+    #   </div>>
     #   @param parent [Wx::Window] 
     #   @param id [Integer] 
     #   @param value [String] 
@@ -775,7 +833,7 @@ module Wx
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::OwnerDrawnComboBox]
-    # @overload initialize(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=("comboBox"))
+    # @overload initialize(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=("COMBO_BOX"))
     #   Constructor, creating and showing a owner-drawn combobox.
     #   
     #   @see Wx::OwnerDrawnComboBox#create
@@ -924,7 +982,12 @@ module Wx
     
     # This method is used to draw the items background and, maybe, a border around it.
     # The base class version implements a reasonable default behaviour which consists in drawing the selected item with the standard background colour and drawing a border around the item if it is either selected or current.
-    # flags has the same meaning as with {Wx::OwnerDrawnComboBox#on_draw_item}.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>flags has the same meaning as with {Wx::OwnerDrawnComboBox#on_draw_item}. 
+    # </p>
+    # </div>>
     # @param dc [Wx::DC] 
     # @param rect [Wx::Rect] 
     # @param item [Integer] 

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

@@ -13,23 +13,22 @@ module Wx
   # {Wx::CommandLinkButton} generates the same event as {Wx::Button} but doesn't support any of {Wx::Button}-specific styles nor adds any new styles of its own.
   # Currently this class uses native implementation under Windows Vista and later versions and a generic implementation for the other platforms and earlier Windows versions.
   # 
-  # === 
-  # 
-  # 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::Button
   # @see  Wx::BitmapButton 
   # 
   # 
+  # @wxrb_require USE_BUTTON
   class CommandLinkButton < Button
   
     # @overload initialize()
     #   Default constructor.
     #   Use {Wx::CommandLinkButton#create} to really create the control.
     #   @return [Wx::CommandLinkButton]
-    # @overload initialize(parent, id, mainLabel=(''), note=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ButtonNameStr)
+    # @overload initialize(parent, id, mainLabel=(''), note=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::BUTTON_NAME_STR)
     #   Constructor really creating a command Link button.
     #   The button will be decorated with stock icons under GTK+ 2.
     #   @see Wx::CommandLinkButton#create
@@ -58,7 +57,7 @@ module Wx
     # @param validator [Wx::Validator] 
     # @param name [String] 
     # @return [Boolean]
-    def create(parent, id, mainLabel=(''), note=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ButtonNameStr) end
+    def create(parent, id, mainLabel=(''), note=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::BUTTON_NAME_STR) end
     
     # Sets a new main label and note for the button.
     # Neither of the arguments can be empty, if you need to change just the label or just the note, use {Wx::CommandLinkButton#set_main_label} or {Wx::CommandLinkButton#set_note} instead of this function.

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

@@ -9,17 +9,21 @@ module Wx
   # Instances of this class may be used to add a question mark button that when pressed, puts the application into context-help mode.
   # It does this by creating a {Wx::ContextHelp} object which itself generates a {Wx::EVT_HELP} event when the user clicks on a window.
   # On Windows, you may add a question-mark icon to a dialog by use of the {Wx::DIALOG_EX_CONTEXTHELP} extra style, but on other platforms you will have to add a button explicitly, usually next to OK, Cancel or similar buttons.
-  # === 
   # 
   # Category:  {Wx::HELP}
   # @see Wx::BitmapButton
   # @see  Wx::ContextHelp 
   # 
   # 
+  # @wxrb_require USE_HELP
   class ContextHelpButton < BitmapButton
   
     # Constructor, creating and showing a context help button.
-    # Normally you only need pass the parent window to the constructor, and use the defaults for the remaining parameters.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Normally you only need pass the parent window to the constructor, and use the defaults for the remaining parameters. 
+    # </p>
+    # </div>>
     # @param parent [Wx::Window]  Parent window. Must not be NULL.
     # @param id [Integer]  Button identifier. Defaults to {Wx::StandardID::ID_CONTEXT_HELP}.
     # @param pos [Array(Integer, Integer), Wx::Point]  Button position. If {Wx::DEFAULT_POSITION} is specified then a default position is chosen.
@@ -48,7 +52,6 @@ module Wx
   # - Create a {Wx::ContextHelpButton}, whose predefined behaviour is to create a context help object. Normally you will write your application so that this button is only added to a dialog for non-Windows platforms (use {Wx::DIALOG_EX_CONTEXTHELP} on Windows).
   # 
   # Note that on macOS, the cursor does not change when in context-sensitive help mode.
-  # === 
   # 
   # Category:  {Wx::HELP}
   # @see Wx::HelpEvent
@@ -56,6 +59,7 @@ module Wx
   # @see  Wx::ContextHelpButton 
   # 
   # 
+  # @wxrb_require USE_HELP
   class ContextHelp < Object
   
     # Constructs a context help object, calling {Wx::ContextHelp#begin_context_help} if doNow is true (the default).

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

@@ -8,7 +8,7 @@ module Wx
 
   # This is the base class for a control or "widget".
   # A control is generally a small window which processes user input and/or displays one or more item of data.
-  # === 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::ClipboardTextEvent} events.
   # Event handler methods for events emitted by this class:
@@ -19,15 +19,13 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_text_paste}(id, meth = nil, &block): Clipboard content was pasted into the control. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Controls}
   # @see Wx::Validator 
   # 
   # 
   class Control < Window
   
-    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ControlNameStr)
+    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::CONTROL_NAME_STR)
     #   Constructs a control.
     #   @param parent [Wx::Window]  Pointer to a parent window.
     #   @param id [Integer]  Control identifier. If {Wx::StandardID::ID_ANY}, will automatically create an identifier.
@@ -50,7 +48,7 @@ module Wx
     # @param validator [Wx::Validator] 
     # @param name [String] 
     # @return [Boolean]
-    def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ControlNameStr) end
+    def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::CONTROL_NAME_STR) end
     
     # Simulates the effect of the user issuing a command to the item.
     # 
@@ -86,7 +84,7 @@ module Wx
     #            postcode.get_text_extent("99999")))
     #   ```
     #   
-    #   Currently this method is only implemented for {Wx::TextCtrl}, {Wx::ComboBox} and {Wx::Choice} in wxMSW and wxGTK.
+    #   Currently this method is only implemented for {Wx::TextCtrl}, {Wx::ComboBox} and {Wx::Choice} in WXMSW and WXGTK.
     #   
     #   The size that the control should have to leave the area of the specified size for its text. May return {Wx::DEFAULT_SIZE} if this method is not implemented for this particular control under the current platform.
     #   @param xlen [Integer]  The horizontal extent of the area to leave for text, in pixels.
@@ -138,7 +136,7 @@ module Wx
     #                         "<span foreground='red'>breakfast</span> "+
     #                         "available <big>HERE</big>")
     # ```
-    #  would show the string using bold, red and big for the corresponding words under wxGTK but will simply show the string "Bed &amp; breakfast
+    #  would show the string using bold, red and big for the corresponding words under WXGTK but will simply show the string "Bed &amp; breakfast
     # available HERE" on the other platforms. In any case, the "B" of "Bed" will be underlined to indicate that it can be used as a mnemonic for this control.
     # The supported tags are: 
     # <b>Tag</b> 
@@ -214,14 +212,18 @@ module Wx
     # 
     # true if the new label was set (even if markup in it was ignored) or false if we failed to parse the markup. In this case the label remains unchanged.
     # 
-    # Currently {Wx::Button} supports markup in all major ports (wxMSW, wxGTK and wxOSX/Cocoa) while {Wx::StaticText} supports it in wxGTK and wxOSX and its generic version (which can be used under MSW if markup support is required). Extending support to more controls is planned in the future.
-    # @param markup [String]  String containing markup for the label. It may contain markup tags described above and newline characters but currently only wxGTK and wxOSX support multiline labels with markup, the generic implementation (also used in wxMSW) only handles single line markup labels. Notice that the string must be well-formed (e.g. all tags must be correctly closed) and won't be shown at all otherwise.
+    # Currently {Wx::Button} supports markup in all major ports (WXMSW, WXGTK and WXOSX/Cocoa) while {Wx::StaticText} supports it in WXGTK and WXOSX and its generic version (which can be used under MSW if markup support is required). Extending support to more controls is planned in the future.
+    # @param markup [String]  String containing markup for the label. It may contain markup tags described above and newline characters but currently only WXGTK and WXOSX support multiline labels with markup, the generic implementation (also used in WXMSW) only handles single line markup labels. Notice that the string must be well-formed (e.g. all tags must be correctly closed) and won't be shown at all otherwise.
     # @return [Boolean]
     def set_label_markup(markup) end
     alias_method :label_markup=, :set_label_markup
     
     # Returns the given str string without mnemonics ("&" characters).
-    # This function is identical to {Wx::Control#get_label_text} and is provided mostly for symmetry with {Wx::Control.escape_mnemonics}.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function is identical to {Wx::Control#get_label_text} and is provided mostly for symmetry with {Wx::Control.escape_mnemonics}. 
+    # </p>
+    # </div>
     # @param str [String] 
     # @return [String]
     def self.remove_mnemonics(str) end

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

@@ -8,7 +8,6 @@ module Wx
 
   # This is convenience class that derives from both {Wx::Control} and {Wx::ItemContainer}.
   # It is used as basis for some wxWidgets controls ({Wx::Choice} and {Wx::ListBox}).
-  # === 
   # 
   # Category:  {Wx::Controls}
   # @see Wx::ItemContainer

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

@@ -7,7 +7,7 @@
 module Wx
 
   # wxRuby version string
-  Wx::WXRUBY_VERSION = '0.9.0'
+  Wx::WXRUBY_VERSION = '0.9.2'
 
   # wxRuby version release type (alpha, beta, rc)
   Wx::WXRUBY_RELEASE_TYPE = ''
@@ -16,10 +16,10 @@ module Wx
   # wxRuby minor version number
   Wx::WXRUBY_MINOR = 9
   # wxRuby release number
-  Wx::WXRUBY_RELEASE = 0
+  Wx::WXRUBY_RELEASE = 2
 
   # Convenience string for WxWidgets version info
-  WXWIDGETS_VERSION = '3.2.3'
+  WXWIDGETS_VERSION = '3.2.4'
 
   # Integer constant reflecting the major version of the wxWidgets release used to build wxRuby
   WXWIDGETS_MAJOR_VERSION = 3
@@ -28,7 +28,7 @@ module Wx
   WXWIDGETS_MINOR_VERSION = 2
 
   # Integer constant reflecting the release number of the wxWidgets release used to build wxRuby
-  WXWIDGETS_RELEASE_NUMBER = 3
+  WXWIDGETS_RELEASE_NUMBER = 4
 
   # Integer constant reflecting the sub-release number of the wxWidgets release used to build wxRuby
   WXWIDGETS_SUBRELEASE_NUMBER = 0