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

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

@@ -10,13 +10,13 @@ module Wx
   # The strings are displayed in a scrolling box, with the selected string(s) marked in reverse video. A listbox can be single selection (if an item is selected, the previous selection is removed) or multiple selection (clicking an item toggles the item on or off independently of other selections).
   # List box elements are numbered from zero and while the maximal number of elements is unlimited, it is usually better to use a virtual control, not requiring to add all the items to it at once, such as {Wx::DataViewCtrl} or {Wx::ListCtrl} with {Wx::LC_VIRTUAL} style, once more than a few hundreds items need to be displayed because this control is not optimized, neither from performance nor from user interface point of view, for large number of items.
   # Notice that the list box doesn't support control characters other than TAB.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
   # - {Wx::LB_SINGLE}: Single-selection list. 
   # 
-  # - {Wx::LB_MULTIPLE}: Multiple-selection list: the user can toggle multiple items on and off. This is the same as {Wx::LB_EXTENDED} in wxGTK2 port. 
+  # - {Wx::LB_MULTIPLE}: Multiple-selection list: the user can toggle multiple items on and off. This is the same as {Wx::LB_EXTENDED} in WXGTK2 port. 
   # 
   # - {Wx::LB_EXTENDED}: Extended-selection list: the user can extend the selection by using SHIFT or CTRL keys together with the cursor movement keys or the mouse. 
   # 
@@ -26,25 +26,23 @@ module Wx
   # 
   # - {Wx::LB_NEEDED_SB}: Only create a vertical scrollbar if needed. 
   # 
-  # - {Wx::LB_NO_SB}: Don't create vertical scrollbar (wxMSW and wxGTK only). 
+  # - {Wx::LB_NO_SB}: Don't create vertical scrollbar (WXMSW and WXGTK only). 
   # 
   # - {Wx::LB_SORT}: The listbox contents are sorted in alphabetical order. 
   # 
   # Note that {Wx::LB_SINGLE}, {Wx::LB_MULTIPLE} and {Wx::LB_EXTENDED} styles are mutually exclusive and you can specify at most one of them (single selection is the default). See also Window Styles.
-  # === 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_listbox}(id, meth = nil, &block): Process a {Wx::EVT_LISTBOX} event, when an item on the list is selected or the selection changes. 
   # 
-  # - {Wx::EvtHandler#evt_listbox_dclick}(id, meth = nil, &block): Process a {Wx::EVT_LISTBOX_DCLICK} event, when the listbox is double-clicked. On some platforms (notably wxGTK2) pressing the enter key is handled as an equivalent of a double-click. 
+  # - {Wx::EvtHandler#evt_listbox_dclick}(id, meth = nil, &block): Process a {Wx::EVT_LISTBOX_DCLICK} event, when the listbox is double-clicked. On some platforms (notably WXGTK2) pressing the enter key is handled as an equivalent of a double-click. 
   # 
-  # === 
-  # 
-  # 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::EditableListBox
   # @see  Wx::Choice
@@ -53,9 +51,10 @@ module Wx
   # @see  Wx::CommandEvent 
   # 
   # 
+  # @wxrb_require USE_LISTBOX
   class ListBox < ControlWithItems
   
-    # @overload create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListBoxNameStr)
+    # @overload create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_BOX_NAME_STR)
     #   Creates the listbox for two-step construction.
     #   See {Wx::ListBox#initialize} for further details.
     #   @param parent [Wx::Window] 
@@ -67,7 +66,7 @@ module Wx
     #   @param validator [Wx::Validator] 
     #   @param name [String] 
     #   @return [Boolean]
-    # @overload create(parent, id, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListBoxNameStr)
+    # @overload create(parent, id, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_BOX_NAME_STR)
     #   Creates the listbox for two-step construction.
     #   See {Wx::ListBox#initialize} for further details.
     #   @param parent [Wx::Window] 
@@ -84,7 +83,7 @@ module Wx
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::ListBox]
-    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListBoxNameStr)
+    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_BOX_NAME_STR)
     #   Constructor, creating and showing a list box.
     #   @param parent [Wx::Window]  The parent window.
     #   @param id [Integer]  The ID of this control. A value of {Wx::StandardID::ID_ANY} indicates a default value.
@@ -95,7 +94,7 @@ module Wx
     #   @param validator [Wx::Validator]  The validator for this control.
     #   @param name [String]  The name of this class.
     #   @return [Wx::ListBox]
-    # @overload initialize(parent, id, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListBoxNameStr)
+    # @overload initialize(parent, id, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_BOX_NAME_STR)
     #   Constructor, creating and showing a list box.
     #   See the other {Wx::ListBox#initialize} constructor; the only difference is that this overload takes a {Wx::ArrayString} instead of a pointer to an array of {Wx::String}.
     #   @param parent [Wx::Window] 
@@ -110,7 +109,11 @@ module Wx
     def initialize(*args) end
     
     # Deselects an item in the list box.
-    # This applies to multiple selection listboxes only.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This applies to multiple selection listboxes only. 
+    # </p>
+    # </div>>
     # @param n [Integer]  The zero-based item to deselect.
     # @return [void]
     def deselect(n) end
@@ -127,7 +130,11 @@ module Wx
     # Returns the index of the selected item or {Wx::NOT_FOUND} if no item is selected.
     # The position of the current selection.
     # 
-    # This method can be used with single selection list boxes only, you must use {Wx::ListBox#get_selections} for the list boxes with {Wx::LB_MULTIPLE} style.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This method can be used with single selection list boxes only, you must use {Wx::ListBox#get_selections} for the list boxes with {Wx::LB_MULTIPLE} style.
+    # </p>
+    # </div>>
     # @see Wx::ListBox#set_selection
     # @see  Wx::ListBox#get_string_selection 
     # @return [Integer]
@@ -147,7 +154,11 @@ module Wx
     # Fill an array of ints with the positions of the currently selected items.
     # The number of selections.
     # 
-    # Use this with a multiple selection listbox.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use this with a multiple selection listbox.
+    # </p>
+    # </div>>
     # @see Wx::ControlWithItems::GetSelection
     # @see  Wx::ControlWithItems::GetStringSelection
     # @see  Wx::ControlWithItems::SetSelection 
@@ -157,7 +168,7 @@ module Wx
     
     # @overload hit_test(point)
     #   Returns the item located at point, or {Wx::NOT_FOUND} if there is no item located at point.
-    #   It is currently implemented for wxMSW, {Wx::Mac} and wxGTK2 ports.
+    #   It is currently implemented for WXMSW, WXOSX and WXGTK2 ports.
     #   
     #   Item located at point, or {Wx::NOT_FOUND} if unimplemented or the item does not exist.
     #   @param point [Array(Integer, Integer), Wx::Point]  Point of item (in client coordinates) to obtain
@@ -200,7 +211,7 @@ module Wx
     def ensure_visible(n) end
     
     # Return the number of items that can fit vertically in the visible area of the listbox.
-    # Returns -1 if the number of items per page couldn't be determined. On wxGTK this method can only determine the number of items per page if there is at least one item in the listbox.
+    # Returns -1 if the number of items per page couldn't be determined. On WXGTK this method can only determine the number of items per page if there is at least one item in the listbox.
     # @return [Integer]
     def get_count_per_page; end
     alias_method :count_per_page, :get_count_per_page
@@ -218,9 +229,10 @@ module Wx
     # 
     # true if all specified tabs are set, false otherwise
     # 
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
-    # @param tabStops [Wx::Vector< int >]  If this argument is empty, tab stops are reset to their default value (every 32 dialog units). If it contains a single element, tab stops are set at each multiple of the given value. Otherwise tab stops are set at every element of the array, which must be in ascending order.
+    # Availability:  only available for the WXMSW port.
+    # @param tabStops [Array<Integer>]  If this argument is empty, tab stops are reset to their default value (every 32 dialog units). If it contains a single element, tab stops are set at each multiple of the given value. Otherwise tab stops are set at every element of the array, which must be in ascending order.
     # @return [Boolean]
+    # @wxrb_require WXMSW
     def msw_set_tab_stops(tabStops) end
     
     # Returns the number of items in the control.

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

@@ -169,6 +169,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_LISTCTRL
   class ListColumnFormat < Wx::Enum
   
     # 
@@ -319,13 +320,23 @@ module Wx
   # Virtual list control can be used as a normal one except that no operations which can take time proportional to the number of items in the control happen  this is required to allow having a practically infinite number of items. For example, in a multiple selection virtual list control, the selections won't be sent when many items are selected at once because this could mean iterating over all the items.
   # Using many of {Wx::ListCtrl} features is shown in the corresponding sample.
   # To intercept events from a list control, use the event table macros described in {Wx::ListEvent}.
-  # The native wxOSX implementation for report mode that was added in wxWidgets 2.8 was removed in wxWidgets 3.1, meaning for wxWidgets 3.1+ wxOSX uses the generic implementation for all modes.
   # 
-  # == Column Ordering
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>The native WXOSX implementation for report mode that was added in wxWidgets 2.8 was removed in wxWidgets 3.1, meaning for wxWidgets 3.1+ WXOSX uses the generic implementation for all modes.
+  # </p>
+  # </div>
+  # 
+  # ## Column Ordering
   # 
   # By default, the columns of a list control appear on the screen in order of their indices, i.e. column 0 appears first, then column 1 next, and so on. However this can be changed by using the {Wx::ListCtrl#set_columns_order} function to arbitrarily reorder the columns visual order.
   # The user can also rearrange the columns interactively by dragging them. In this case, the index of the column is not the same as its order and the functions {Wx::ListCtrl#get_column_order} and {Wx::ListCtrl#get_column_index_from_order} should be used to translate between them.
-  # All the other functions still work with the column indices, i.e. the visual positioning of the columns on screen doesn't affect the code setting or getting their values for example.
+  # 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>All the other functions still work with the column indices, i.e. the visual positioning of the columns on screen doesn't affect the code setting or getting their values for example.
+  # </p>
+  # </div>
   # 
   # Example of reordering columns: 
   # ```ruby
@@ -341,7 +352,7 @@ module Wx
   #   # 1 and 2 respectively
   # ```
   # 
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -375,7 +386,7 @@ module Wx
   # 
   # - {Wx::LC_VRULES}: Draws light vertical rules between columns in report mode. 
   # 
-  # === 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::ListEvent} events.
   # Event handler methods for events emitted by this class:
@@ -424,13 +435,15 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_list_item_unchecked}(id, meth = nil, &block): The item has been unchecked. Processes a {Wx::EVT_LIST_ITEM_UNCHECKED} event type (new since wxWidgets 3.1.0). 
   # 
-  # Under wxMSW this control uses {Wx::SystemThemedControl} for an explorer style appearance by default since wxWidgets 3.1.0. If this is not desired, you can call Wx::SystemThemedControl::EnableSystemTheme with false argument to disable this.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Under WXMSW this control uses {Wx::SystemThemedControl} for an explorer style appearance by default since wxWidgets 3.1.0. If this is not desired, you can call Wx::SystemThemedControl::EnableSystemTheme with false argument to disable this.
+  # </p>
+  # </div>
   # 
-  # === 
-  # 
-  # 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 wxListCtrl Overview
   # @see  Wx::ListView
@@ -442,12 +455,13 @@ module Wx
   # @see  Wx::EditableListBox 
   # 
   # 
+  # @wxrb_require USE_LISTCTRL
   class ListCtrl < Control
   
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::ListCtrl]
-    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::LC_ICON, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListCtrlNameStr)
+    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::LC_ICON, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_CTRL_NAME_STR)
     #   Constructor, creating and showing a list control.
     #   
     #   @see Wx::ListCtrl#create
@@ -482,7 +496,11 @@ module Wx
     def arrange(flag=Wx::LIST_ALIGN_DEFAULT) end
     
     # Deletes all items and all columns.
-    # This sends an event of type {Wx::EVT_LIST_DELETE_ALL_ITEMS} under all platforms.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This sends an event of type {Wx::EVT_LIST_DELETE_ALL_ITEMS} under all platforms. 
+    # </p>
+    # </div>
     # @return [void]
     def clear_all; end
     
@@ -496,7 +514,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=Wx::LC_ICON, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListCtrlNameStr) end
+    def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::LC_ICON, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_CTRL_NAME_STR) end
     
     # Delete all columns in the list control.
     # true if all columns were successfully deleted, false otherwise.
@@ -530,7 +548,7 @@ module Wx
     def enable_alternate_row_colours(enable=true) end
     
     # Enable or disable a beep if there is no match for the currently entered text when searching for the item from keyboard.
-    # The default is to not beep in this case except in wxMSW where the beep is always generated by the native control and cannot be disabled, i.e. calls to this function do nothing there.
+    # The default is to not beep in this case except in WXMSW where the beep is always generated by the native control and cannot be disabled, i.e. calls to this function do nothing there.
     # @param on [Boolean] 
     # @return [void]
     def enable_bell_on_no_match(on=true) end
@@ -538,7 +556,7 @@ module Wx
     # Finish editing the label.
     # This method allows one to programmatically end editing a list control item in place. Usually it will only be called when editing is in progress, i.e. if {Wx::ListCtrl#get_edit_control} returns non-NULL. In particular, do not call it from EVT_LIST_BEGIN_LABEL_EDIT handler as the edit control is not yet fully created by then, just veto the event in this handler instead to prevent the editing from even starting.
     # Notice that calling this method will result in EVT_LIST_END_LABEL_EDIT event being generated.
-    # Currently only implemented in wxMSW.
+    # Currently only implemented in WXMSW.
     # 
     # true if item editing was finished or false if no item as being edited.
     # @param cancel [Boolean]  If true, discard the changes made by user, as if Escape key was pressed. Otherwise, accept the changes as if Return was pressed.
@@ -601,7 +619,12 @@ module Wx
     
     # Returns the edit control being currently used to edit a label.
     # Returns NULL if no label is being edited.
-    # It is currently only implemented for wxMSW and the generic version, not for the native macOS version.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>It is currently only implemented for WXMSW and the generic version, not for the native macOS version. 
+    # </p>
+    # </div>
     # @return [Wx::TextCtrl]
     def get_edit_control; end
     alias_method :edit_control, :get_edit_control
@@ -702,7 +725,11 @@ module Wx
     # - {Wx::LIST_NEXT_LEFT}: Searches for an item to the left of the specified item.
     # - {Wx::LIST_NEXT_RIGHT}: Searches for an item to the right of the specified item.
     # 
-    # this parameter is only supported by wxMSW currently and ignored on other platforms.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>this parameter is only supported by WXMSW currently and ignored on other platforms.
+    # </p>
+    # </div>
     # 
     # state can be a bitlist of the following:
     # 
@@ -781,7 +808,7 @@ module Wx
     # - {Wx::LIST_HITTEST_ONITEMSTATEICON}: Over the checkbox of an item.
     # - {Wx::LIST_HITTEST_ONITEM}: Combination of {Wx::LIST_HITTEST_ONITEMICON}, {Wx::LIST_HITTEST_ONITEMLABEL}, {Wx::LIST_HITTEST_ONITEMSTATEICON}.
     # 
-    # If ptrSubItem is not NULL and the {Wx::ListCtrl} is in the report mode the subitem (or column) number will also be provided. This feature is only available in version 2.7.0 or higher and is currently only implemented under wxMSW and requires at least comctl32.dll of version 4.70 on the host system or the value stored in ptrSubItem will be always -1. To compile this feature into wxWidgets library you need to have access to commctrl.h of version 4.70 that is provided by Microsoft.
+    # If ptrSubItem is not NULL and the {Wx::ListCtrl} is in the report mode the subitem (or column) number will also be provided. This feature is only available in version 2.7.0 or higher and is currently only implemented under WXMSW and requires at least comctl32.dll of version 4.70 on the host system or the value stored in ptrSubItem will be always -1. To compile this feature into wxWidgets library you need to have access to commctrl.h of version 4.70 that is provided by Microsoft.
     # @param point [Array(Integer, Integer), Wx::Point] 
     # @return [Array(Integer,Integer)]
     def hit_test(point) end
@@ -859,7 +886,12 @@ module Wx
     
     # Scrolls the list control.
     # If in icon, small icon or report view mode, dx specifies the number of pixels to scroll. If in list view mode, dx specifies the number of columns to scroll. dy always specifies the number of pixels to scroll vertically.
-    # This method is currently only implemented in the Windows version.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This method is currently only implemented in the Windows version. 
+    # </p>
+    # </div>
     # @param dx [Integer] 
     # @param dy [Integer] 
     # @return [Boolean]
@@ -867,7 +899,12 @@ module Wx
     
     # Sets the background colour.
     # Note that the {Wx::Window#get_background_colour} function of {Wx::Window} base class can be used to retrieve the current background colour.
-    # If alternate row colouring is enabled, then call {Wx::ListCtrl#enable_alternate_row_colours} again after changing the background colour. This will update the alternate row color to match the new background colour.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>If alternate row colouring is enabled, then call {Wx::ListCtrl#enable_alternate_row_colours} again after changing the background colour. This will update the alternate row color to match the new background colour. 
+    # </p>
+    # </div>
     # @param col [Wx::Colour,String,Symbol] 
     # @return [Boolean]
     def set_background_colour(col) end
@@ -892,7 +929,7 @@ module Wx
     
     # Change the font and the colours used for the list control header.
     # This method can be used to change the appearance of the header shown by the control in report mode (unless {Wx::LC_NO_HEADER} style is used).
-    # Currently it is implemented only for wxMSW and does nothing in the other ports.
+    # Currently it is implemented only for WXMSW and does nothing in the other ports.
     # 
     # true if the attributes have been updated or false if this is not supported by the current platform.
     # @param attr [Wx::ItemAttr]  The object containing the font and text and background colours to use. It may be default, i.e. not specify any custom font nor colours, to reset any previously set custom attribute.
@@ -1088,9 +1125,14 @@ module Wx
     def extend_rules_and_alternate_colour(extend=true) end
     
     # Show the sort indicator of a specific column in a specific direction.
-    # Sort indicators are only shown in report view and in the native wxMSW version override any column icon, i.e. if the sort indicator is shown for a column, no (other) icon is shown.
+    # Sort indicators are only shown in report view and in the native WXMSW version override any column icon, i.e. if the sort indicator is shown for a column, no (other) icon is shown.
     # This function should typically be called from EVT_LIST_COL_CLICK handler.
-    # This does not actually sort the list, use {Wx::ListCtrl#sort_items} for this.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This does not actually sort the list, use {Wx::ListCtrl#sort_items} for this.
+    # </p>
+    # </div>
     # @param col [Integer]  The column to set the sort indicator for. If <code>-1</code> is given, then the currently shown sort indicator will be removed.
     # @param ascending [Boolean]  If true or false show the sort indicator corresponding to ascending or descending sort order respectively.
     # @return [void]
@@ -1153,7 +1195,12 @@ module Wx
     # This function may be overridden in the derived class for a control with {Wx::LC_VIRTUAL} style.
     # It should return the attribute for the for the specified item and column or NULL to use the default appearance parameters.
     # The base class version returns <code>OnGetItemAttr(item)</code>.
-    # Currently this function is only called under wxMSW, the other ports only support {Wx::ListCtrl#on_get_item_attr}
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Currently this function is only called under WXMSW, the other ports only support {Wx::ListCtrl#on_get_item_attr}
+    # </p>
+    # </div>
     # @see Wx::ListCtrl#on_get_item_attr
     # @see  Wx::ListCtrl#on_get_item_text
     # @see  Wx::ListCtrl#on_get_item_image
@@ -1236,12 +1283,12 @@ module Wx
   # - {Wx::LIST_MASK_FORMAT}: The column format field is valid.
   # 
   # The {Wx::ListItem} object can also contain item-specific colour and font information: for this you need to call one of {Wx::ListItem#set_text_colour}, {Wx::ListItem#set_background_colour} or {Wx::ListItem#set_font} functions on it passing it the colour/font to use. If the colour/font is not specified, the default list control colour/font is used.
-  # === 
   # 
   # Category:  Data Structures
   # @see Wx::ListCtrl 
   # 
   # 
+  # @wxrb_require USE_LISTCTRL
   class ListItem < Object
   
     # Sets client data for the item.
@@ -1413,12 +1460,12 @@ module Wx
   
   # Represents the attributes (colour, font, ...) of an item of a control with multiple items such as e.g.
   # {Wx::ListCtrl}.
-  # === 
   # 
   # Category:  Data Structures
   # @see wxListCtrl Overview
   # 
   # 
+  # @wxrb_require USE_LISTCTRL
   class ItemAttr < ::Object
   
     # @overload initialize()
@@ -1503,21 +1550,21 @@ module Wx
   # This class currently simply presents a simpler to use interface for the {Wx::ListCtrl}  it can be thought of as a façade for that complicated class.
   # Using it is preferable to using {Wx::ListCtrl} directly whenever possible because in the future some ports might implement {Wx::ListView} but not the full set of {Wx::ListCtrl} features.
   # Other than different interface, this class is identical to {Wx::ListCtrl}. In particular, it uses the same events, same window styles and so on.
-  # === 
   # 
-  # 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::ListView#set_column_image 
   # 
   # 
+  # @wxrb_require USE_LISTCTRL
   class ListView < ListCtrl
   
     # @overload initialize()
     #   Default constructor.
     #   @return [Wx::ListView]
-    # @overload initialize(parent, winid=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::LC_REPORT, validator=Wx::DEFAULT_VALIDATOR, name=Wx::ListCtrlNameStr)
+    # @overload initialize(parent, winid=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::LC_REPORT, validator=Wx::DEFAULT_VALIDATOR, name=Wx::LIST_CTRL_NAME_STR)
     #   Constructor, creating and showing a listview control.
     #   
     #   @see Wx::ListView#create

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

@@ -7,7 +7,7 @@
 module Wx
 
   # A list event holds information about events associated with {Wx::ListCtrl} objects.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::ListEvent} events.
   # Event handler methods:
@@ -56,16 +56,15 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_list_item_unchecked}(id, meth = nil, &block): The item has been unchecked (new since wxWidgets 3.1.0). 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::ListCtrl 
   # 
   # 
+  # @wxrb_require USE_LISTCTRL
   class ListEvent < NotifyEvent
   
     # Constructor.
-    # @param commandType [Wx::CommandLinkButton::EventType] 
+    # @param commandType [Wx::Slider::EventType] 
     # @param id [Integer] 
     # @return [Wx::ListEvent]
     def initialize(commandType=Wx::EVT_NULL, id=0) end

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

@@ -35,7 +35,7 @@ module Wx
   # {Wx::Listbook} is a class similar to {Wx::Notebook} but which uses a {Wx::ListCtrl} to show the labels instead of the tabs.
   # The underlying {Wx::ListCtrl} displays page labels in a one-column report view by default. Calling Wx::BookCtrl::SetImageList will implicitly switch the control to use an icon view.
   # 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::Listbook} in action.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -49,7 +49,7 @@ module Wx
   # 
   # - {Wx::LB_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 +58,16 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_listbook_page_changing}(id, meth = nil, &block): The page selection is about to be changed. Processes a {Wx::EVT_LISTBOOK_PAGE_CHANGING} event. This event can be vetoed. 
   # 
-  # === 
-  # 
-  # 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 Wx::BookCtrl
   # @see  Wx::Notebook
   # @see  Notebook Sample 
   # 
   # 
+  # @wxrb_require USE_LISTBOOK
   class Listbook < BookCtrlBase
   
     # @overload initialize()

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

@@ -10,6 +10,7 @@ module Wx
   # 
   # This enum is generated by misc/languages/genlang.py When making changes, please put them into misc/languages/langtabl.txt
   # 
+  # @wxrb_require USE_INTL
   class Language < Wx::Enum
   
     # User's default/preferred language as got from OS.
@@ -3602,6 +3603,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LayoutDirection < Wx::Enum
   
     # 
@@ -3624,6 +3626,7 @@ module Wx
   # @see Wx::LocaleIdent#get_tag 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LocaleTagType < Wx::Enum
   
     # Default (tag as given or else same as {Wx::LocaleTagType::LOCALE_TAGTYPE_SYSTEM})
@@ -3659,6 +3662,7 @@ module Wx
   # @see  Wx::UILocale#get_info 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LocaleCategory < Wx::Enum
   
     # Number formatting.
@@ -3686,6 +3690,7 @@ module Wx
   # @see Wx::UILocale#get_info 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LocaleInfo < Wx::Enum
   
     # The thousands separator.
@@ -3720,6 +3725,7 @@ module Wx
   # @see Wx::UILocale#get_localized_name 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LocaleName < Wx::Enum
   
     # Display name of a locale.
@@ -3742,6 +3748,7 @@ module Wx
   # @see Wx::UILocale#get_localized_name 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LocaleForm < Wx::Enum
   
     # Name should be returned in the language of the locale itself.
@@ -3758,6 +3765,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_INTL
   class LocaleInitFlags < Wx::Enum
   
     # Don't load {Wx::std}.mo catalog.
@@ -3775,13 +3783,16 @@ module Wx
   def self.get_locale; end
   
   # {Wx::Locale} class encapsulates all language-dependent settings and is a generalization of the C locale concept.
-  # This class is known to have several problems under macOS: first of all, it is impossible to change the application UI locale after launching it under this platform and so using this class doesn't affect the native controls and dialogs there. Additionally, versions of macOS between 11.0 and 12.2 inclusive are affected by a bug when changing C locale can break display of the application menus. Because of this, it is recommended to use {Wx::UILocale} instead of this class for the applications targeting macOS.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>This class is known to have several problems under macOS: first of all, it is impossible to change the application UI locale after launching it under this platform and so using this class doesn't affect the native controls and dialogs there. Additionally, versions of macOS between 11.0 and 12.2 inclusive are affected by a bug when changing C locale can break display of the application menus. Because of this, it is recommended to use {Wx::UILocale} instead of this class for the applications targeting macOS.
+  # </p>
+  # </div>
   # 
   # In wxWidgets this class manages current locale. It also initializes and activates {Wx::Translations} object that manages message catalogs.
   # For a list of the supported languages, please see {Wx::Language} enum values. These constants may be used to specify the language in {Wx::Locale#init} and are returned by {Wx::Locale.get_system_language}.
   # 
   #  
-  # === 
   # 
   # Category:  Application and System configuration
   # @see Wx::Internationalization
@@ -3790,6 +3801,7 @@ module Wx
   # @see  Wx::Translations 
   # 
   # 
+  # @wxrb_require USE_INTL
   class Locale < ::Object
   
     # @overload initialize()
@@ -3950,7 +3962,11 @@ module Wx
     def self.get_system_encoding_name; end
     
     # Tries to detect the user's default locale setting.
-    # This function is somewhat misleading, as it uses the default system locale to determine its return value, and not just the system language. It is preserved for backwards compatibility, but to actually get the language, and not locale, used by the system by default, call Wx::UILocale#get_system_language instead.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function is somewhat misleading, as it uses the default system locale to determine its return value, and not just the system language. It is preserved for backwards compatibility, but to actually get the language, and not locale, used by the system by default, call Wx::UILocale#get_system_language instead.
+    # </p>
+    # </div>
     # 
     # Returns the {Wx::Language} value or {Wx::Language::LANGUAGE_UNKNOWN} if the locale is not recognized, as can notably happen when combining any language with a region where this language is not typically spoken.
     # @see Wx::Translations#get_best_translation. 
@@ -3988,8 +4004,33 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_INTL
   class LanguageInfo < ::Object
   
+    # Win32 language identifiers (LANG_xxxx, SUBLANG_xxxx).
+    # Availability:  only available for the WXMSW port.
+    # 
+    # @return [Integer]
+    def win_lang; end
+    # Win32 language identifiers (LANG_xxxx, SUBLANG_xxxx).
+    # Availability:  only available for the WXMSW port.
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def win_lang=(val); end
+    
+    # Win32 language identifiers (LANG_xxxx, SUBLANG_xxxx).
+    # Availability:  only available for the WXMSW port.
+    # 
+    # @return [Integer]
+    def win_sublang; end
+    # Win32 language identifiers (LANG_xxxx, SUBLANG_xxxx).
+    # Availability:  only available for the WXMSW port.
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def win_sublang=(val); end
+    
     # {Wx::Language} id.
     # It should be greater than {Wx::Language::LANGUAGE_USER_DEFINED} when defining your own language info structure.
     # 
@@ -4075,8 +4116,9 @@ module Wx
     def layout_direction=(val); end
     
     # Return the LCID corresponding to this language.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @return [Integer]
+    # @wxrb_require WXMSW
     def get_lcid; end
     alias_method :lcid, :get_lcid