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

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

@@ -9,23 +9,27 @@ module Wx
   # A menu is a popup (or pull down) list of items, one of which may be selected before the menu goes away (clicking elsewhere dismisses the menu).
   # Menus may be used to construct either menu bars or popup menus.
   # A menu item has an integer ID associated with it which can be used to identify the selection, or to change the menu item in some way. A menu item with a special identifier {Wx::StandardID::ID_SEPARATOR} is a separator item and doesn't have an associated command but just makes a separator line appear in the menu.
-  # Please note that {Wx::StandardID::ID_ABOUT} and {Wx::StandardID::ID_EXIT} are predefined by wxWidgets and have a special meaning since entries using these IDs will be taken out of the normal menus under macOS and will be inserted into the system menu (following the appropriate macOS interface guideline).
+  # 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Please note that {Wx::StandardID::ID_ABOUT} and {Wx::StandardID::ID_EXIT} are predefined by wxWidgets and have a special meaning since entries using these IDs will be taken out of the normal menus under macOS and will be inserted into the system menu (following the appropriate macOS interface guideline).
+  # </p>
+  # </div>
   # 
   # Menu items may be either normal items, check items or radio items. Normal items don't have any special properties while the check items have a boolean flag associated to them and they show a checkmark in the menu when the flag is set. wxWidgets automatically toggles the flag value when the item is clicked and its value may be retrieved using either {Wx::Menu#is_checked} method of {Wx::Menu} or {Wx::MenuBar} itself or by using {Wx::Event::IsChecked} when you get the menu notification for the item in question.
   # The radio items are similar to the check items except that all the other items in the same radio group are unchecked when a radio item is checked. The radio group is formed by a contiguous range of radio items, i.e. it starts at the first item of this kind and ends with the first item of a different kind (or the end of the menu). Notice that because the radio groups are defined in terms of the item positions inserting or removing the items in the menu containing the radio items risks to not work correctly.
   # 
-  # == Allocation strategy
+  # ## Allocation strategy
   # 
   # All menus must be created on the <b>heap</b> because all menus attached to a menubar or to another menu will be deleted by their parent when it is deleted. The only exception to this rule are the popup menus (i.e. menus used with {Wx::Window#popup_menu}) as wxWidgets does not destroy them to allow reusing the same menu more than once. But the exception applies only to the menus themselves and not to any submenus of popup menus which are still destroyed by wxWidgets as usual and so must be heap-allocated.
   # As the frame menubar is deleted by the frame itself, it means that normally all menus used are deleted automatically.
   # 
-  # == Event handling
+  # ## Event handling
   # 
   # Event handlers for the commands generated by the menu items can be connected directly to the menu object itself using {Wx::EvtHandler#bind}. If this menu is a submenu of another one, the events from its items can also be processed in the parent menu and so on, recursively.
   # If the menu is part of a menu bar, then events can also be handled in {Wx::MenuBar} object.
   # Finally, menu events can also be handled in the associated window, which is either the {Wx::Frame} associated with the menu bar this menu belongs to or the window for which {Wx::Window#popup_menu} was called for the popup menus.
   # See Dynamic Event Handling for how to bind event handlers to the various objects.
-  # === 
   # 
   # Category:  {Wx::Menus}
   # @see Wx::MenuBar
@@ -34,6 +38,7 @@ module Wx
   # @see  wxFileHistory (most recently used files menu) 
   # 
   # 
+  # @wxrb_require USE_MENUS
   class Menu < EvtHandler
   
     # Returns the list of items in the menu.
@@ -48,7 +53,7 @@ module Wx
     # @overload initialize(title, style=0)
     #   Constructs a {Wx::Menu} object with a title.
     #   @param title [String]  Title at the top of the menu (not always supported).
-    #   @param style [Integer]  If set to {Wx::MENU_TEAROFF}, the menu will be detachable (wxGTK and {Wx::QT} only).
+    #   @param style [Integer]  If set to {Wx::MENU_TEAROFF}, the menu will be detachable (WXGTK and {Wx::QT} only).
     #   @return [Wx::Menu]
     def initialize(*args) end
     
@@ -63,7 +68,11 @@ module Wx
     #     file_menu.append(Wx::ID_NEW, "", "Creates a new XYZ document")
     #   ```
     #   
-    #   This command can be used after the menu has been shown, as well as on initial creation of a menu or menubar.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>This command can be used after the menu has been shown, as well as on initial creation of a menu or menubar.
+    #   </p>
+    #   </div>>
     #   @see Wx::Menu#append_separator
     #   @see  Wx::Menu#append_check_item
     #   @see  Wx::Menu#append_radio_item
@@ -82,7 +91,11 @@ module Wx
     #   Adds a menu item object.
     #   This is the most generic variant of {Wx::Menu#append} method because it may be used for both items (including separators) and submenus and because you can also specify various extra properties of a menu item this way, such as bitmaps and fonts.
     #   
-    #   See the remarks for the other {Wx::Menu#append} overloads.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>See the remarks for the other {Wx::Menu#append} overloads.
+    #   </p>
+    #   </div>>
     #   @see Wx::Menu#append_separator
     #   @see  Wx::Menu#append_check_item
     #   @see  Wx::Menu#append_radio_item
@@ -108,7 +121,12 @@ module Wx
     
     # Adds a radio item to the end of the menu.
     # All consequent radio items form a group and when an item in the group is checked, all the others are automatically unchecked.
-    # Radio items are not supported under {Wx::Motif}.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Radio items are not supported under {Wx::Motif}.
+    # </p>
+    # </div>
     # @see Wx::Menu#append
     # @see  Wx::Menu#insert_radio_item 
     # @param id [Integer] 
@@ -135,7 +153,7 @@ module Wx
     def append_sub_menu(submenu, text, help=('')) end
     
     # Inserts a break in a menu, causing the next appended item to appear in a new column.
-    # This function only actually inserts a break in wxMSW and does nothing under the other platforms.
+    # This function only actually inserts a break in WXMSW and does nothing under the other platforms.
     # @return [void]
     def break_; end
     
@@ -203,7 +221,11 @@ module Wx
     #   Finds the menu id for a menu item string.
     #   Menu item identifier, or {Wx::NOT_FOUND} if none is found.
     #   
-    #   Any special menu codes are stripped out of source and target strings before matching.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>Any special menu codes are stripped out of source and target strings before matching. 
+    #   </p>
+    #   </div>>
     #   @param itemString [String]  Menu item string to find.
     #   @return [Integer]
     # @overload find_item(id, menu=nil)
@@ -336,18 +358,6 @@ module Wx
     def is_enabled(id) end
     alias_method :enabled?, :is_enabled
     
-    # Allows handling native MSW menu command messages.
-    # This is a low-level function which allows handling MSW WM_COMMAND messages generated when menu items are selected. It is particularly useful for the popup menus, as specific handling can then be defined in a {Wx::Menu}-derived class directly, instead of in the {Wx::Window}-derived owner class.
-    # The base class version of this function generates {Wx::EVT_MENU} command events.
-    # 
-    # true if the command was handled, false otherwise.
-    # 
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
-    # @param param [WXUINT]  The MSW command parameter.
-    # @param id [WXWORD]  The id of the command.
-    # @return [Boolean]
-    def msw_command(param, id) end
-    
     # @overload prepend(item)
     #   Inserts the given item at position 0, i.e. before all the other existing items.
     #   
@@ -438,7 +448,11 @@ module Wx
     def set_label(id, label) end
     
     # Sets the title of the menu.
-    # Notice that you can only call this method directly for the popup menus, to change the title of a menu that is part of a menu bar you need to use {Wx::MenuBar#set_label_top}.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Notice that you can only call this method directly for the popup menus, to change the title of a menu that is part of a menu bar you need to use {Wx::MenuBar#set_label_top}.
+    # </p>
+    # </div>>
     # @see Wx::Menu#get_title 
     # @param title [String]  The title to set.
     # @return [void]

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

@@ -7,21 +7,25 @@
 module Wx
 
   # A menu bar is a series of menus accessible from the top of a frame.
-  # To respond to a menu selection, provide a handler for EVT_MENU, in the frame that contains the menu bar.
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>To respond to a menu selection, provide a handler for EVT_MENU, in the frame that contains the menu bar.
+  # </p>
+  # </div>>
   # 
   # If you have a toolbar which uses the same identifiers as your EVT_MENU entries, events from the toolbar will also be processed by your EVT_MENU event handlers.
   # Tip: under Windows, if you discover that menu shortcuts (for example, Alt-F to show the file menu) are not working, check any EVT_CHAR events you are handling in child windows. If you are not calling event.Skip() for events that you don't process in these event handlers, menu shortcuts may cease to work.
-  # === 
   # 
   # Category:  {Wx::Menus}
   # @see Wx::Menu
   # @see  Events and Event Handling 
   # 
   # 
+  # @wxrb_require USE_MENUBAR
   class MenuBar < Window
   
     # Construct an empty menu bar.
-    # @param style [Integer]  If {Wx::MB_DOCKABLE} the menu bar can be detached (wxGTK only).
+    # @param style [Integer]  If {Wx::MB_DOCKABLE} the menu bar can be detached (WXGTK only).
     # @return [Wx::MenuBar]
     def initialize(style=0) end
     
@@ -34,14 +38,22 @@ module Wx
     def append(menu, title) end
     
     # Checks or unchecks a menu item.
-    # Only use this when the menu bar has been associated with a frame; otherwise, use the {Wx::Menu} equivalent call.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Only use this when the menu bar has been associated with a frame; otherwise, use the {Wx::Menu} equivalent call. 
+    # </p>
+    # </div>>
     # @param id [Integer]  The menu item identifier.
     # @param check [Boolean]  If true, checks the menu item, otherwise the item is unchecked.
     # @return [void]
     def check(id, check) end
     
     # Enables or disables (greys out) a menu item.
-    # Only use this when the menu bar has been associated with a frame; otherwise, use the {Wx::Menu} equivalent call.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Only use this when the menu bar has been associated with a frame; otherwise, use the {Wx::Menu} equivalent call. 
+    # </p>
+    # </div>>
     # @param id [Integer]  The menu item identifier.
     # @param enable [Boolean]  true to enable the item, false to disable it.
     # @return [void]
@@ -54,7 +66,11 @@ module Wx
     alias_method :enabled_top?, :is_enabled_top
     
     # Enables or disables a whole menu.
-    # Only use this when the menu bar has been associated with a frame.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Only use this when the menu bar has been associated with a frame. 
+    # </p>
+    # </div>>
     # @param pos [Integer]  The position of the menu, starting from zero.
     # @param enable [Boolean]  true to enable the menu, false to disable it.
     # @return [void]
@@ -76,7 +92,11 @@ module Wx
     # Finds the menu item id for a menu name/menu item string pair.
     # The menu item identifier, or {Wx::NOT_FOUND} if none was found.
     # 
-    # Any special menu codes are stripped out of source and target strings before matching.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Any special menu codes are stripped out of source and target strings before matching. 
+    # </p>
+    # </div>>
     # @param menuString [String]  Menu title to find.
     # @param itemString [String]  Item to find.
     # @return [Integer]
@@ -93,7 +113,11 @@ module Wx
     # Gets the label associated with a menu item.
     # The menu item label, or the empty string if the item was not found.
     # 
-    # Use only after the menubar has been associated with a frame.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use only after the menubar has been associated with a frame. 
+    # </p>
+    # </div>>
     # @param id [Integer]  The menu item identifier.
     # @return [String]
     def get_label(id) end
@@ -115,7 +139,11 @@ module Wx
     # 
     # The menu label, or the empty string if the menu was not found.
     # 
-    # Use only after the menubar has been associated with a frame.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use only after the menubar has been associated with a frame.
+    # </p>
+    # </div>>
     # @see Wx::MenuBar#get_menu_label_text
     # @see  Wx::MenuBar#set_menu_label 
     # @param pos [Integer]  Position of the menu on the menu bar, starting from zero.
@@ -128,7 +156,11 @@ module Wx
     # 
     # The menu label, or the empty string if the menu was not found.
     # 
-    # Use only after the menubar has been associated with a frame.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use only after the menubar has been associated with a frame.
+    # </p>
+    # </div>>
     # @see Wx::MenuBar#get_menu_label
     # @see  Wx::MenuBar#set_menu_label 
     # @param pos [Integer]  Position of the menu on the menu bar, starting from zero.
@@ -187,7 +219,11 @@ module Wx
     def set_help_string(id, helpString) end
     
     # Sets the label of a menu item.
-    # Use only after the menubar has been associated with a frame.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use only after the menubar has been associated with a frame.
+    # </p>
+    # </div>>
     # @see Wx::MenuBar#get_label 
     # @param id [Integer]  Menu item identifier.
     # @param label [String]  Menu item label.
@@ -195,7 +231,11 @@ module Wx
     def set_label(id, label) end
     
     # Sets the label of a top-level menu.
-    # Use only after the menubar has been associated with a frame.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use only after the menubar has been associated with a frame. 
+    # </p>
+    # </div>>
     # @param pos [Integer]  The position of a menu on the menu bar, starting from zero.
     # @param label [String]  The menu label.
     # @return [void]

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

@@ -9,7 +9,7 @@ module Wx
   # A menu item represents an item in a menu.
   # Note that you usually don't have to deal with it directly as {Wx::Menu} methods usually construct an object of this class for you.
   # Also please note that the methods related to fonts and bitmaps are currently only implemented for Windows, Mac and GTK+.
-  # === 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::MenuEvent} events.
   # Event handler methods for events emitted by this class:
@@ -26,18 +26,18 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_menu_highlight_all}(meth = nil, &block): A menu item has been highlighted, i.e. the currently selected menu item has changed. This type of event is sent as {Wx::MenuEvent}. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Menus}
   # @see Wx::MenuBar
   # @see  Wx::Menu 
   # 
   # 
+  # @wxrb_require USE_MENUS
   class MenuItem < Object
   
     # Returns the background colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Colour]
+    # @wxrb_require WXMSW
     def get_background_colour; end
     alias_method :background_colour, :get_background_colour
     
@@ -55,14 +55,16 @@ module Wx
     alias_method :bitmap_bundle, :get_bitmap_bundle
     
     # Returns the bitmap used for disabled items.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Bitmap]
+    # @wxrb_require WXMSW
     def get_disabled_bitmap; end
     alias_method :disabled_bitmap, :get_disabled_bitmap
     
     # Returns the font associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Font]
+    # @wxrb_require WXMSW
     def get_font; end
     alias_method :font, :get_font
     
@@ -98,8 +100,9 @@ module Wx
     alias_method :kind, :get_kind
     
     # Gets the width of the menu item checkmark bitmap.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @return [Integer]
+    # @wxrb_require WXMSW
     def get_margin_width; end
     alias_method :margin_width, :get_margin_width
     
@@ -114,13 +117,15 @@ module Wx
     alias_method :sub_menu, :get_sub_menu
     
     # Returns the text colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Colour]
+    # @wxrb_require WXMSW
     def get_text_colour; end
     alias_method :text_colour, :get_text_colour
     
     # Get our accelerator or NULL (caller must delete the pointer)
     # @return [Wx::AcceleratorEntry]
+    # @wxrb_require USE_ACCEL
     def get_accel; end
     alias_method :accel, :get_accel
     
@@ -162,9 +167,10 @@ module Wx
     alias_method :sub_menu?, :is_sub_menu
     
     # Sets the background colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param colour [Wx::Colour,String,Symbol] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_background_colour(colour) end
     alias_method :background_colour=, :set_background_colour
     
@@ -177,33 +183,37 @@ module Wx
     #   Sets the checked or unchecked bitmap for the menu item.
     #   It is equivalent to {Wx::MenuItem#set_bitmaps(bmp,wxNullBitmap)} if checked is true or SetBitmaps({Wx::NULL_BITMAP}, bmp) otherwise.
     #   Note that different bitmaps for checked and unchecked item states are not supported in most ports, while setting just a single bitmap using the overload above is supported in all of them.
-    #   Availability:  only available for the wxMSW port.  {Wx::msw}
+    #   Availability:  only available for the WXMSW port.
     #   @param bmp [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     #   @param checked [Boolean] 
     #   @return [void]
+    #   @wxrb_require WXMSW
     def set_bitmap(*args) end
     alias_method :bitmap=, :set_bitmap
     
     # Sets the checked/unchecked bitmaps for the menu item.
     # The first bitmap is also used as the single bitmap for uncheckable menu items.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param checked [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     # @param unchecked [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_bitmaps(checked, unchecked=Wx::NULL_BITMAP) end
     alias_method :bitmaps=, :set_bitmaps
     
     # Sets the to be used for disabled menu items.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param disabled [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_disabled_bitmap(disabled) end
     alias_method :disabled_bitmap=, :set_disabled_bitmap
     
     # Sets the font associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param font [Wx::Font,Wx::FontInfo] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_font(font) end
     alias_method :font=, :set_font
     
@@ -219,65 +229,65 @@ module Wx
     # Optionally you can specify also an accelerator string appending a tab character <code>\t</code> followed by a valid key combination (e.g. <code>CTRL+V</code>). Its general syntax is any combination of <code>"CTRL"</code>, <code>"RAWCTRL"</code>, <code>"ALT"</code> and <code>"SHIFT"</code> strings (case doesn't matter) separated by either <code>'-'</code> or <code>'+'</code> characters and followed by the accelerator itself. Notice that CTRL corresponds to the "Ctrl" key on most platforms but not under macOS where it is mapped to "Cmd" key on Mac keyboard. Usually this is exactly what you want in portable code but if you really need to use the (rarely used for this purpose) "Ctrl" key even under Mac, you may use RAWCTRL to prevent this mapping. Under the other platforms RAWCTRL is the same as plain CTRL.
     # The accelerator may be any alphanumeric character, any function key (from F1 to F12), any numpad digit key using KP_ prefix (i.e. from KP_0 to KP_9) or one of the special strings listed below (again, case doesn't matter) corresponding to the specified key code:
     # 
-    # - Del or Delete: {Wx::K_DELETE}
-    # - Back: {Wx::K_BACK}
-    # - Ins or Insert: {Wx::K_INSERT}
-    # - Enter or Return: {Wx::K_RETURN}
-    # - PgUp or PageUp: {Wx::K_PAGEUP}
-    # - PgDn or PageDown: {Wx::K_PAGEDOWN}
-    # - Left: {Wx::K_LEFT}
-    # - Right: {Wx::K_RIGHT}
-    # - Up: {Wx::K_UP}
-    # - Down: {Wx::K_DOWN}
-    # - Home: {Wx::K_HOME}
-    # - End: {Wx::K_END}
-    # - Space: {Wx::K_SPACE}
-    # - Tab: {Wx::K_TAB}
-    # - Esc or Escape: {Wx::K_ESCAPE}
-    # - Cancel: {Wx::K_CANCEL}
-    # - Clear: {Wx::K_CLEAR}
-    # - Menu: {Wx::K_MENU}
-    # - Pause: {Wx::K_PAUSE}
-    # - Capital: {Wx::K_CAPITAL}
-    # - Select: {Wx::K_SELECT}
-    # - Print: {Wx::K_PRINT}
-    # - Execute: {Wx::K_EXECUTE}
-    # - Snapshot: {Wx::K_SNAPSHOT}
-    # - Help: {Wx::K_HELP}
-    # - Add: {Wx::K_ADD}
-    # - Separator: {Wx::K_SEPARATOR}
-    # - Subtract: {Wx::K_SUBTRACT}
-    # - Decimal: {Wx::K_DECIMAL}
-    # - Divide: {Wx::K_DIVIDE}
-    # - Num_lock: {Wx::K_NUMLOCK}
-    # - Scroll_lock: {Wx::K_SCROLL}
-    # - KP_Space: {Wx::K_NUMPAD}_SPACE
-    # - KP_Tab: {Wx::K_NUMPAD}_TAB
-    # - KP_Enter: {Wx::K_NUMPAD}_ENTER
-    # - KP_Home: {Wx::K_NUMPAD}_HOME
-    # - KP_Left: {Wx::K_NUMPAD}_LEFT
-    # - KP_Up: {Wx::K_NUMPAD}_UP
-    # - KP_Right: {Wx::K_NUMPAD}_RIGHT
-    # - KP_Down: {Wx::K_NUMPAD}_DOWN
-    # - KP_PageUp: {Wx::K_NUMPAD}_PAGEUP
-    # - KP_PageDown: {Wx::K_NUMPAD}_PAGEDOWN
-    # - KP_Prior: {Wx::K_NUMPAD}_PAGEUP
-    # - KP_Next: {Wx::K_NUMPAD}_PAGEDOWN
-    # - KP_End: {Wx::K_NUMPAD}_END
-    # - KP_Begin: {Wx::K_NUMPAD}_BEGIN
-    # - KP_Insert: {Wx::K_NUMPAD}_INSERT
-    # - KP_Delete: {Wx::K_NUMPAD}_DELETE
-    # - KP_Equal: {Wx::K_NUMPAD}_EQUAL
-    # - KP_Multiply: {Wx::K_NUMPAD}_MULTIPLY
-    # - KP_Add: {Wx::K_NUMPAD}_ADD
-    # - KP_Separator: {Wx::K_NUMPAD}_SEPARATOR
-    # - KP_Subtract: {Wx::K_NUMPAD}_SUBTRACT
-    # - KP_Decimal: {Wx::K_NUMPAD}_DECIMAL
-    # - KP_Divide: {Wx::K_NUMPAD}_DIVIDE
-    # - Windows_Left: {Wx::K_WINDOWS}_LEFT
-    # - Windows_Right: {Wx::K_WINDOWS}_RIGHT
-    # - Windows_Menu: {Wx::K_WINDOWS}_MENU
-    # - Command: {Wx::K_COMMAND}
+    # - Del or Delete: {Wx::KeyCode::K_DELETE}
+    # - Back: {Wx::KeyCode::K_BACK}
+    # - Ins or Insert: {Wx::KeyCode::K_INSERT}
+    # - Enter or Return: {Wx::KeyCode::K_RETURN}
+    # - PgUp or PageUp: {Wx::KeyCode::K_PAGEUP}
+    # - PgDn or PageDown: {Wx::KeyCode::K_PAGEDOWN}
+    # - Left: {Wx::KeyCode::K_LEFT}
+    # - Right: {Wx::KeyCode::K_RIGHT}
+    # - Up: {Wx::KeyCode::K_UP}
+    # - Down: {Wx::KeyCode::K_DOWN}
+    # - Home: {Wx::KeyCode::K_HOME}
+    # - End: {Wx::KeyCode::K_END}
+    # - Space: {Wx::KeyCode::K_SPACE}
+    # - Tab: {Wx::KeyCode::K_TAB}
+    # - Esc or Escape: {Wx::KeyCode::K_ESCAPE}
+    # - Cancel: {Wx::KeyCode::K_CANCEL}
+    # - Clear: {Wx::KeyCode::K_CLEAR}
+    # - Menu: {Wx::KeyCode::K_MENU}
+    # - Pause: {Wx::KeyCode::K_PAUSE}
+    # - Capital: {Wx::KeyCode::K_CAPITAL}
+    # - Select: {Wx::KeyCode::K_SELECT}
+    # - Print: {Wx::KeyCode::K_PRINT}
+    # - Execute: {Wx::KeyCode::K_EXECUTE}
+    # - Snapshot: {Wx::KeyCode::K_SNAPSHOT}
+    # - Help: {Wx::KeyCode::K_HELP}
+    # - Add: {Wx::KeyCode::K_ADD}
+    # - Separator: {Wx::KeyCode::K_SEPARATOR}
+    # - Subtract: {Wx::KeyCode::K_SUBTRACT}
+    # - Decimal: {Wx::KeyCode::K_DECIMAL}
+    # - Divide: {Wx::KeyCode::K_DIVIDE}
+    # - Num_lock: {Wx::KeyCode::K_NUMLOCK}
+    # - Scroll_lock: {Wx::KeyCode::K_SCROLL}
+    # - KP_Space: {Wx::KeyCode::K_NUMPAD}_SPACE
+    # - KP_Tab: {Wx::KeyCode::K_NUMPAD}_TAB
+    # - KP_Enter: {Wx::KeyCode::K_NUMPAD}_ENTER
+    # - KP_Home: {Wx::KeyCode::K_NUMPAD}_HOME
+    # - KP_Left: {Wx::KeyCode::K_NUMPAD}_LEFT
+    # - KP_Up: {Wx::KeyCode::K_NUMPAD}_UP
+    # - KP_Right: {Wx::KeyCode::K_NUMPAD}_RIGHT
+    # - KP_Down: {Wx::KeyCode::K_NUMPAD}_DOWN
+    # - KP_PageUp: {Wx::KeyCode::K_NUMPAD}_PAGEUP
+    # - KP_PageDown: {Wx::KeyCode::K_NUMPAD}_PAGEDOWN
+    # - KP_Prior: {Wx::KeyCode::K_NUMPAD}_PAGEUP
+    # - KP_Next: {Wx::KeyCode::K_NUMPAD}_PAGEDOWN
+    # - KP_End: {Wx::KeyCode::K_NUMPAD}_END
+    # - KP_Begin: {Wx::KeyCode::K_NUMPAD}_BEGIN
+    # - KP_Insert: {Wx::KeyCode::K_NUMPAD}_INSERT
+    # - KP_Delete: {Wx::KeyCode::K_NUMPAD}_DELETE
+    # - KP_Equal: {Wx::KeyCode::K_NUMPAD}_EQUAL
+    # - KP_Multiply: {Wx::KeyCode::K_NUMPAD}_MULTIPLY
+    # - KP_Add: {Wx::KeyCode::K_NUMPAD}_ADD
+    # - KP_Separator: {Wx::KeyCode::K_NUMPAD}_SEPARATOR
+    # - KP_Subtract: {Wx::KeyCode::K_NUMPAD}_SUBTRACT
+    # - KP_Decimal: {Wx::KeyCode::K_NUMPAD}_DECIMAL
+    # - KP_Divide: {Wx::KeyCode::K_NUMPAD}_DIVIDE
+    # - Windows_Left: {Wx::KeyCode::K_WINDOWS}_LEFT
+    # - Windows_Right: {Wx::KeyCode::K_WINDOWS}_RIGHT
+    # - Windows_Menu: {Wx::KeyCode::K_WINDOWS}_MENU
+    # - Command: {Wx::KeyCode::K_COMMAND}
     # 
     # Examples:
     # 
@@ -288,26 +298,35 @@ module Wx
     #   @my_menu_item4.set_item_label("Item with &accelerator")
     # ```
     # 
-    # In wxGTK using <code>"SHIFT"</code> with non-alphabetic characters currently doesn't work, even in combination with other modifiers, due to GTK+ limitation. E.g. <code>Shift+Ctrl+A</code> works but <code>Shift+Ctrl+1</code> or <code>Shift+/</code> do not, so avoid using accelerators of this form in portable code.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In WXGTK using <code>"SHIFT"</code> with non-alphabetic characters currently doesn't work, even in combination with other modifiers, due to GTK+ limitation. E.g. <code>Shift+Ctrl+A</code> works but <code>Shift+Ctrl+1</code> or <code>Shift+/</code> do not, so avoid using accelerators of this form in portable code.
+    # </p>
+    # </div>
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In {Wx::GTk}, the left/right/up/down arrow keys do not work as accelerator keys for a menu item unless a modifier key is used. Additionally, the following keycodes are not supported as menu accelerator keys:
     # 
-    # In {Wx::GTk}, the left/right/up/down arrow keys do not work as accelerator keys for a menu item unless a modifier key is used. Additionally, the following keycodes are not supported as menu accelerator keys:
+    # - {Wx::KeyCode::K_COMMAND}/{Wx::KeyCode::K_CONTROL}
+    # - {Wx::KeyCode::K_SHIFT}
+    # - {Wx::KeyCode::K_ALT}
+    # - {Wx::KeyCode::K_SCROLL}
+    # - {Wx::KeyCode::K_CAPITAL}
+    # - {Wx::KeyCode::K_NUMLOCK}
+    # - {Wx::KeyCode::K_NUMPAD}_TAB
+    # - {Wx::KeyCode::K_TAB}
+    # - {Wx::KeyCode::K_WINDOWS}_LEFT
+    # - {Wx::KeyCode::K_WINDOWS}_RIGHT
+    # - {Wx::KeyCode::K_ADD}
+    # - {Wx::KeyCode::K_SEPARATOR}
+    # - {Wx::KeyCode::K_SUBTRACT}
+    # - {Wx::KeyCode::K_DECIMAL}
+    # - {Wx::KeyCode::K_DIVIDE}
+    # - {Wx::KeyCode::K_SNAPSHOT}
     # 
-    # - {Wx::K_COMMAND}/{Wx::K_CONTROL}
-    # - {Wx::K_SHIFT}
-    # - {Wx::K_ALT}
-    # - {Wx::K_SCROLL}
-    # - {Wx::K_CAPITAL}
-    # - {Wx::K_NUMLOCK}
-    # - {Wx::K_NUMPAD}_TAB
-    # - {Wx::K_TAB}
-    # - {Wx::K_WINDOWS}_LEFT
-    # - {Wx::K_WINDOWS}_RIGHT
-    # - {Wx::K_ADD}
-    # - {Wx::K_SEPARATOR}
-    # - {Wx::K_SUBTRACT}
-    # - {Wx::K_DECIMAL}
-    # - {Wx::K_DIVIDE}
-    # - {Wx::K_SNAPSHOT}
+    # </p>
+    # </div>
     # @see Wx::MenuItem#get_item_label
     # @see  Wx::MenuItem#get_item_label_text 
     # @param label [String] 
@@ -316,9 +335,10 @@ module Wx
     alias_method :item_label=, :set_item_label
     
     # Sets the width of the menu item checkmark bitmap.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param width [Integer] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_margin_width(width) end
     alias_method :margin_width=, :set_margin_width
     
@@ -335,9 +355,10 @@ module Wx
     alias_method :sub_menu=, :set_sub_menu
     
     # Sets the text colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param colour [Wx::Colour,String,Symbol] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_text_colour(colour) end
     alias_method :text_colour=, :set_text_colour
     
@@ -349,10 +370,11 @@ module Wx
     
     # Add an extra accelerator for this menu item.
     # Additional accelerators are not shown in the item's label, but still will trigger the menu command when pressed.
-    # They can be useful to let multiple keys be used as accelerators for the same command, e.g. {Wx::K_ADD} and {Wx::K_NUMPAD}_ADD.
-    # Availability:  only available for the wxMSW, wxGTK ports.  {Wx::msw},{Wx::gtk}
+    # They can be useful to let multiple keys be used as accelerators for the same command, e.g. {Wx::KeyCode::K_ADD} and {Wx::KeyCode::K_NUMPAD}_ADD.
+    # Availability:  only available for the WXMSW, WXGTK ports.
     # @param accel [Wx::AcceleratorEntry] 
     # @return [void]
+    # @wxrb_require WXMSW|WXGTK
     def add_extra_accel(accel) end
     
     # Clear the extra accelerators list.
@@ -361,7 +383,7 @@ module Wx
     def clear_extra_accels; end
     
     # Constructs a {Wx::MenuItem} object.
-    # Menu items can be standard, or "stock menu items", or custom. For the standard menu items (such as commands to open a file, exit the program and so on, see Stock Items for the full list) it is enough to specify just the stock ID and leave text and helpString empty. Some platforms (currently wxGTK only, and see the remark in {Wx::MenuItem#set_bitmap} documentation) will also show standard bitmaps for stock menu items.
+    # Menu items can be standard, or "stock menu items", or custom. For the standard menu items (such as commands to open a file, exit the program and so on, see Stock Items for the full list) it is enough to specify just the stock ID and leave text and helpString empty. Some platforms (currently WXGTK only, and see the remark in {Wx::MenuItem#set_bitmap} documentation) will also show standard bitmaps for stock menu items.
     # Leaving at least text empty for the stock menu items is actually strongly recommended as they will have appearance and keyboard interface (including standard accelerators) familiar to the user.
     # For the custom (non-stock) menu items, text must be specified and while helpString may be left empty, it's recommended to pass the item description (which is automatically shown by the library in the status bar when the menu item is selected) in this parameter.
     # Finally note that you can e.g. use a stock menu label without using its stock help string: