wxruby3 0.9.1-x64-mingw-ucrt → 0.9.2-x64-mingw-ucrt

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

@@ -10,6 +10,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_TOOLBAR
   class ToolBarToolStyle < Wx::Enum
   
     # 
@@ -95,7 +96,7 @@ module Wx
   # There are several different types of tools you can add to a toolbar. These types are controlled by the {Wx::ItemKind} enumeration.
   # Note that many methods in {Wx::ToolBar} such as {Wx::ToolBar#add_tool} return a <code>wxToolBarToolBase*</code> object. This should be regarded as an opaque handle representing the newly added toolbar item, providing access to its id and position within the toolbar. Changes to the item's state should be made through calls to {Wx::ToolBar} methods, for example {Wx::ToolBar#enable_tool}. Calls to {Wx::ToolBarToolBase} methods (undocumented by purpose) will not change the visible state of the item within the tool bar.
   # After you have added all the tools you need, you must call {Wx::ToolBar#realize} to effectively construct and display the toolbar.
-  # <b>wxMSW note</b>: Note that under wxMSW toolbar paints tools to reflect system-wide colours. If you use more than 16 colours in your tool bitmaps, you may wish to suppress this behaviour, otherwise system colours in your bitmaps will inadvertently be mapped to system colours. To do this, set the msw.remap system option before creating the toolbar: 
+  # <b>WXMSW note</b>: Note that under WXMSW toolbar paints tools to reflect system-wide colours. If you use more than 16 colours in your tool bitmaps, you may wish to suppress this behaviour, otherwise system colours in your bitmaps will inadvertently be mapped to system colours. To do this, set the msw.remap system option before creating the toolbar: 
   # ```ruby
   #   Wx::SystemOptions.set_option('msw.remap', 0)
   # ```
@@ -104,7 +105,7 @@ module Wx
   #   Wx::SystemOptions.set_option('msw.remap', 2)
   # ```
   #  Then colour remapping is switched off, and a transparent background used.  
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -136,8 +137,8 @@ module Wx
   # 
   # - {Wx::TB_DEFAULT_STYLE}: The {Wx::TB_HORIZONTAL} style. This style is new since wxWidgets 2.9.5. 
   # 
-  # See also Window Styles. Note that the wxMSW native toolbar ignores {Wx::TB_NOICONS} style. Also, toggling the {Wx::TB_TEXT} works only if the style was initially on.
-  # === Events emitted by this class
+  # See also Window Styles. Note that the WXMSW native toolbar ignores {Wx::TB_NOICONS} style. Also, toggling the {Wx::TB_TEXT} works only if the style was initially on.
+  # ### 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:
@@ -150,28 +151,32 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_menu_range}(id1,  id2, meth = nil, &block): The same as EVT_TOOL_RANGE(). 
   # 
-  # - {Wx::EvtHandler#evt_tool_rclicked}(id, meth = nil, &block): Process a {Wx::EVT_TOOL_RCLICKED} event. Pass the id of the tool. (Not available on wxOSX.) 
+  # - {Wx::EvtHandler#evt_tool_rclicked}(id, meth = nil, &block): Process a {Wx::EVT_TOOL_RCLICKED} event. Pass the id of the tool. (Not available on WXOSX.) 
   # 
-  # - {Wx::EvtHandler#evt_tool_rclicked_range}(id1,  id2, meth = nil, &block): Process a {Wx::EVT_TOOL_RCLICKED} event for a range of ids. Pass the ids of the tools. (Not available on wxOSX.) 
+  # - {Wx::EvtHandler#evt_tool_rclicked_range}(id1,  id2, meth = nil, &block): Process a {Wx::EVT_TOOL_RCLICKED} event for a range of ids. Pass the ids of the tools. (Not available on WXOSX.) 
   # 
-  # - {Wx::EvtHandler#evt_tool_enter}(id, meth = nil, &block): Process a {Wx::EVT_TOOL_ENTER} event. Pass the id of the toolbar itself. The value of {Wx::CommandEvent#get_selection} is the tool id, or -1 if the mouse cursor has moved off a tool. (Not available on wxOSX.) 
+  # - {Wx::EvtHandler#evt_tool_enter}(id, meth = nil, &block): Process a {Wx::EVT_TOOL_ENTER} event. Pass the id of the toolbar itself. The value of {Wx::CommandEvent#get_selection} is the tool id, or -1 if the mouse cursor has moved off a tool. (Not available on WXOSX.) 
   # 
   # - {Wx::EvtHandler#evt_tool_dropdown}(id, meth = nil, &block): Process a {Wx::EVT_TOOL_DROPDOWN} event. If unhandled, displays the default dropdown menu set using {Wx::ToolBar#set_dropdown_menu}. 
   # 
   # The toolbar class emits menu commands in the same way that a frame menubar does, so you can use one EVT_MENU() macro for both a menu item and a toolbar button. The event handler functions take a {Wx::CommandEvent} argument. For most event macros, the identifier of the tool is passed, but for EVT_TOOL_ENTER() the toolbar window identifier is passed and the tool identifier is retrieved from the {Wx::CommandEvent}. This is because the identifier may be {Wx::StandardID::ID_ANY} when the mouse moves off a tool, and {Wx::StandardID::ID_ANY} is not allowed as an identifier in the event system.
-  # === 
   # 
   # Category:  Miscellaneous Windows
   # @see Toolbar Overview 
   # 
   # 
+  # @wxrb_require USE_TOOLBAR
   class ToolBar < Control
   
     # @overload add_tool(toolId, label, bitmap, shortHelp=(''), kind=Wx::ItemKind::ITEM_NORMAL)
     #   Adds a tool to the toolbar.
     #   This most commonly used version has fewer parameters than the full version below which specifies the more rarely used button features.
     #   
-    #   After you have added tools to a toolbar, you must call {Wx::ToolBar#realize} in order to have the tools appear.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>After you have added tools to a toolbar, you must call {Wx::ToolBar#realize} in order to have the tools appear.
+    #   </p>
+    #   </div>>
     #   @see Wx::ToolBar#add_separator
     #   @see  Wx::ToolBar#add_check_tool
     #   @see  Wx::ToolBar#add_radio_tool
@@ -187,7 +192,11 @@ module Wx
     #   @return [Wx::ToolBarToolBase]
     # @overload add_tool(toolId, label, bitmap, bmpDisabled, kind=Wx::ItemKind::ITEM_NORMAL, shortHelp=(''), longHelp=(''), clientData=nil)
     #   Adds a tool to the toolbar.
-    #   After you have added tools to a toolbar, you must call {Wx::ToolBar#realize} in order to have the tools appear.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>After you have added tools to a toolbar, you must call {Wx::ToolBar#realize} in order to have the tools appear.
+    #   </p>
+    #   </div>>
     #   @see Wx::ToolBar#add_separator
     #   @see  Wx::ToolBar#add_check_tool
     #   @see  Wx::ToolBar#add_radio_tool
@@ -227,14 +236,22 @@ module Wx
     
     # @overload set_margins(x, y)
     #   Set the values to be used as margins for the toolbar.
-    #   This must be called before the tools are added if absolute positioning is to be used, and the default (zero-size) margins are to be overridden.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>This must be called before the tools are added if absolute positioning is to be used, and the default (zero-size) margins are to be overridden.
+    #   </p>
+    #   </div>>
     #   @see Wx::ToolBar#get_margins 
     #   @param x [Integer]  Left margin, right margin and inter-tool separation value.
     #   @param y [Integer]  Top margin, bottom margin and inter-tool separation value.
     #   @return [void]
     # @overload set_margins(size)
     #   Set the margins for the toolbar.
-    #   This must be called before the tools are added if absolute positioning is to be used, and the default (zero-size) margins are to be overridden.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>This must be called before the tools are added if absolute positioning is to be used, and the default (zero-size) margins are to be overridden.
+    #   </p>
+    #   </div>>
     #   @see Wx::ToolBar#get_margins
     #   @see  Wx::Size 
     #   @param size [Array(Integer, Integer), Wx::Size]  Margin size.
@@ -247,7 +264,11 @@ module Wx
     #   @return [Wx::ToolBar]
     # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::TB_HORIZONTAL, name=Wx::TOOL_BAR_NAME_STR)
     #   Constructs a toolbar.
-    #   After a toolbar is created, you use {Wx::ToolBar#add_tool} and perhaps {Wx::ToolBar#add_separator}, and then you must call {Wx::ToolBar#realize} to construct and display the toolbar tools.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>After a toolbar is created, you use {Wx::ToolBar#add_tool} and perhaps {Wx::ToolBar#add_separator}, and then you must call {Wx::ToolBar#realize} to construct and display the toolbar tools. 
+    #   </p>
+    #   </div>>
     #   @param parent [Wx::Window]  Pointer to a parent window.
     #   @param id [Integer]  Window identifier. If -1, will automatically create an identifier.
     #   @param pos [Array(Integer, Integer), Wx::Point]  Window position. {Wx::DEFAULT_POSITION} indicates that wxWidgets should generate a default position for the window. If using the {Wx::Window} class directly, supply an actual position.
@@ -271,7 +292,11 @@ module Wx
     def add_check_tool(toolId, label, bitmap1, bmpDisabled=Wx::NULL_BITMAP, shortHelp=(''), longHelp=(''), clientData=nil) end
     
     # Adds any control to the toolbar, typically e.g. a {Wx::ComboBox}.
-    # wxMac: labels are only displayed if wxWidgets is built with {Wx::MAC_USE_NATIVE_TOOLBAR} set to 1
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>WXOSX: labels are only displayed if wxWidgets is built with {Wx::MAC_USE_NATIVE_TOOLBAR} set to 1 
+    # </p>
+    # </div>>
     # @param control [Wx::Control]  The control to be added.
     # @param label [String]  Text to be displayed near the control.
     # @return [Wx::ToolBarToolBase]
@@ -313,7 +338,12 @@ module Wx
     
     # Removes the specified tool from the toolbar and deletes it.
     # If you don't want to delete the tool, but just to remove it from the toolbar (to possibly add it back later), you may use {Wx::ToolBar#remove_tool} instead.
-    # It is unnecessary to call {Wx::ToolBar#realize} for the change to take place, it will happen immediately.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>It is unnecessary to call {Wx::ToolBar#realize} for the change to take place, it will happen immediately.
+    # </p>
+    # </div>
     # 
     # true if the tool was deleted, false otherwise.
     # @see Wx::ToolBar#delete_tool_by_pos 
@@ -327,7 +357,11 @@ module Wx
     def delete_tool_by_pos(pos) end
     
     # Enables or disables the tool.
-    # Some implementations will change the visible state of the tool to indicate that it is disabled.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Some implementations will change the visible state of the tool to indicate that it is disabled.
+    # </p>
+    # </div>>
     # @see Wx::ToolBar#get_tool_enabled
     # @see  Wx::ToolBar#toggle_tool 
     # @param toolId [Integer]  ID of the tool to enable or disable, as passed to {Wx::ToolBar#add_tool}.
@@ -348,7 +382,11 @@ module Wx
     # Finds a tool for the given mouse position.
     # A pointer to a tool if a tool is found, or NULL otherwise.
     # 
-    # Currently not implemented in wxGTK (always returns NULL there).
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Currently not implemented in WXGTK (always returns NULL there). 
+    # </p>
+    # </div>>
     # @param x [Integer]  X position.
     # @param y [Integer]  Y position.
     # @return [Wx::ToolBarToolBase]
@@ -364,7 +402,12 @@ module Wx
     # Returns the size of bitmap that the toolbar expects to have.
     # The default bitmap size is platform-dependent: for example, it is 16*15 for MSW and 24*24 for GTK. This size does not necessarily indicate the best size to use for the toolbars on the given platform, for this you should use <code>wxArtProvider::GetNativeSizeHint(wxART_TOOLBAR)</code> but in any case, as the bitmap size is deduced automatically from the size of the bitmaps associated with the tools added to the toolbar, it is usually unnecessary to call either this function or {Wx::ToolBar#set_tool_bitmap_size} at all.
     # This function returns the size in logical pixels, for consistency with {Wx::ToolBar#set_tool_bitmap_size} which takes size in logical pixels. See High DPI Support in wxWidgets for more information about the different pixel types and how to convert between them.
-    # Note that this is the size of the bitmap you pass to {Wx::ToolBar#add_tool}, and not the eventual size of the tool button.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Note that this is the size of the bitmap you pass to {Wx::ToolBar#add_tool}, and not the eventual size of the tool button.
+    # </p>
+    # </div>>
     # @see Wx::ToolBar#set_tool_bitmap_size
     # @see  Wx::ToolBar#get_tool_size 
     # @return [Wx::Size]
@@ -490,7 +533,11 @@ module Wx
     # This is called when the mouse cursor moves into a tool or out of the toolbar.
     # This is the old way of detecting mouse enter events; although it will still work, you should use the EVT_TOOL_ENTER() macro instead.
     # 
-    # With some derived toolbar classes, if the mouse moves quickly out of the toolbar, wxWidgets may not be able to detect it. Therefore this function may not always be called when expected.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>With some derived toolbar classes, if the mouse moves quickly out of the toolbar, wxWidgets may not be able to detect it. Therefore this function may not always be called when expected. 
+    # </p>
+    # </div>>
     # @param toolId [Integer]  Greater than -1 if the mouse cursor has moved into the tool, or -1 if the mouse cursor has moved. The programmer can override this to provide extra information about the tool, such as a short description on the status line.
     # @return [void]
     def on_mouse_enter(toolId) end
@@ -501,7 +548,12 @@ module Wx
     
     # Removes the given tool from the toolbar but doesn't delete it.
     # This allows inserting/adding this tool back to this (or another) toolbar later.
-    # It is unnecessary to call {Wx::ToolBar#realize} for the change to take place, it will happen immediately.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>It is unnecessary to call {Wx::ToolBar#realize} for the change to take place, it will happen immediately.
+    # </p>
+    # </div>
     # @see Wx::ToolBar#delete_tool 
     # @param id [Integer] 
     # @return [Wx::ToolBarToolBase]
@@ -541,14 +593,22 @@ module Wx
     # Sets the bitmap to be used by the tool with the given ID when the tool is in a disabled state.
     # This can only be used on Button tools, not controls.
     # 
-    # The native toolbar classes on the main platforms all synthesize the disabled bitmap from the normal bitmap, so this function will have no effect on those platforms.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>The native toolbar classes on the main platforms all synthesize the disabled bitmap from the normal bitmap, so this function will have no effect on those platforms. 
+    # </p>
+    # </div>
     # @param id [Integer]  ID of the tool in question, as passed to {Wx::ToolBar#add_tool}.
     # @param bitmap [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image]  Bitmap to use for disabled tools.
     # @return [void]
     def set_tool_disabled_bitmap(id, bitmap) end
     
     # Sets the long help for the given tool.
-    # You might use the long help for displaying the tool purpose on the status line.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>You might use the long help for displaying the tool purpose on the status line.
+    # </p>
+    # </div>>
     # @see Wx::ToolBar#get_tool_long_help
     # @see  Wx::ToolBar#set_tool_short_help
     # @see  
@@ -567,7 +627,11 @@ module Wx
     # Sets the value used for spacing tools.
     # The default value is 1.
     # 
-    # The packing is used for spacing in the vertical direction if the toolbar is horizontal, and for spacing in the horizontal direction if the toolbar is vertical.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The packing is used for spacing in the vertical direction if the toolbar is horizontal, and for spacing in the horizontal direction if the toolbar is vertical.
+    # </p>
+    # </div>>
     # @see Wx::ToolBar#get_tool_packing 
     # @param packing [Integer]  The value for packing.
     # @return [void]
@@ -583,7 +647,11 @@ module Wx
     alias_method :tool_separation=, :set_tool_separation
     
     # Sets the short help for the given tool.
-    # An application might use short help for identifying the tool purpose in a tooltip.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>An application might use short help for identifying the tool purpose in a tooltip.
+    # </p>
+    # </div>>
     # @see Wx::ToolBar#get_tool_short_help
     # @see  Wx::ToolBar#set_tool_long_help 
     # @param toolId [Integer]  ID of the tool in question, as passed to {Wx::ToolBar#add_tool}.
@@ -594,7 +662,11 @@ module Wx
     # Toggles a tool on or off.
     # This does not cause any event to get emitted.
     # 
-    # Only applies to a tool that has been specified as a toggle tool.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Only applies to a tool that has been specified as a toggle tool. 
+    # </p>
+    # </div>>
     # @param toolId [Integer]  ID of the tool in question, as passed to {Wx::ToolBar#add_tool}.
     # @param toggle [Boolean]  If true, toggles the tool on, otherwise toggles it off.
     # @return [void]
@@ -628,6 +700,7 @@ module Wx
   # It has a unique id (except for the separators), the style (telling whether it is a normal button, separator or a control), the state (toggled or not, enabled or not) and short and long help strings. The default implementations use the short help string for the tooltip text which is popped up when the mouse pointer enters the tool and the long help string for the applications status bar.
   # Notice that the toolbar can not be modified by changing its tools via the (intentionally undocumented here) setter methods of this class, all the modifications must be done using the methods of {Wx::ToolBar} itself.
   # 
+  # @wxrb_require USE_TOOLBAR
   class ToolBarToolBase < Object
   
     # @overload initialize(tbar=nil, toolid=Wx::StandardID::ID_SEPARATOR, label=(''), bmpNormal=Wx::NULL_BITMAP, bmpDisabled=Wx::NULL_BITMAP, kind=Wx::ItemKind::ITEM_NORMAL, clientData=nil, shortHelpString=(''), longHelpString=(''))

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

@@ -8,10 +8,10 @@ module Wx
 
   # This class holds information about a tooltip associated with a window (see {Wx::Window#set_tool_tip}).
   # The four static methods, {Wx::ToolTip.enable}, {Wx::ToolTip.set_delay} {Wx::ToolTip.set_auto_pop} and {Wx::ToolTip.set_reshow} can be used to globally alter tooltips behaviour.
-  # === 
   # 
   # Category:  {Wx::HELP}
   # 
+  # @wxrb_require USE_TOOLTIPS
   class ToolTip < Object
   
     # Constructor.
@@ -36,25 +36,55 @@ module Wx
     alias_method :tip=, :set_tip
     
     # Enable or disable tooltips globally.
-    # May not be supported on all platforms (eg. {Wx::Cocoa}).
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>May not be supported on all platforms (eg. {Wx::Cocoa}). 
+    # </p>
+    # </div>
     # @param flag [Boolean] 
     # @return [void]
     def self.enable(flag) end
     
     # Set the delay after which the tooltip disappears or how long a tooltip remains visible.
-    # May not be supported on all platforms (eg. {Wx::Cocoa}, GTK).
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>May not be supported on all platforms (eg. {Wx::Cocoa}, GTK). 
+    # </p>
+    # </div>
     # @param msecs [Integer] 
     # @return [void]
     def self.set_auto_pop(msecs) end
     
     # Set the delay after which the tooltip appears.
-    # May not be supported on all platforms.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>May not be supported on all platforms. 
+    # </p>
+    # </div>
     # @param msecs [Integer] 
     # @return [void]
     def self.set_delay(msecs) end
     
+    # Set tooltip maximal width in pixels.
+    # By default, tooltips are wrapped at a suitably chosen width. You can pass -1 as width to disable wrapping them completely, 0 to restore the default behaviour or an arbitrary positive value to wrap them at the given width.
+    # Notice that this function does not change the width of the tooltips created before calling it.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Currently this function is WXMSW-only. 
+    # </p>
+    # </div>
+    # @param width [Integer] 
+    # @return [void]
+    # @wxrb_require WXMSW
+    def self.set_max_width(width) end
+    
     # Set the delay between subsequent tooltips to appear.
-    # May not be supported on all platforms (eg. {Wx::Cocoa}, GTK).
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>May not be supported on all platforms (eg. {Wx::Cocoa}, GTK). 
+    # </p>
+    # </div>
     # @param msecs [Integer] 
     # @return [void]
     def self.set_reshow(msecs) end

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

@@ -23,7 +23,7 @@ module Wx
   # {Wx::Toolbook} is a class similar to {Wx::Notebook} but which uses a {Wx::ToolBar} to show the labels instead of the tabs.
   # There is no documentation for this class yet but its usage is identical to {Wx::Notebook} (except for the features clearly related to tabs only), so please refer to that class documentation for now. You can also use the Notebook Sample to see {Wx::Toolbook} in action.
   # One feature of this class not supported by {Wx::BookCtrlBase} is the support for disabling some of the pages, see {Wx::Toolbook#enable_page}.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -32,7 +32,7 @@ module Wx
   # - {Wx::TBK_HORZ_LAYOUT}: Shows the text and the icons alongside, not vertically stacked (only implement under Windows and GTK 2 platforms as it relies on {Wx::TB_HORZ_LAYOUT} flag support). 
   # 
   # The common {Wx::BookCtrl} styles described in the wxBookCtrl Overview are also supported.
-  # === 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:
@@ -41,8 +41,6 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_toolbook_page_changing}(id, meth = nil, &block): The page selection is about to be changed. Processes a {Wx::EVT_TOOLBOOK_PAGE_CHANGING} event. This event can be vetoed (using {Wx::NotifyEvent#veto}). 
   # 
-  # === 
-  # 
   # Category:  Book Controls
   # @see wxBookCtrl Overview
   # @see  Wx::BookCtrlBase
@@ -50,6 +48,7 @@ module Wx
   # @see  Notebook Sample 
   # 
   # 
+  # @wxrb_require USE_TOOLBOOK
   class Toolbook < BookCtrlBase
   
     # @overload initialize()

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

@@ -60,7 +60,7 @@ module Wx
   # {Wx::TopLevelWindow} is a common base class for {Wx::Dialog} and {Wx::Frame}.
   # It is an abstract base class meaning that you never work with objects of this class directly, but all of its methods are also applicable for the two classes above.
   # Note that the instances of {Wx::TopLevelWindow} are managed by wxWidgets in the internal top level window list.
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # Event handler methods for events emitted by this class:
   # 
@@ -68,16 +68,14 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_move}(meth = nil, &block): Process a {Wx::EVT_MOVE} event, which is generated when a window is moved. See {Wx::MoveEvent}. 
   # 
-  # - {Wx::EvtHandler#evt_move_start}(meth = nil, &block): Process a {Wx::EVT_MOVE_START} event, which is generated when the user starts to move or size a window. wxMSW only. See {Wx::MoveEvent}. 
+  # - {Wx::EvtHandler#evt_move_start}(meth = nil, &block): Process a {Wx::EVT_MOVE_START} event, which is generated when the user starts to move or size a window. WXMSW only. See {Wx::MoveEvent}. 
   # 
-  # - {Wx::EvtHandler#evt_move_end}(meth = nil, &block): Process a {Wx::EVT_MOVE_END} event, which is generated when the user stops moving or sizing a window. wxMSW only. See {Wx::MoveEvent}. 
+  # - {Wx::EvtHandler#evt_move_end}(meth = nil, &block): Process a {Wx::EVT_MOVE_END} event, which is generated when the user stops moving or sizing a window. WXMSW only. See {Wx::MoveEvent}. 
   # 
   # - {Wx::EvtHandler#evt_show}(meth = nil, &block): Process a {Wx::EVT_SHOW} event. See {Wx::ShowEvent}. 
   # 
   # - {Wx::EvtHandler#EVT_FULLSCREEN}(meth = nil, &block): Process a {Wx::EVT_FULLSCREEN} event. See {Wx::FullScreenEvent}. 
   # 
-  # === 
-  # 
   # Category:  Managed Windows
   # @see Wx::Dialog
   # @see  Wx::Frame 
@@ -137,7 +135,7 @@ module Wx
     def enable_close_button(enable=true) end
     
     # Enables or disables the Maximize button (in the right or left upper corner of a frame or dialog).
-    # Currently only implemented for wxMSW and wxOSX.
+    # Currently only implemented for WXMSW and WXOSX.
     # The window style must contain {Wx::MAXIMIZE_BOX}.
     # Returns true if operation was successful. Note that a successful operation does not change the window style flags.
     # @param enable [Boolean] 
@@ -145,9 +143,9 @@ module Wx
     def enable_maximize_button(enable=true) end
     
     # Enables or disables the Minimize button (in the right or left upper corner of a frame or dialog).
-    # Currently only implemented for wxMSW and wxOSX.
+    # Currently only implemented for WXMSW and WXOSX.
     # The window style must contain {Wx::MINIMIZE_BOX}.
-    # Note that in wxMSW a successful operation will change the window style flags.
+    # Note that in WXMSW a successful operation will change the window style flags.
     # Returns true if operation was successful. Note that a successful operation does not change the window style flags.
     # @param enable [Boolean] 
     # @return [Boolean]
@@ -181,7 +179,7 @@ module Wx
     alias_method :title, :get_title
     
     # Iconizes or restores the window.
-    # Note that in wxGTK the change to the window state is not immediate, i.e. {Wx::TopLevelWindow#is_iconized} will typically return false right after a call to {Wx::TopLevelWindow#iconize} and its return value will only change after the control flow returns to the event loop and the notification about the window being really iconized is received.
+    # Note that in WXGTK the change to the window state is not immediate, i.e. {Wx::TopLevelWindow#is_iconized} will typically return false right after a call to {Wx::TopLevelWindow#iconize} and its return value will only change after the control flow returns to the event loop and the notification about the window being really iconized is received.
     # @see Wx::TopLevelWindow#is_iconized
     # @see  Wx::TopLevelWindow#restore
     # @see  Wx::IconizeEvent. 
@@ -224,24 +222,42 @@ module Wx
     def layout; end
     
     # Maximizes or restores the window.
-    # Note that, just as with {Wx::TopLevelWindow#iconize}, the change to the window state is not immediate in at least wxGTK port.
+    # Note that, just as with {Wx::TopLevelWindow#iconize}, the change to the window state is not immediate in at least WXGTK port.
     # @see Wx::TopLevelWindow#restore
     # @see  Wx::TopLevelWindow#iconize 
     # @param maximize [Boolean]  If true, maximizes the window, otherwise it restores it.
     # @return [void]
     def maximize(maximize=true) end
     
+    # MSW-specific function for accessing the system menu.
+    # Returns a {Wx::Menu} pointer representing the system menu of the window under MSW. The returned {Wx::Menu} may be used, if non-NULL, to add extra items to the system menu. The usual {Wx::EVT_MENU} events (that can be processed using EVT_MENU event table macro) will then be generated for them. All the other {Wx::Menu} methods may be used as well but notice that they won't allow you to access any standard system menu items (e.g. they can't be deleted or modified in any way currently).
+    # Notice that because of the native system limitations the identifiers of the items added to the system menu must be multiples of 16, otherwise no events will be generated for them.
+    # The returned pointer must not be deleted, it is owned by the window and will be only deleted when the window itself is destroyed.
+    # This function is not available in the other ports by design, any occurrences of it in the portable code must be guarded by 
+    # ```ruby
+    #   if Wx::PLATFORM == 'WXMSW'
+    # ```
+    #  preprocessor guards.
+    # @return [Wx::Menu]
+    # @wxrb_require WXMSW
+    def msw_get_system_menu; end
+    
     # Use a system-dependent way to attract users attention to the window when it is in background.
     # flags may have the value of either {Wx::USER_ATTENTION_INFO} (default) or {Wx::USER_ATTENTION_ERROR} which results in a more drastic action. When in doubt, use the default value.
-    # This function should normally be only used when the application is not already in foreground.
     # 
-    # This function is currently implemented for Win32 where it flashes the window icon in the taskbar, and for wxGTK with task bars supporting it.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function should normally be only used when the application is not already in foreground.
+    # </p>
+    # </div>
+    # 
+    # This function is currently implemented for Win32 where it flashes the window icon in the taskbar, and for WXGTK with task bars supporting it.
     # @param flags [Integer] 
     # @return [void]
     def request_user_attention(flags=Wx::USER_ATTENTION_INFO) end
     
     # Restore a previously iconized or maximized window to its normal state.
-    # In wxGTK this method currently doesn't return the maximized window to its normal state and you must use {Wx::TopLevelWindow#maximize} with false argument explicitly for this. In the other ports, it both unmaximizes the maximized windows and uniconizes the iconized ones.
+    # In WXGTK this method currently doesn't return the maximized window to its normal state and you must use {Wx::TopLevelWindow#maximize} with false argument explicitly for this. In the other ports, it both unmaximizes the maximized windows and uniconizes the iconized ones.
     # @see Wx::TopLevelWindow#iconize
     # @see  Wx::TopLevelWindow#maximize 
     # @return [void]
@@ -265,9 +281,17 @@ module Wx
     alias_method :tmp_default_item, :get_tmp_default_item
     
     # Sets the icon for this window.
-    # The window takes a 'copy' of icon, but since it uses reference counting, the copy is very quick. It is safe to delete icon after calling this function.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The window takes a 'copy' of icon, but since it uses reference counting, the copy is very quick. It is safe to delete icon after calling this function.
+    # </p>
+    # </div>>
     # 
-    # In wxMSW, icon must be either 16x16 or 32x32 icon.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In WXMSW, icon must be either 16x16 or 32x32 icon.
+    # </p>
+    # </div>
     # @see Wx::Icon
     # @see  Wx::TopLevelWindow#set_icons 
     # @param icon [Wx::Icon]  The {Wx::Icon} to associate with this window.
@@ -278,7 +302,11 @@ module Wx
     # Sets several icons of different sizes for this window: this allows using different icons for different situations (e.g.
     # task switching bar, taskbar, window title bar) instead of scaling, with possibly bad looking results, the only icon set by {Wx::TopLevelWindow#set_icon}.
     # 
-    # In wxMSW, icons must contain a 16x16 or 32x32 icon, preferably both.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In WXMSW, icons must contain a 16x16 or 32x32 icon, preferably both.
+    # </p>
+    # </div>
     # @see Wx::IconBundle 
     # @param icons [Wx::IconBundle]  The icons to associate with this window.
     # @return [void]
@@ -301,7 +329,11 @@ module Wx
     #   Allows specification of minimum and maximum window sizes, and window size increments.
     #   If a pair of values is not set (or set to -1), no constraints will be used.
     #   
-    #   Notice that this function not only prevents the user from resizing the window outside the given bounds but it also prevents the program itself from doing it using {Wx::Window#set_size}.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>Notice that this function not only prevents the user from resizing the window outside the given bounds but it also prevents the program itself from doing it using {Wx::Window#set_size}. 
+    #   </p>
+    #   </div>>
     #   @param minW [Integer]  The minimum width.
     #   @param minH [Integer]  The minimum height.
     #   @param maxW [Integer]  The maximum width.
@@ -313,10 +345,14 @@ module Wx
     #   Allows specification of minimum and maximum window sizes, and window size increments.
     #   If a pair of values is not set (or set to -1), no constraints will be used.
     #   
-    #   Notice that this function not only prevents the user from resizing the window outside the given bounds but it also prevents the program itself from doing it using {Wx::Window#set_size}.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>Notice that this function not only prevents the user from resizing the window outside the given bounds but it also prevents the program itself from doing it using {Wx::Window#set_size}. 
+    #   </p>
+    #   </div>>
     #   @param minSize [Array(Integer, Integer), Wx::Size]  The minimum size of the window.
     #   @param maxSize [Array(Integer, Integer), Wx::Size]  The maximum size of the window.
-    #   @param incSize [Array(Integer, Integer), Wx::Size]  Increment size (only taken into account under X11-based ports such as wxGTK/{Wx::Motif}/wxX11).
+    #   @param incSize [Array(Integer, Integer), Wx::Size]  Increment size (only taken into account under X11-based ports such as WXGTK/{Wx::Motif}/WXX11).
     #   @return [void]
     def set_size_hints(*args) end
     alias_method :size_hints=, :set_size_hints
@@ -330,7 +366,7 @@ module Wx
     alias_method :title=, :set_title
     
     # If the platform supports it will set the window to be translucent.
-    # Note that in wxGTK this function must be called before the window is shown the first time it's called (but it can be called again after showing the window too).
+    # Note that in WXGTK this function must be called before the window is shown the first time it's called (but it can be called again after showing the window too).
     # See the shaped sample for an example of using this function.
     # @param alpha [Integer]  Determines how opaque or transparent the window will be, if the platform supports the operation. A value of 0 sets the window to be fully transparent, and a value of 255 sets the window to be fully opaque.
     # @return [Boolean]
@@ -365,7 +401,12 @@ module Wx
     # - {Wx::FULLSCREEN_ALL} (all of the above)
     # 
     # This function has not been tested with MDI frames.
-    # Showing a window full screen also actually {Wx::TopLevelWindow#show}s the window if it isn't shown.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Showing a window full screen also actually {Wx::TopLevelWindow#show}s the window if it isn't shown.
+    # </p>
+    # </div>
     # @see Wx::TopLevelWindow#enable_full_screen_view
     # @see  Wx::TopLevelWindow#is_full_screen 
     # @param show [Boolean] 
@@ -385,12 +426,17 @@ module Wx
     # Obviously this can't provide absolute security as there might be workarounds and tools that bypass this protection. Additionally a screen could always be photographed.
     # true if the content protection was changed, false if running under an unsupported OS.
     # 
-    # Windows 7 or newer is required but any macOS version is supported.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Windows 7 or newer is required but any macOS version is supported.
+    # </p>
+    # </div>
     # 
-    # Availability:  only available for the wxMSW, wxOSX/Cocoa ports.  {Wx::msw},{Wx::osx}
+    # Availability:  only available for the WXMSW, WXOSX/Cocoa ports.
     # @see Wx::TopLevelWindow#get_content_protection
     # @param contentProtection [Wx::ContentProtection] 
     # @return [Boolean]
+    # @wxrb_require WXMSW|WXOSX
     def set_content_protection(contentProtection) end
     alias_method :content_protection=, :set_content_protection