wxruby3 0.9.0.pre.rc.2-x64-mingw-ucrt → 0.9.0-x64-mingw-ucrt

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

@@ -154,62 +154,105 @@ module Wx
   # === Styles
   # 
   # This class supports the following styles:
-  #  
+  # 
   # - {Wx::Border::BORDER_DEFAULT}: The window class will decide the kind of border to show, if any. 
+  # 
   # - {Wx::Border::BORDER_SIMPLE}: Displays a thin border around the window. {Wx::SIMPLE_BORDER} is the old name for this style. 
+  # 
   # - {Wx::Border::BORDER_SUNKEN}: Displays a sunken border. {Wx::SUNKEN_BORDER} is the old name for this style. 
+  # 
   # - {Wx::Border::BORDER_RAISED}: Displays a raised border. {Wx::RAISED_BORDER} is the old name for this style. 
+  # 
   # - {Wx::Border::BORDER_STATIC}: Displays a border suitable for a static control. {Wx::STATIC_BORDER} is the old name for this style. Windows only. 
+  # 
   # - {Wx::Border::BORDER_THEME}: Displays a native border suitable for a control, on the current platform. On Windows, this will be a themed border; on most other platforms a sunken border will be used. For more information for themed borders on Windows, please see Themed borders on Windows. 
+  # 
   # - {Wx::Border::BORDER_NONE}: Displays no border, overriding the default border style for the window. {Wx::NO_BORDER} is the old name for this style. 
+  # 
   # - {Wx::Border::BORDER_DOUBLE}: This style is obsolete and should not be used. 
+  # 
   # - {Wx::TRANSPARENT_WINDOW}: The window is transparent, that is, it will not receive paint events. Windows only. 
+  # 
   # - {Wx::TAB_TRAVERSAL}: This style is used by wxWidgets for the windows supporting TAB navigation among their children, such as {Wx::Dialog} and {Wx::Panel}. It should almost never be used in the application code. 
+  # 
   # - {Wx::WANTS_CHARS}: Use this to indicate that the window wants to get all char/key events for all keys - even for keys like TAB or ENTER which are usually used for dialog navigation and which wouldn't be generated without this style. If you need to use this style in order to get the arrows or etc., but would still like to have normal keyboard navigation take place, you should call Navigate in response to the key events for Tab and Shift-Tab. 
+  # 
   # - {Wx::NO_FULL_REPAINT_ON_RESIZE}: On Windows, this style used to disable repainting the window completely when its size is changed. Since this behaviour is now the default, the style is now obsolete and no longer has an effect. 
+  # 
   # - {Wx::VSCROLL}: Use this style to enable a vertical scrollbar. Notice that this style cannot be used with native controls which don't support scrollbars nor with top-level windows in most ports. 
+  # 
   # - {Wx::HSCROLL}: Use this style to enable a horizontal scrollbar. The same limitations as for {Wx::VSCROLL} apply to this style. 
-  # - {Wx::ALWAYS_SHOW_SB}: If a window has scrollbars, disable them instead of hiding them when they are not needed (i.e. when the size of the window is big enough to not require the scrollbars to navigate it). This style is currently implemented for {Wx::MSW}, {Wx::GTK} and {Wx::Universal} and does nothing on the other platforms. 
+  # 
+  # - {Wx::ALWAYS_SHOW_SB}: If a window has scrollbars, disable them instead of hiding them when they are not needed (i.e. when the size of the window is big enough to not require the scrollbars to navigate it). This style is currently implemented for wxMSW, wxGTK and {Wx::Universal} and does nothing on the other platforms. 
+  # 
   # - {Wx::CLIP_CHILDREN}: Use this style to eliminate flicker caused by the background being repainted, then children being painted over them. Windows only. 
+  # 
   # - {Wx::FULL_REPAINT_ON_RESIZE}: Use this style to force a complete redraw of the window whenever it is resized instead of redrawing just the part of the window affected by resizing. Note that this was the behaviour by default before 2.5.1 release and that if you experience redraw problems with code which previously used to work you may want to try this. Currently this style applies on GTK+ 2 and Windows only, and full repainting is always done on other platforms. 
   # 
   # === Extra Styles
   # 
   # This class supports the following extra styles:
-  #  
+  # 
   # - {Wx::WS_EX_BLOCK_EVENTS}: {Wx::CommandEvents} and the objects of the derived classes are forwarded to the parent window and so on recursively by default. Using this flag for the given window allows blocking this propagation at this window, i.e. prevent the events from being propagated further upwards. Dialogs have this flag on by default for the reasons explained in the Events and Event Handling. 
+  # 
   # - {Wx::WS_EX_TRANSIENT}: Don't use this window as an implicit parent for the other windows: this must be used with transient windows as otherwise there is the risk of creating a dialog/frame with this window as a parent, which would lead to a crash if the parent were destroyed before the child. 
+  # 
   # - {Wx::WS_EX_CONTEXTHELP}: Under Windows, puts a query button on the caption. When pressed, Windows will go into a context-sensitive help mode and wxWidgets will send a {Wx::EVT_HELP} event if the user clicked on an application window. This style cannot be used (because of the underlying native behaviour) together with {Wx::MAXIMIZE_BOX} or {Wx::MINIMIZE_BOX}, so these two styles are automatically turned off if this one is used. 
+  # 
   # - {Wx::WS_EX_PROCESS_IDLE}: This window should always process idle events, even if the mode set by {Wx::IdleEvent.set_mode} is {Wx::IdleMode::IDLE_PROCESS_SPECIFIED}. 
+  # 
   # - {Wx::WS_EX_PROCESS_UI_UPDATES}: This window should always process UI update events, even if the mode set by {Wx::UpdateUIEvent.set_mode} is {Wx::UpdateUIMode::UPDATE_UI_PROCESS_SPECIFIED}. 
   # 
   # === Events emitted by this class
   # 
   # Event handler methods for events emitted by this class:
-  #  
+  # 
   # - {Wx::EvtHandler#EVT_ACTIVATE}(meth = nil, &block): Process a {Wx::EVT_ACTIVATE} event. See {Wx::ActivateEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_child_focus}(meth = nil, &block): Process a {Wx::EVT_CHILD_FOCUS} event. See {Wx::ChildFocusEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_context_menu}(meth = nil, &block): A right click (or other context menu command depending on platform) has been detected. See {Wx::ContextMenuEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_help}(id, meth = nil, &block): Process a {Wx::EVT_HELP} event. See {Wx::HelpEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_help_range}(id1,  id2, meth = nil, &block): Process a {Wx::EVT_HELP} event for a range of ids. See {Wx::HelpEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_drop_files}(meth = nil, &block): Process a {Wx::EVT_DROP_FILES} event. See {Wx::DropFilesEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_erase_background}(meth = nil, &block): Process a {Wx::EVT_ERASE_BACKGROUND} event. See {Wx::EraseEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_set_focus}(meth = nil, &block): Process a {Wx::EVT_SET_FOCUS} event. See {Wx::FocusEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_kill_focus}(meth = nil, &block): Process a {Wx::EVT_KILL_FOCUS} event. See {Wx::FocusEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_idle}(meth = nil, &block): Process a {Wx::EVT_IDLE} event. See {Wx::IdleEvent}. 
+  # 
   # - {Wx::EvtHandler}evt_joy_*(meth = nil, &block): Processes joystick events. See {Wx::JoystickEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_key_down}(meth = nil, &block): Process a {Wx::EVT_KEY_DOWN} event (any key has been pressed). See {Wx::KeyEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_key_up}(meth = nil, &block): Process a {Wx::EVT_KEY_UP} event (any key has been released). See {Wx::KeyEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_char}(meth = nil, &block): Process a {Wx::EVT_CHAR} event. See {Wx::KeyEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_char_hook}(meth = nil, &block): Process a {Wx::EVT_CHAR_HOOK} event. See {Wx::KeyEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_mouse_capture_lost}(meth = nil, &block): Process a {Wx::EVT_MOUSE_CAPTURE_LOST} event. See {Wx::MouseCaptureLostEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_mouse_capture_changed}(meth = nil, &block): Process a {Wx::EVT_MOUSE_CAPTURE_CHANGED} event. See {Wx::MouseCaptureChangedEvent}. 
+  # 
   # - {Wx::EvtHandler}evt_mouse_*(meth = nil, &block): See {Wx::MouseEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_paint}(meth = nil, &block): Process a {Wx::EVT_PAINT} event. See {Wx::PaintEvent}. 
+  # 
   # - {Wx::EvtHandler}evt_power_*(meth = nil, &block): The system power state changed. See {Wx::PowerEvent}. 
+  # 
   # - {Wx::EvtHandler}evt_scrollwin_*(meth = nil, &block): Process scroll events. See {Wx::ScrollWinEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_set_cursor}(meth = nil, &block): Process a {Wx::EVT_SET_CURSOR} event. See {Wx::SetCursorEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_size}(meth = nil, &block): Process a {Wx::EVT_SIZE} event. See {Wx::SizeEvent}. 
+  # 
   # - {Wx::EvtHandler#evt_sys_colour_changed}(meth = nil, &block): Process a {Wx::EVT_SYS_COLOUR_CHANGED} event. See {Wx::SysColourChangedEvent}. 
   # 
   # === 
@@ -224,16 +267,16 @@ module Wx
     # This method may be overridden in the derived classes to return false to indicate that this control doesn't accept input at all (i.e. behaves like e.g. {Wx::StaticText}) and so doesn't need focus.
     # 
     # @see Wx::Window#accepts_focus_from_keyboard 
-    # @return [true,false]
+    # @return [Boolean]
     def accepts_focus; end
     
     # This method may be overridden in the derived classes to return false to indicate that while this control can, in principle, have focus if the user clicks it with the mouse, it shouldn't be included in the TAB traversal chain when using the keyboard.
-    # @return [true,false]
+    # @return [Boolean]
     def accepts_focus_from_keyboard; end
     
     # Overridden to indicate whether this window or one of its children accepts focus.
     # Usually it's the same as {Wx::Window#accepts_focus} but is overridden for container windows.
-    # @return [true,false]
+    # @return [Boolean]
     def accepts_focus_recursively; end
     
     # Disable giving focus to this window using the keyboard navigation keys.
@@ -242,25 +285,25 @@ module Wx
     def disable_focus_from_keyboard; end
     
     # Can this window itself have focus?
-    # @return [true,false]
+    # @return [Boolean]
     def is_focusable; end
     alias_method :focusable?, :is_focusable
     
     # Can this window have focus right now?
     # If this method returns true, it means that calling {Wx::Window#set_focus} will put focus either to this window or one of its children, if you need to know whether this window accepts focus itself, use {Wx::Window#is_focusable}
-    # @return [true,false]
+    # @return [Boolean]
     def can_accept_focus; end
     alias_method :can_accept_focus?, :can_accept_focus
     
     # Can this window be assigned focus from keyboard right now?
-    # @return [true,false]
+    # @return [Boolean]
     def can_accept_focus_from_keyboard; end
     alias_method :can_accept_focus_from_keyboard?, :can_accept_focus_from_keyboard
     
     # Returns true if the window (or in case of composite controls, its main child window) has focus.
     # 
     # @see Wx::Window.find_focus 
-    # @return [true,false]
+    # @return [Boolean]
     def has_focus; end
     alias_method :has_focus?, :has_focus
     
@@ -269,7 +312,7 @@ module Wx
     # @see Wx::FocusEvent
     # @see  Wx::Panel#set_focus
     # @see  Wx::Panel#set_focus_ignoring_children 
-    # @param canFocus [true,false] 
+    # @param canFocus [Boolean] 
     # @return [void]
     def set_can_focus(canFocus) end
     alias_method :can_focus=, :set_can_focus
@@ -277,7 +320,7 @@ module Wx
     # Enables or disables visible indication of keyboard focus.
     # By default, controls behave in platform-appropriate way and show focus in the same way native applications do. In some very rare circumstances it may be desirable to change the default (notably multiline text controls don't normally have a focus indicator on Mac), which this method allows. It should only be used if you have a good understanding of the native platform's guidelines and user expectations.
     # This method is only implemented on Mac.
-    # @param enable [true,false] 
+    # @param enable [Boolean] 
     # @return [void]
     def enable_visible_focus(enable) end
     
@@ -303,18 +346,13 @@ module Wx
     
     # Destroys all children of a window.
     # Called automatically by the destructor.
-    # @return [true,false]
+    # @return [Boolean]
     def destroy_children; end
     
-    # @overload get_children()
-    #   Returns a reference to the list of the window's children.
-    #   {Wx::WindowList} is a type-safe {Wx::List}-like class whose elements are of type <code>wxWindow*</code>.
-    #   @return [Array<Wx::Window>]
-    # @overload get_children()
-    #   Returns a const reference to the list of the window's children.
-    #   {Wx::WindowList} is a type-safe {Wx::List}-like class whose elements are of type <code>wxWindow*</code>.
-    #   @return [Wx::WindowList]
-    def get_children(*args) end
+    # Returns a const reference to the list of the window's children.
+    # {Wx::WindowList} is a type-safe {Wx::List}-like class whose elements are of type <code>wxWindow*</code>.
+    # @return [Wx::WindowList]
+    def get_children; end
     alias_method :children, :get_children
     
     # Removes a child window.
@@ -351,7 +389,7 @@ module Wx
     # Returns true if the window is a descendant (i.e. a child or grand-child or grand-grand-child or ...) of this one.
     # Notice that a window can never be a descendant of another one if they are in different top level windows, i.e. a child of a {Wx::Dialog} is not considered to be a descendant of dialogs parent {Wx::Frame}.
     # @param win [Wx::Window]  Any window, possible NULL (false is always returned then).
-    # @return [true,false]
+    # @return [Boolean]
     def is_descendant(win) end
     alias_method :descendant?, :is_descendant
     
@@ -359,13 +397,13 @@ module Wx
     # a non-standard toolbar in a {Wx::Frame}) and then re-inserted into another.
     # Notice that currently you need to explicitly call {Wx::Notebook#remove_page} before reparenting a notebook page.
     # @param newParent [Wx::Window]  New parent.
-    # @return [true,false]
+    # @return [Boolean]
     def reparent(newParent) end
     
     # Call this function to force one or both scrollbars to be always shown, even if the window is big enough to show its entire contents without scrolling.
     # This function is currently not implemented.
-    # @param hflag [true,false]  Whether the horizontal scroll bar should always be visible.
-    # @param vflag [true,false]  Whether the vertical scroll bar should always be visible.
+    # @param hflag [Boolean]  Whether the horizontal scroll bar should always be visible.
+    # @param vflag [Boolean]  Whether the vertical scroll bar should always be visible.
     # @return [void]
     def always_show_scrollbars(hflag=true, vflag=true) end
     
@@ -395,14 +433,14 @@ module Wx
     
     # Returns true if this window can have a scroll bar in this orientation.
     # @param orient [Integer]  Orientation to check, either {Wx::Orientation::HORIZONTAL} or {Wx::Orientation::VERTICAL}.
-    # @return [true,false]
+    # @return [Boolean]
     def can_scroll(orient) end
     alias_method :can_scroll?, :can_scroll
     
     # Returns true if this window currently has a scroll bar for this orientation.
     # This method may return false even when {Wx::Window#can_scroll} for the same orientation returns true, but if {Wx::Window#can_scroll} returns false, i.e. scrolling in this direction is not enabled at all, {Wx::Window#has_scrollbar} always returns false as well.
     # @param orient [Integer]  Orientation to check, either {Wx::Orientation::HORIZONTAL} or {Wx::Orientation::VERTICAL}.
-    # @return [true,false]
+    # @return [Boolean]
     def has_scrollbar(orient) end
     alias_method :has_scrollbar?, :has_scrollbar
     
@@ -410,50 +448,50 @@ module Wx
     # 
     # @see Wx::Window#always_show_scrollbars 
     # @param orient [Integer]  Orientation to check, either {Wx::Orientation::HORIZONTAL} or {Wx::Orientation::VERTICAL}.
-    # @return [true,false]
+    # @return [Boolean]
     def is_scrollbar_always_shown(orient) end
     alias_method :scrollbar_always_shown?, :is_scrollbar_always_shown
     
     # Scrolls the window by the given number of lines down (if lines is positive) or up.
     # Returns true if the window was scrolled, false if it was already on top/bottom and nothing was done.
     # 
-    # This function is currently only implemented under MSW and {Wx::TextCtrl} under {Wx::GTK} (it also works for {Wx::Scrolled} classes under all platforms).
+    # This function is currently only implemented under MSW and {Wx::TextCtrl} under wxGTK (it also works for {Wx::Scrolled} classes under all platforms).
     # @see Wx::Window#scroll_pages 
     # @param lines [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def scroll_lines(lines) end
     
     # Scrolls the window by the given number of pages down (if pages is positive) or up.
     # Returns true if the window was scrolled, false if it was already on top/bottom and nothing was done.
     # 
-    # This function is currently only implemented under MSW and {Wx::GTK}.
+    # This function is currently only implemented under MSW and wxGTK.
     # @see Wx::Window#scroll_lines 
     # @param pages [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def scroll_pages(pages) end
     
     # Physically scrolls the pixels in the window and move child windows accordingly.
     # Note that you can often use {Wx::Scrolled} instead of using this function directly.
     # @param dx [Integer]  Amount to scroll horizontally.
     # @param dy [Integer]  Amount to scroll vertically.
-    # @param rect [Wx::Rect]  Rectangle to scroll, if it is NULL, the whole window is scrolled (this is always the case under {Wx::GTK} which doesn't support this parameter)
+    # @param rect [Wx::Rect]  Rectangle to scroll, if it is NULL, the whole window is scrolled (this is always the case under wxGTK which doesn't support this parameter)
     # @return [void]
     def scroll_window(dx, dy, rect=nil) end
     
     # Same as {Wx::Window#scroll_lines} (-1).
-    # @return [true,false]
+    # @return [Boolean]
     def line_up; end
     
     # Same as {Wx::Window#scroll_lines} (1).
-    # @return [true,false]
+    # @return [Boolean]
     def line_down; end
     
     # Same as {Wx::Window#scroll_pages} (-1).
-    # @return [true,false]
+    # @return [Boolean]
     def page_up; end
     
     # Same as {Wx::Window#scroll_pages} (1).
-    # @return [true,false]
+    # @return [Boolean]
     def page_down; end
     
     # Sets the position of one of the built-in scrollbars.
@@ -465,14 +503,14 @@ module Wx
     # @see  Wx::Scrolled 
     # @param orientation [Integer]  Determines the scrollbar whose position is to be set. May be {Wx::Orientation::HORIZONTAL} or {Wx::Orientation::VERTICAL}.
     # @param pos [Integer]  Position in scroll units.
-    # @param refresh [true,false]  true to redraw the scrollbar, false otherwise.
+    # @param refresh [Boolean]  true to redraw the scrollbar, false otherwise.
     # @return [void]
     def set_scroll_pos(orientation, pos, refresh=true) end
     
     # Sets the scrollbar properties of a built-in scrollbar.
     # Let's say you wish to display 50 lines of text, using the same font. The window is sized so that you can only see 16 lines at a time. You would use: 
-    # ```
-    #   SetScrollbar(wxVERTICAL, 0, 16, 50);
+    # ```ruby
+    #   set_scrollbar(Wx::VERTICAL, 0, 16, 50)
     # ```
     #  Note that with the window at this size, the thumb position can never go above 50 minus 16, or 34. You can determine how many lines are currently visible by dividing the current view size by the character height in pixels. When defining your own scrollbar behaviour, you will always need to recalculate the scrollbar settings when the window size changes. You could therefore put your scrollbar calculations and SetScrollbar call into a function named AdjustScrollbars, which can be called initially and also from your {Wx::SizeEvent} handler function.
     # @see Scrolled Windows
@@ -482,15 +520,15 @@ module Wx
     # @param orientation [Integer]  Determines the scrollbar whose page size is to be set. May be {Wx::Orientation::HORIZONTAL} or {Wx::Orientation::VERTICAL}.
     # @param position [Integer]  The position of the scrollbar in scroll units.
     # @param thumbSize [Integer]  The size of the thumb, or visible portion of the scrollbar, in scroll units.
-    # @param range [Integer]  The maximum position of the scrollbar. Value of -1 can be used to ask for the scrollbar to be shown but in the disabled state: this can be used to avoid removing the scrollbar even when it is not needed (currently this is only implemented in {Wx::MSW} port).
-    # @param refresh [true,false]  true to redraw the scrollbar, false otherwise.
+    # @param range [Integer]  The maximum position of the scrollbar. Value of -1 can be used to ask for the scrollbar to be shown but in the disabled state: this can be used to avoid removing the scrollbar even when it is not needed (currently this is only implemented in wxMSW port).
+    # @param refresh [Boolean]  true to redraw the scrollbar, false otherwise.
     # @return [void]
     def set_scrollbar(orientation, position, thumbSize, range, refresh=true) end
     
     # Prepare for changing positions of multiple child windows.
     # This method should be called before changing positions of multiple child windows to reduce flicker and, in MSW case, even avoid display corruption in some cases. It is used internally by wxWidgets and called automatically when the window size changes but it can also be useful to call it from outside of the library if a repositioning involving multiple children is done without changing the window size.
     # If this method returns true, then {Wx::Window#end_repositioning_children} must be called after setting all children positions. Use {Wx::ChildrenRepositioningGuard} class to ensure that this requirement is satisfied.
-    # @return [true,false]
+    # @return [Boolean]
     def begin_repositioning_children; end
     
     # Fix child window positions after setting all of them at once.
@@ -535,8 +573,8 @@ module Wx
     # @overload from_dip(sz)
     #   Convert DPI-independent pixel values to the value in pixels appropriate for the current toolkit.
     #   A DPI-independent pixel is just a pixel at the standard 96 DPI resolution. To keep the same physical size at higher resolution, the physical pixel value must be scaled by {Wx::Window#get_dpi_scale_factor} but this scaling may be already done by the underlying toolkit (GTK+, Cocoa, ...) automatically. This method performs the conversion only if it is not already done by the lower level toolkit and so by using it with pixel values you can guarantee that the physical size of the corresponding elements will remain the same in all resolutions under all platforms. For example, instead of creating a bitmap of the hard coded size of 32 pixels you should use 
-    #   ```
-    #     wxBitmap bmp(FromDIP(32, 32));
+    #   ```ruby
+    #     bmp = Wx::Bitmap.new(from_dip(Wx::Size.new(32, 32)))
     #   ```
     #    to avoid using tiny bitmaps on high DPI screens.
     #   Notice that this function is only needed when using hard coded pixel values. It is not necessary if the sizes are already based on the DPI-independent units such as dialog units or if you are relying on the controls automatic best size determination and using sizers to lay out them.
@@ -577,9 +615,9 @@ module Wx
     # @overload to_dip(sz)
     #   Convert pixel values of the current toolkit to DPI-independent pixel values.
     #   A DPI-independent pixel is just a pixel at the standard 96 DPI resolution. To keep the same physical size at higher resolution, the physical pixel value must be scaled by {Wx::Window#get_dpi_scale_factor} but this scaling may be already done by the underlying toolkit (GTK+, Cocoa, ...) automatically. This method performs the conversion only if it is not already done by the lower level toolkit, For example, you may want to use this to store window sizes and positions so that they can be re-used regardless of the display DPI: 
-    #   ```
-    #     wxPoint pt(ToDIP(GetPosition()));
-    #     wxSize size(ToDIP(GetSize()));
+    #   ```ruby
+    #     pt = Wx::Point.new(to_dip(get_position))
+    #     size = Wx::Size.new(to_dip(get_size))
     #   ```
     #   
     #   Also note that if either component of sz has the special value of -1, it is returned unchanged independently of the current DPI, to preserve the special value of -1 in wxWidgets API (it is often used to mean "unspecified").
@@ -809,7 +847,7 @@ module Wx
     # Returns the factor mapping logical pixels of this window to physical pixels.
     # This function can be used to portably determine the number of physical pixels in a window of the given size, by multiplying the window size by the value returned from it. I.e. it returns the factor converting window coordinates to "content view" coordinates, where the view can be just a simple window displaying a {Wx::Bitmap} or {Wx::GLCanvas} or any other kind of window rendering arbitrary "content" on screen.
     # For the platforms not doing any pixel mapping, i.e. where logical and physical pixels are one and the same, this function always returns 1.0 and so using it is, in principle, unnecessary and could be avoided by using preprocessor check for {Wx::HAS_DPI_INDEPENDENT_PIXELS} not being defined, however using this function unconditionally under all platforms is usually simpler and so preferable.
-    # Current behaviour of this function is compatible with wxWidgets 3.0, but different from its behaviour in versions 3.1.0 to 3.1.3, where it returned the same value as {Wx::Window#get_dpi_scale_factor}. Please use the other function if you need to use a scaling factor greater than 1.0 even for the platforms without {Wx::HAS_DPI_INDEPENDENT_PIXELS}, such as {Wx::MSW}.
+    # Current behaviour of this function is compatible with wxWidgets 3.0, but different from its behaviour in versions 3.1.0 to 3.1.3, where it returned the same value as {Wx::Window#get_dpi_scale_factor}. Please use the other function if you need to use a scaling factor greater than 1.0 even for the platforms without {Wx::HAS_DPI_INDEPENDENT_PIXELS}, such as wxMSW.
     # @return [Float]
     def get_content_scale_factor; end
     alias_method :content_scale_factor, :get_content_scale_factor
@@ -834,7 +872,7 @@ module Wx
     # @param direction [Integer] 
     # @param size [Integer] 
     # @param availableOtherDir [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def inform_first_direction(direction, size, availableOtherDir) end
     
     # Resets the cached best size value so it will be recalculated the next time it is needed.
@@ -907,8 +945,8 @@ module Wx
     
     # Sets the maximum client size of the window, to indicate to the sizer layout mechanism that this is the maximum possible size of its client area.
     # Note that this method is just a shortcut for: 
-    # ```
-    #   SetMaxSize(ClientToWindowSize(size));
+    # ```ruby
+    #   set_max_size(client_to_window_size(size))
     # ```
     # @see Wx::Window#set_max_size
     # @see  Window Sizing Overview 
@@ -930,8 +968,8 @@ module Wx
     # You may need to call this if you change the window size after construction and before adding to its parent sizer.
     # Note, that just as with {Wx::Window#set_min_size}, calling this method doesn't prevent the program from explicitly making the window smaller than the specified size.
     # Note that this method is just a shortcut for: 
-    # ```
-    #   SetMinSize(ClientToWindowSize(size));
+    # ```ruby
+    #   set_min_size(client_to_window_size(size))
     # ```
     # @see Wx::Window#set_min_size
     # @see  Window Sizing Overview 
@@ -960,7 +998,13 @@ module Wx
     #   @param width [Integer]  Required width in pixels, or {Wx::DEFAULT_COORD} to indicate that the existing value should be used.
     #   @param height [Integer]  Required height position in pixels, or {Wx::DEFAULT_COORD} to indicate that the existing value should be used.
     #   @param sizeFlags [Integer]  Indicates the interpretation of other parameters. It is a bit list of the following:
-    #     - {Wx::SIZE_AUTO_WIDTH}: a {Wx::DEFAULT_COORD} width value is taken to indicate a wxWidgets-supplied default width.- {Wx::SIZE_AUTO_HEIGHT}: a {Wx::DEFAULT_COORD} height value is taken to indicate a wxWidgets-supplied default height.- {Wx::SIZE_AUTO}: {Wx::DEFAULT_COORD} size values are taken to indicate a wxWidgets-supplied default size.- {Wx::SIZE_USE_EXISTING}: existing dimensions should be used if {Wx::DEFAULT_COORD} values are supplied.- {Wx::SIZE_ALLOW_MINUS_ONE}: allow negative dimensions (i.e. value of {Wx::DEFAULT_COORD}) to be interpreted as real dimensions, not default values.- {Wx::SIZE_FORCE}: normally, if the position and the size of the window are already the same as the parameters of this function, nothing is done. but with this flag a window resize may be forced even in this case (supported in wx 2.6.2 and later and only implemented for MSW and ignored elsewhere currently).
+    #     
+    #     - {Wx::SIZE_AUTO_WIDTH}: a {Wx::DEFAULT_COORD} width value is taken to indicate a wxWidgets-supplied default width.
+    #     - {Wx::SIZE_AUTO_HEIGHT}: a {Wx::DEFAULT_COORD} height value is taken to indicate a wxWidgets-supplied default height.
+    #     - {Wx::SIZE_AUTO}: {Wx::DEFAULT_COORD} size values are taken to indicate a wxWidgets-supplied default size.
+    #     - {Wx::SIZE_USE_EXISTING}: existing dimensions should be used if {Wx::DEFAULT_COORD} values are supplied.
+    #     - {Wx::SIZE_ALLOW_MINUS_ONE}: allow negative dimensions (i.e. value of {Wx::DEFAULT_COORD}) to be interpreted as real dimensions, not default values.
+    #     - {Wx::SIZE_FORCE}: normally, if the position and the size of the window are already the same as the parameters of this function, nothing is done. but with this flag a window resize may be forced even in this case (supported in wx 2.6.2 and later and only implemented for MSW and ignored elsewhere currently).
     #   @return [void]
     # @overload set_size(rect)
     #   Sets the size of the window in pixels.
@@ -1079,8 +1123,8 @@ module Wx
     # @overload move(x, y, flags=Wx::SIZE_USE_EXISTING)
     #   Moves the window to the given position.
     #   Implementations of SetSize can also implicitly implement the {Wx::Window#move} function, which is defined in the base {Wx::Window} class as the call: 
-    #   ```
-    #     SetSize(x, y, wxDefaultCoord, wxDefaultCoord, wxSIZE_USE_EXISTING);
+    #   ```ruby
+    #     set_size(x, y, Wx::DEFAULT_COORD, Wx::DEFAULT_COORD, Wx::SIZE_USE_EXISTING)
     #   ```
     #   @see Wx::Window#set_size 
     #   @param x [Integer]  Required x position.
@@ -1090,8 +1134,8 @@ module Wx
     # @overload move(pt, flags=Wx::SIZE_USE_EXISTING)
     #   Moves the window to the given position.
     #   Implementations of {Wx::Window#set_size} can also implicitly implement the {Wx::Window#move} function, which is defined in the base {Wx::Window} class as the call: 
-    #   ```
-    #     SetSize(x, y, wxDefaultCoord, wxDefaultCoord, wxSIZE_USE_EXISTING);
+    #   ```ruby
+    #     set_size(x, y, Wx::DEFAULT_COORD, Wx::DEFAULT_COORD, Wx::SIZE_USE_EXISTING)
     #   ```
     #   @see Wx::Window#set_size 
     #   @param pt [Array(Integer, Integer), Wx::Point]  {Wx::Point} object representing the position.
@@ -1114,10 +1158,7 @@ module Wx
     # @overload convert_dialog_to_pixels(pt)
     #   Converts a point or size from dialog units to pixels.
     #   For the x dimension, the dialog units are multiplied by the average character width and then divided by 4. For the y dimension, the dialog units are multiplied by the average character height and then divided by 8.
-    #   Dialog units are used for maintaining a dialog's proportions even if the font changes. You can also use these functions programmatically. A convenience macro is defined: 
-    #   ```
-    #     #define wxDLG_UNIT(parent, pt) parent->ConvertDialogToPixels(pt)
-    #   ```
+    #   Dialog units are used for maintaining a dialog's proportions even if the font changes. You can also use these functions programmatically.
     #   @see Wx::Window#convert_pixels_to_dialog 
     #   @param pt [Array(Integer, Integer), Wx::Point] 
     #   @return [Wx::Point]
@@ -1154,7 +1195,7 @@ module Wx
     # Freezes the window or, in other words, prevents any updates from taking place on screen, the window is not redrawn at all.
     # {Wx::Window#thaw} must be called to re-enable window redrawing. Calls to these two functions may be nested but to ensure that the window is properly repainted again, you must thaw it exactly as many times as you froze it.
     # If the window has any children, they are recursively frozen too.
-    # This method is useful for visual appearance optimization (for example, it is a good idea to use it before doing many large text insertions in a row into a {Wx::TextCtrl} under {Wx::GTK}) but is not implemented on all platforms nor for all controls so it is mostly just a hint to wxWidgets and not a mandatory directive.
+    # This method is useful for visual appearance optimization (for example, it is a good idea to use it before doing many large text insertions in a row into a {Wx::TextCtrl} under wxGTK) but is not implemented on all platforms nor for all controls so it is mostly just a hint to wxWidgets and not a mandatory directive.
     # @see Wx::WindowUpdateLocker
     # @see  Wx::Window#thaw
     # @see  Wx::Window#is_frozen 
@@ -1174,7 +1215,7 @@ module Wx
     # 
     # @see Wx::Window#freeze
     # @see  Wx::Window#thaw 
-    # @return [true,false]
+    # @return [Boolean]
     def is_frozen; end
     alias_method :frozen?, :is_frozen
     
@@ -1193,7 +1234,7 @@ module Wx
     # @see  Wx::Window#get_foreground_colour
     # @see  Wx::Window#set_background_style
     # @see  Wx::Window#set_transparent 
-    # @return [BackgroundStyle]
+    # @return [Wx::BackgroundStyle]
     def get_background_style; end
     alias_method :background_style, :get_background_style
     
@@ -1260,14 +1301,14 @@ module Wx
     
     # Returns true if this window background is transparent (as, for example, for {Wx::StaticText}) and should show the parent window background.
     # This method is mostly used internally by the library itself and you normally shouldn't have to call it. You may, however, have to override it in your {Wx::Window}-derived class to ensure that background is painted correctly.
-    # @return [true,false]
+    # @return [Boolean]
     def has_transparent_background; end
     alias_method :has_transparent_background?, :has_transparent_background
     
     # Causes this window, and all of its children recursively, to be repainted.
     # Note that repainting doesn't happen immediately but only during the next event loop iteration, if you need to update the window immediately you should use {Wx::Window#update} instead.
     # @see Wx::Window#refresh_rect 
-    # @param eraseBackground [true,false]  If true, the background will be erased too. Note that in non-MSW ports background is always erased.
+    # @param eraseBackground [Boolean]  If true, the background will be erased too. Note that in non-MSW ports background is always erased.
     # @param rect [Wx::Rect]  If non-NULL, only the given rectangle will be treated as damaged.
     # @return [void]
     def refresh(eraseBackground=true, rect=nil) end
@@ -1275,7 +1316,7 @@ module Wx
     # Redraws the contents of the given rectangle: only the area inside it will be repainted.
     # This is the same as {Wx::Window#refresh} but has a nicer syntax as it can be called with a temporary {Wx::Rect} object as argument like this <code>RefreshRect(wxRect(x, y, w, h))</code>.
     # @param rect [Wx::Rect] 
-    # @param eraseBackground [true,false] 
+    # @param eraseBackground [Boolean] 
     # @return [void]
     def refresh_rect(rect, eraseBackground=true) end
     
@@ -1299,36 +1340,33 @@ module Wx
     # @see  Wx::EraseEvent
     # @see  Wx::SystemSettings 
     # @param colour [Wx::Colour,String,Symbol]  The colour to be used as the background colour; pass {Wx::NULL_COLOUR} to reset to the default colour. Note that you may want to use {Wx::SystemSettings.get_colour} to retrieve a suitable colour to use rather than setting a hard-coded one.
-    # @return [true,false]
+    # @return [Boolean]
     def set_background_colour(colour) end
     alias_method :background_colour=, :set_background_colour
     
     # Sets the background style of the window.
     # The default background style is {Wx::BackgroundStyle::BG_STYLE_ERASE} which indicates that the window background may be erased in EVT_ERASE_BACKGROUND handler. This is a safe, compatibility default; however you may want to change it to {Wx::BackgroundStyle::BG_STYLE_SYSTEM} if you don't define any erase background event handlers at all, to avoid unnecessary generation of erase background events and always let system erase the background. And you should change the background style to {Wx::BackgroundStyle::BG_STYLE_PAINT} if you define an EVT_PAINT handler which completely overwrites the window background as in this case erasing it previously, either in EVT_ERASE_BACKGROUND handler or in the system default handler, would result in flicker as the background pixels will be repainted twice every time the window is redrawn. Do ensure that the background is entirely erased by your EVT_PAINT handler in this case however as otherwise garbage may be left on screen.
     # Notice that in previous versions of wxWidgets a common way to work around the above mentioned flickering problem was to define an empty EVT_ERASE_BACKGROUND handler. Setting background style to {Wx::BackgroundStyle::BG_STYLE_PAINT} is a simpler and more efficient solution to the same problem.
-    # Under {Wx::GTK} and {Wx::OSX}, you can use {Wx::BackgroundStyle::BG_STYLE_TRANSPARENT} to obtain full transparency of the window background. Note that {Wx::GTK} supports this only since GTK 2.12 with a compositing manager enabled, call {Wx::Window#is_transparent_background_supported} to check whether this is the case, see the example of doing it in the shapedsample".
+    # Under wxGTK and wxOSX, you can use {Wx::BackgroundStyle::BG_STYLE_TRANSPARENT} to obtain full transparency of the window background. Note that wxGTK supports this only since GTK 2.12 with a compositing manager enabled, call {Wx::Window#is_transparent_background_supported} to check whether this is the case, see the example of doing it in the shapedsample".
     # Also, in order for <code>SetBackgroundStyle(wxBG_STYLE_TRANSPARENT)</code> to work, it must be called before {Wx::Window#create}. If you're using your own {Wx::Window}-derived class you should write your code in the following way: 
-    # ```
-    #   class MyWidget : public wxWindow
-    #   {
-    #   public:
-    #       MyWidget(wxWindow* parent, ...)
-    #           : wxWindow() // Use default ctor here!
-    #       {
-    #           // Do this first:
-    #           SetBackgroundStyle(wxBG_STYLE_TRANSPARENT);
-    #   
-    #           // And really create the window afterwards:
-    #           Create(parent, ...);
-    #       }
-    #   };
+    # ```ruby
+    #   class MyWidget < Wx::Window
+    #     def initialize(parent, ...)
+    #       super() # Use default ctor here!
+    #        # Do this first:
+    #        set_background_style(Wx::BG_STYLE_TRANSPARENT)
+    # 
+    #        # And really create the window afterwards:
+    #        create(parent, ...)
+    #     end
+    #   end
     # ```
     # @see Wx::Window#set_background_colour
     # @see  Wx::Window#get_foreground_colour
     # @see  Wx::Window#set_transparent
     # @see  Wx::Window#is_transparent_background_supported 
-    # @param style [BackgroundStyle] 
-    # @return [true,false]
+    # @param style [Wx::BackgroundStyle] 
+    # @return [Boolean]
     def set_background_style(style) end
     alias_method :background_style=, :set_background_style
     
@@ -1338,7 +1376,7 @@ module Wx
     # 
     # true if background transparency is supported.
     # @param reason [String]  If not NULL, a reason message is provided if transparency is not supported.
-    # @return [true,false]
+    # @return [Boolean]
     def is_transparent_background_supported(reason=nil) end
     alias_method :transparent_background_supported?, :is_transparent_background_supported
     
@@ -1350,7 +1388,7 @@ module Wx
     # @see Wx::Window#get_font
     # @see  Wx::Window#inherit_attributes 
     # @param font [Wx::Font,Wx::FontInfo]  Font to associate with this window, pass {Wx::NULL_FONT} to reset to the default font.
-    # @return [true,false]
+    # @return [Boolean]
     def set_font(font) end
     alias_method :font=, :set_font
     
@@ -1364,7 +1402,7 @@ module Wx
     # @see  Wx::Window#get_background_colour
     # @see  Wx::Window#should_inherit_colours 
     # @param colour [Wx::Colour,String,Symbol]  The colour to be used as the foreground colour; pass {Wx::NULL_COLOUR} to reset to the default colour.
-    # @return [true,false]
+    # @return [Boolean]
     def set_foreground_colour(colour) end
     alias_method :foreground_colour=, :set_foreground_colour
     
@@ -1381,16 +1419,16 @@ module Wx
     # 
     # @see Wx::Window#set_own_background_colour
     # @see  Wx::Window#inherit_attributes 
-    # @return [true,false]
+    # @return [Boolean]
     def inherits_background_colour; end
     
     # Return true if a background colour has been set for this window.
-    # @return [true,false]
+    # @return [Boolean]
     def use_bg_col; end
     
     # Return true if a background colour has been set for this window.
     # Same as {Wx::Window#use_bg_col}
-    # @return [true,false]
+    # @return [Boolean]
     def use_background_colour; end
     
     # Sets the font of the window but prevents it from being inherited by the children of this window.
@@ -1412,27 +1450,27 @@ module Wx
     alias_method :own_foreground_colour=, :set_own_foreground_colour
     
     # Return true if a foreground colour has been set for this window.
-    # @return [true,false]
+    # @return [Boolean]
     def use_foreground_colour; end
     
     # Return true if this window inherits the foreground colour from its parent.
     # 
     # @see Wx::Window#set_own_foreground_colour
     # @see  Wx::Window#inherit_attributes 
-    # @return [true,false]
+    # @return [Boolean]
     def inherits_foreground_colour; end
     
     # Return true from here to allow the colours of this window to be changed by {Wx::Window#inherit_attributes}.
     # Returning false forbids inheriting them from the parent window.
     # The base class version returns false, but this method is overridden in {Wx::Control} where it returns true.
-    # @return [true,false]
+    # @return [Boolean]
     def should_inherit_colours; end
     
     # This function tells a window if it should use the system's "theme" code to draw the windows' background instead of its own background drawing code.
     # This does not always have any effect since the underlying platform obviously needs to support the notion of themes in user defined windows. One such platform is GTK+ where windows can have (very colourful) backgrounds defined by a user's selected theme.
     # Dialogs, notebook pages and the status bar have this flag set to true by default so that the default look and feel is simulated best.
     # @see Wx::Window#get_theme_enabled 
-    # @param enable [true,false] 
+    # @param enable [Boolean] 
     # @return [void]
     def set_theme_enabled(enable) end
     alias_method :theme_enabled=, :set_theme_enabled
@@ -1440,13 +1478,13 @@ module Wx
     # Returns true if the window uses the system theme for drawing its background.
     # 
     # @see Wx::Window#set_theme_enabled 
-    # @return [true,false]
+    # @return [Boolean]
     def get_theme_enabled; end
     alias_method :theme_enabled, :get_theme_enabled
     
     # Returns true if the system supports transparent windows and calling {Wx::Window#set_transparent} may succeed.
     # If this function returns false, transparent windows are definitely not supported by the current system.
-    # @return [true,false]
+    # @return [Boolean]
     def can_set_transparent; end
     alias_method :can_set_transparent?, :can_set_transparent
     
@@ -1454,7 +1492,7 @@ module Wx
     # If the system supports transparent windows, returns true, otherwise returns false and the window remains fully opaque. See also {Wx::Window#can_set_transparent}.
     # The parameter alpha is in the range 0..255 where 0 corresponds to a fully transparent window and 255 to the fully opaque one. The constants {Wx::IMAGE_ALPHA_TRANSPARENT} and {Wx::IMAGE_ALPHA_OPAQUE} can be used.
     # @param alpha [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def set_transparent(alpha) end
     alias_method :transparent=, :set_transparent
     
@@ -1473,41 +1511,41 @@ module Wx
     # Returns true if the key pressed was for navigation and was handled, false otherwise.
     # @see Wx::Window#navigate 
     # @param event [Wx::KeyEvent] 
-    # @return [true,false]
+    # @return [Boolean]
     def handle_as_navigation_key(event) end
     
     # Shorthand for:
-    # ```
-    #   GetEventHandler()->SafelyProcessEvent(event);
+    # ```ruby
+    #   get_event_handler.safely_process_event(event)
     # ```
     # @see Wx::Window#process_window_event 
     # @param event [Wx::Event] 
-    # @return [true,false]
+    # @return [Boolean]
     def handle_window_event(event) end
     
     # Convenient wrapper for {Wx::Window#process_event}.
     # This is the same as writing 
-    # ```
-    #   GetEventHandler()->ProcessEvent(event);
+    # ```ruby
+    #   get_event_handler.process_event(event)
     # ```
     #  but more convenient. Notice that {Wx::Window#process_event} itself can't be called for {Wx::Window} objects as it ignores the event handlers associated with the window; use this function instead.
     # @param event [Wx::Event] 
-    # @return [true,false]
+    # @return [Boolean]
     def process_window_event(event) end
     
     # Wrapper for {Wx::EvtHandler#process_event_locally}.
     # This method is similar to {Wx::Window#process_window_event} but can be used to search for the event handler only in this window and any event handlers pushed on top of it. Unlike {Wx::Window#process_window_event} it won't propagate the event upwards. But it will use the validator and event handlers associated with this window, if any.
     # @param event [Wx::Event] 
-    # @return [true,false]
+    # @return [Boolean]
     def process_window_event_locally(event) end
     
     # Pushes this event handler onto the event stack for the window.
     # An event handler is an object that is capable of processing the events sent to a window. By default, the window is its own event handler, but an application may wish to substitute another, for example to allow central implementation of event-handling for a variety of different window classes.
     # {Wx::Window#push_event_handler} allows an application to set up a stack of event handlers, where an event not handled by one event handler is handed to the next one in the chain.
     # E.g. if you have two event handlers A and B and a {Wx::Window} instance W and you call: 
-    # ```
-    #   W->PushEventHandler(A);
-    #   W->PushEventHandler(B);
+    # ```ruby
+    #   W.push_event_handler(A)
+    #   W.push_event_handler(B)
     # ```
     #  you will end up with the following situation: 
     # 
@@ -1524,7 +1562,7 @@ module Wx
     # @see Wx::Window#push_event_handler
     # @see  Wx::Window#pop_event_handler 
     # @param handler [Wx::EvtHandler]  The event handler to remove, must be non-NULL and must be present in this windows event handlers stack.
-    # @return [true,false]
+    # @return [Boolean]
     def remove_event_handler(handler) end
     
     # Sets the event handler for this window.
@@ -1569,13 +1607,13 @@ module Wx
     # 
     # @see Wx::Window#set_extra_style 
     # @param exFlag [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def has_extra_style(exFlag) end
     alias_method :has_extra_style?, :has_extra_style
     
     # Returns true if the window has the given flag bit set.
     # @param flag [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def has_flag(flag) end
     alias_method :has_flag?, :has_flag
     
@@ -1608,7 +1646,7 @@ module Wx
     # @see Wx::Window#set_window_style_flag
     # @see  Wx::Window#has_flag 
     # @param flag [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def toggle_window_style(flag) end
     
     # Moves this window in the tab navigation order after the specified win.
@@ -1630,13 +1668,13 @@ module Wx
     # 
     # You may wish to call this from a text control custom keypress handler to do the default navigation behaviour for the tab key, since the standard default behaviour for a multiline text control with the {Wx::TE_PROCESS_TAB} style is to insert a tab and not navigate to the next control. See also {Wx::NavigationKeyEvent} and HandleAsNavigationKey.
     # @param flags [Integer]  A combination of {Wx::NavigationKeyEvent::IsForward} and {Wx::NavigationKeyEvent::WinChange}.
-    # @return [true,false]
+    # @return [Boolean]
     def navigate(flags=Wx::NavigationKeyEvent::IsForward) end
     
     # Performs a keyboard navigation action inside this window.
     # See {Wx::Window#navigate} for more information.
     # @param flags [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def navigate_in(flags=Wx::NavigationKeyEvent::IsForward) end
     
     # Lowers the window to the bottom of the window hierarchy (Z-order).
@@ -1653,20 +1691,20 @@ module Wx
     def raise; end
     
     # Equivalent to calling {Wx::Window#show}(false).
-    # @return [true,false]
+    # @return [Boolean]
     def hide; end
     
     # This function hides a window, like {Wx::Window#hide}, but using a special visual effect if possible.
     # The parameters of this function are the same as for {Wx::Window#show_with_effect}, please see their description there.
-    # @param effect [ShowEffect] 
+    # @param effect [Wx::ShowEffect] 
     # @param timeout [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def hide_with_effect(effect, timeout=0) end
     
     # Returns true if the window is enabled, i.e. if it accepts user input, false otherwise.
     # Notice that this method can return false even if this window itself hadn't been explicitly disabled when one of its parent windows is disabled. To get the intrinsic status of this window, use {Wx::Window#is_this_enabled}
     # @see Wx::Window#enable 
-    # @return [true,false]
+    # @return [Boolean]
     def is_enabled; end
     alias_method :enabled?, :is_enabled
     
@@ -1675,60 +1713,60 @@ module Wx
     #   Call this in a paint event handler to optimize redrawing by only redrawing those areas, which have been exposed.
     #   @param x [Integer] 
     #   @param y [Integer] 
-    #   @return [true,false]
+    #   @return [Boolean]
     # @overload is_exposed(pt)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param pt [Array(Integer, Integer), Wx::Point] 
-    #   @return [true,false]
+    #   @return [Boolean]
     # @overload is_exposed(x, y, w, h)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param x [Integer] 
     #   @param y [Integer] 
     #   @param w [Integer] 
     #   @param h [Integer] 
-    #   @return [true,false]
+    #   @return [Boolean]
     # @overload is_exposed(rect)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param rect [Wx::Rect] 
-    #   @return [true,false]
+    #   @return [Boolean]
     def is_exposed(*args) end
     alias_method :exposed?, :is_exposed
     
     # Returns true if the window is shown, false if it has been hidden.
     # 
     # @see Wx::Window#is_shown_on_screen 
-    # @return [true,false]
+    # @return [Boolean]
     def is_shown; end
     alias_method :shown?, :is_shown
     
     # Returns true if the window is physically visible on the screen, i.e. it is shown and all its parents up to the toplevel window are shown as well.
     # 
     # @see Wx::Window#is_shown 
-    # @return [true,false]
+    # @return [Boolean]
     def is_shown_on_screen; end
     alias_method :shown_on_screen?, :is_shown_on_screen
     
     # Disables the window.
     # Same as {Wx::Window#enable} Enable(false).
     # Returns true if the window has been disabled, false if it had been already disabled before the call to this function.
-    # @return [true,false]
+    # @return [Boolean]
     def disable; end
     
     # Enable or disable the window for user input.
     # Note that when a parent window is disabled, all of its children are disabled as well and they are re-enabled again when the parent is.
     # A window can be created initially disabled by calling this method on it before calling {Wx::Window#create} to create the actual underlying window, e.g. 
-    # ```
-    #   wxWindow* w = new MyWindow(); // Note: default ctor is used here.
-    #   w->Enable(false);
-    #   w->Create(parent, ... all the usual non-default ctor arguments ...);
+    # ```ruby
+    #   w = MyWindow.new # Note: default ctor is used here.
+    #   w.enable(false)
+    #   w.create(parent, ... all the usual non-default ctor arguments ...)
     # ```
     # 
     # Returns true if the window has been enabled or disabled, false if nothing was done, i.e. if the window had already been in the specified state.
     # @see Wx::Window#is_enabled
     # @see  Wx::Window#disable
     # @see  Wx::RadioBox#enable 
-    # @param enable [true,false]  If true, enables the window for input. If false, disables the window.
-    # @return [true,false]
+    # @param enable [Boolean]  If true, enables the window for input. If false, disables the window.
+    # @return [Boolean]
     def enable(enable=true) end
     
     # Shows or hides the window.
@@ -1740,16 +1778,16 @@ module Wx
     # @see  Wx::Window#hide
     # @see  Wx::RadioBox#show
     # @see  Wx::ShowEvent. 
-    # @param show [true,false]  If true displays the window. Otherwise, hides it.
-    # @return [true,false]
+    # @param show [Boolean]  If true displays the window. Otherwise, hides it.
+    # @return [Boolean]
     def show(show=true) end
     
     # This function shows a window, like {Wx::Window#show}, but using a special visual effect if possible.
-    # Currently this function is only implemented in {Wx::MSW} and {Wx::OSX} and does the same thing as {Wx::Window#show} in the other ports.
+    # Currently this function is only implemented in wxMSW and wxOSX and does the same thing as {Wx::Window#show} in the other ports.
     # @see Wx::Window#hide_with_effect 
-    # @param effect [ShowEffect]  The effect to use.
+    # @param effect [Wx::ShowEffect]  The effect to use.
     # @param timeout [Integer]  The timeout parameter specifies the time of the animation, in milliseconds. If the default value of 0 is used, the default animation time for the current platform is used.
-    # @return [true,false]
+    # @return [Boolean]
     def show_with_effect(effect, timeout=0) end
     
     # Gets the help text to be used as context-sensitive help for this window.
@@ -1773,7 +1811,7 @@ module Wx
     # Gets the help text to be used as context-sensitive help for this window.
     # This method should be overridden if the help message depends on the position inside the window, otherwise {Wx::Window#get_help_text} can be used.
     # @param point [Array(Integer, Integer), Wx::Point]  Coordinates of the mouse at the moment of help event emission.
-    # @param origin [Wx::HelpEvent::Origin]  Help event origin, see also {Wx::HelpEvent#get_origin}.
+    # @param origin [Wx::wxHelpEvent::Origin]  Help event origin, see also {Wx::HelpEvent#get_origin}.
     # @return [String]
     def get_help_text_at_point(point, origin) end
     alias_method :help_text_at_point, :get_help_text_at_point
@@ -1813,7 +1851,7 @@ module Wx
     #   This function shows a popup menu at the given position in this window and returns the selected id.
     #   It can be more convenient than the general purpose {Wx::Window#popup_menu} function for simple menus proposing a choice in a list of strings to the user.
     #   Notice that to avoid unexpected conflicts between the (usually consecutive range of) ids used by the menu passed to this function and the existing EVT_UPDATE_UI() handlers, this function temporarily disables UI updates for the window, so you need to manually disable (or toggle or ...) any items which should be disabled in the menu before showing it.
-    #   The parameter menu is the menu to show. The parameter pos (or the parameters x and y) is the position at which to show the menu in client coordinates. It is recommended to not explicitly specify coordinates when calling this method in response to mouse click, because some of the ports (namely, {Wx::GTK}) can do a better job of positioning the menu in that case.
+    #   The parameter menu is the menu to show. The parameter pos (or the parameters x and y) is the position at which to show the menu in client coordinates. It is recommended to not explicitly specify coordinates when calling this method in response to mouse click, because some of the ports (namely, wxGTK) can do a better job of positioning the menu in that case.
     #   The selected menu item id or {Wx::StandardID::ID_NONE} if none selected or an error occurred.
     #   @param menu [Wx::Menu] 
     #   @param pos [Array(Integer, Integer), Wx::Point] 
@@ -1833,17 +1871,17 @@ module Wx
     #   menu is the menu to pop up.
     #   The position where the menu will appear can be specified either as a {Wx::Point} pos or by two integers (x and y).
     #   Note that this function switches focus to this window before showing the menu.
-    #   Just before the menu is popped up, {Wx::Menu::UpdateUI} is called to ensure that the menu items are in the correct state. The menu does not get deleted by the window. It is recommended to not explicitly specify coordinates when calling PopupMenu in response to mouse click, because some of the ports (namely, {Wx::GTK}) can do a better job of positioning the menu in that case.
+    #   Just before the menu is popped up, {Wx::Menu::UpdateUI} is called to ensure that the menu items are in the correct state. The menu does not get deleted by the window. It is recommended to not explicitly specify coordinates when calling PopupMenu in response to mouse click, because some of the ports (namely, wxGTK) can do a better job of positioning the menu in that case.
     #   @see Wx::Menu 
     #   @param menu [Wx::Menu] 
     #   @param pos [Array(Integer, Integer), Wx::Point] 
-    #   @return [true,false]
+    #   @return [Boolean]
     # @overload popup_menu(menu, x, y)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param menu [Wx::Menu] 
     #   @param x [Integer] 
     #   @param y [Integer] 
-    #   @return [true,false]
+    #   @return [Boolean]
     def popup_menu(*args) end
     
     # Validator functions.
@@ -1864,7 +1902,7 @@ module Wx
     # @see Wx::Window#transfer_data_from_window
     # @see  Wx::Window#transfer_data_to_window
     # @see  Wx::Validator 
-    # @return [true,false]
+    # @return [Boolean]
     def validate; end
     
     # Returns the identifier of the window.
@@ -1882,7 +1920,7 @@ module Wx
     alias_method :label, :get_label
     
     # Returns the layout direction for this window, Note that {Wx::LayoutDirection::Layout_Default} is returned if layout direction is not supported.
-    # @return [LayoutDirection]
+    # @return [Wx::LayoutDirection]
     def get_layout_direction; end
     alias_method :layout_direction, :get_layout_direction
     
@@ -1901,7 +1939,7 @@ module Wx
     alias_method :name, :get_name
     
     # Returns the value previously passed to {Wx::Window#set_window_variant}.
-    # @return [WindowVariant]
+    # @return [Wx::WindowVariant]
     def get_window_variant; end
     alias_method :window_variant, :get_window_variant
     
@@ -1924,7 +1962,7 @@ module Wx
     
     # Sets the layout direction for this window.
     # This function is only supported under MSW and GTK platforms, but not under Mac currently.
-    # @param dir [LayoutDirection] 
+    # @param dir [Wx::LayoutDirection] 
     # @return [void]
     def set_layout_direction(dir) end
     alias_method :layout_direction=, :set_layout_direction
@@ -1940,7 +1978,7 @@ module Wx
     # Chooses a different variant of the window display to use.
     # Window variants currently just differ in size, as can be seen from {Wx::WindowVariant} documentation. Under all platforms but macOS, this function does nothing more than change the font used by the window. However under macOS it is implemented natively and selects the appropriate variant of the native widget, which has better appearance than just scaled down or up version of the normal variant, so it should be preferred to directly tweaking the font size.
     # By default the controls naturally use the normal variant.
-    # @param variant [WindowVariant] 
+    # @param variant [Wx::WindowVariant] 
     # @return [void]
     def set_window_variant(variant) end
     alias_method :window_variant=, :set_window_variant
@@ -1974,20 +2012,20 @@ module Wx
     # @see Window Deletion Overview
     # @see  Wx::Window#destroy
     # @see  Wx::CloseEvent 
-    # @param force [true,false]  false if the window's close handler should be able to veto the destruction of this window, true if it cannot.
-    # @return [true,false]
+    # @param force [Boolean]  false if the window's close handler should be able to veto the destruction of this window, true if it cannot.
+    # @return [Boolean]
     def close(force=false) end
     
     # Destroys the window safely.
     # Use this function instead of the delete operator, since different window classes can be destroyed differently. Frames and dialogs are not destroyed immediately when this function is called  they are added to a list of windows to be deleted on idle time, when all the window's events have been processed. This prevents problems with events being sent to non-existent windows.
     # true if the window has either been successfully deleted, or it has been added to the list of windows pending real deletion.
-    # @return [true,false]
+    # @return [Boolean]
     def destroy; end
     
     # Returns true if this window is in process of being destroyed.
     # Top level windows are not deleted immediately but are rather scheduled for later destruction to give them time to process any pending messages; see {Wx::Window#destroy} description.
     # This function returns true if this window, or one of its parent windows, is scheduled for destruction and can be useful to avoid manipulating it as it's usually useless to do something with a window which is at the point of disappearing anyhow.
-    # @return [true,false]
+    # @return [Boolean]
     def is_being_deleted; end
     alias_method :being_deleted?, :is_being_deleted
     
@@ -2011,7 +2049,7 @@ module Wx
     # Enables or disables eligibility for drop file events (OnDropFiles).
     # Windows only until version 2.8.9, available on all platforms since 2.8.10. Cannot be used together with {Wx::Window#set_drop_target} on non-Windows platforms.
     # @see Wx::Window#set_drop_target 
-    # @param accept [true,false]  If true, the window is eligible for drop file events. If false, the window will not accept drop file events.
+    # @param accept [Boolean]  If true, the window is eligible for drop file events. If false, the window will not accept drop file events.
     # @return [void]
     def drag_accept_files(accept) end
     
@@ -2042,32 +2080,27 @@ module Wx
     def set_sizer_and_fit(sizer) end
     alias_method :sizer_and_fit=, :set_sizer_and_fit
     
-    # Returns a pointer to the window's layout constraints, or NULL if there are none.
-    # @return [Wx::LayoutConstraints]
-    def get_constraints; end
-    alias_method :constraints, :get_constraints
-    
     # Lays out the children of this window using the associated sizer.
     # If a sizer hadn't been associated with this window (see {Wx::Window#set_sizer}), this function doesn't do anything, unless this is a top level window (see {Wx::TopLevelWindow#layout}).
     # Note that this method is called automatically when the window size changes if it has the associated sizer (or if {Wx::Window#set_auto_layout} with true argument had been explicitly called), ensuring that it is always laid out correctly.
     # 
     # Always returns true, the return value is not useful.
     # @see Window Sizing Overview
-    # @return [true,false]
+    # @return [Boolean]
     def layout; end
     
     # Determines whether the {Wx::Window#layout} function will be called automatically when the window is resized.
     # This method is called implicitly by {Wx::Window#set_sizer} but if you use {Wx::Window#set_constraints} you should call it manually or otherwise the window layout won't be correctly updated when its size changes.
     # @see Wx::Window#set_sizer
     # @see  Wx::Window#set_constraints 
-    # @param autoLayout [true,false]  Set this to true if you wish the {Wx::Window#layout} function to be called automatically when the window is resized.
+    # @param autoLayout [Boolean]  Set this to true if you wish the {Wx::Window#layout} function to be called automatically when the window is resized.
     # @return [void]
     def set_auto_layout(autoLayout) end
     alias_method :auto_layout=, :set_auto_layout
     
     # Returns true if {Wx::Window#layout} is called automatically when the window is resized.
     # This function is mostly useful for wxWidgets itself and is rarely needed in the application code.
-    # @return [true,false]
+    # @return [Boolean]
     def get_auto_layout; end
     alias_method :auto_layout, :get_auto_layout
     
@@ -2098,7 +2131,7 @@ module Wx
     # @see  Wx::Window#release_mouse
     # @see  Wx::MouseCaptureLostEvent
     # @see  Wx::MouseCaptureChangedEvent 
-    # @return [true,false]
+    # @return [Boolean]
     def has_capture; end
     alias_method :has_capture?, :has_capture
     
@@ -2124,7 +2157,7 @@ module Wx
     # @see Wx::SetCursor
     # @see  Wx::Cursor 
     # @param cursor [Wx::Cursor]  Specifies the cursor that the window should normally display.
-    # @return [true,false]
+    # @return [Boolean]
     def set_cursor(cursor) end
     alias_method :cursor=, :set_cursor
     
@@ -2137,14 +2170,14 @@ module Wx
     
     # Request generation of touch events for this window.
     # Each call to this function supersedes the previous ones, i.e. if you want to receive events for both zoom and rotate gestures, you need to call 
-    # ```
-    #   EnableTouchEvents(wxTOUCH_ZOOM_GESTURE | wxTOUCH_ROTATE_GESTURE);
+    # ```ruby
+    #   enable_touch_events(Wx::TOUCH_ZOOM_GESTURE | Wx::TOUCH_ROTATE_GESTURE)
     # ```
     #  instead of calling it twice in a row as the second call would disable the first gesture.
     # 
     # true if the specified events were enabled or false if the current platform doesn't support touch events.
     # @param eventsMask [Integer]  Either {Wx::TOUCH_NONE} or {Wx::TOUCH_ALL_GESTURES} to disable or enable gesture events for this window.
-    # @return [true,false]
+    # @return [Boolean]
     def enable_touch_events(eventsMask) end
     
     # @overload hit_test(x, y)
@@ -2153,39 +2186,39 @@ module Wx
     #   The point coordinates are specified in client window coordinates.
     #   @param x [Integer] 
     #   @param y [Integer] 
-    #   @return [HitTest]
+    #   @return [Wx::HitTest]
     # @overload hit_test(pt)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param pt [Array(Integer, Integer), Wx::Point] 
-    #   @return [HitTest]
+    #   @return [Wx::HitTest]
     def hit_test(*args) end
     
     # @overload get_border(flags)
     #   Get the window border style from the given flags: this is different from simply doing flags & {Wx::Border::BORDER_MASK} because it uses GetDefaultBorder() to translate {Wx::Border::BORDER_DEFAULT} to something reasonable.
     #   @param flags [Integer] 
-    #   @return [Border]
+    #   @return [Wx::Border]
     # @overload get_border()
     #   Get border for the flags of this window.
-    #   @return [Border]
+    #   @return [Wx::Border]
     def get_border(*args) end
     alias_method :border, :get_border
     
     # Does the window-specific updating after processing the update event.
     # This function is called by {Wx::Window#update_window_ui} in order to check return values in the {Wx::UpdateUIEvent} and act appropriately. For example, to allow frame and dialog title updating, wxWidgets implements this function as follows:
     # 
-    # ```
-    #   // do the window-specific processing after processing the update event
-    #   void wxTopLevelWindowBase::DoUpdateWindowUI(wxUpdateUIEvent& event)
-    #   {
-    #       if ( event.GetSetEnabled() )
-    #           Enable(event.GetEnabled());
+    # ```ruby
+    #   # do the window-specific processing after processing the update event
+    #   def Wx::TopLevelWindow.do_update_window_ui(event)
+    #     if event.get_set_enabled
+    #       enable(event.get_enabled)
+    #     end
     #   
-    #       if ( event.GetSetText() )
-    #       {
-    #           if ( event.GetText() != GetTitle() )
-    #               SetTitle(event.GetText());
-    #       }
-    #   }
+    #     if event.get_set_text
+    #       if event.get_text != get_title
+    #         set_title(event.get_text)
+    #       end
+    #     end
+    #   end
     # ```
     # @param event [Wx::UpdateUIEvent] 
     # @return [void]
@@ -2193,7 +2226,7 @@ module Wx
     
     # This method should be overridden to return true if this window has multiple pages.
     # All standard class with multiple pages such as {Wx::Notebook}, {Wx::Listbook} and {Wx::Treebook} already override it to return true and user-defined classes with similar behaviour should also do so, to allow the library to handle such windows appropriately.
-    # @return [true,false]
+    # @return [Boolean]
     def has_multiple_pages; end
     alias_method :has_multiple_pages?, :has_multiple_pages
     
@@ -2210,31 +2243,31 @@ module Wx
     # Returns true if the window contents is double-buffered by the system, i.e. if any drawing done on the window is really done on a temporary backing surface and transferred to the screen all at once later.
     # 
     # @see Wx::BufferedDC 
-    # @return [true,false]
+    # @return [Boolean]
     def is_double_buffered; end
     alias_method :double_buffered?, :is_double_buffered
     
     # Turn on or off double buffering of the window if the system supports it.
-    # @param on [true,false] 
+    # @param on [Boolean] 
     # @return [void]
     def set_double_buffered(on) end
     alias_method :double_buffered=, :set_double_buffered
     
     # Returns true if the window is retained, false otherwise.
     # Retained windows are only available on X platforms.
-    # @return [true,false]
+    # @return [Boolean]
     def is_retained; end
     alias_method :retained?, :is_retained
     
     # Returns true if this window is intrinsically enabled, false otherwise, i.e. if {Wx::Window#enable} Enable(false) had been called.
     # This method is mostly used for wxWidgets itself, user code should normally use {Wx::Window#is_enabled} instead.
-    # @return [true,false]
+    # @return [Boolean]
     def is_this_enabled; end
     alias_method :this_enabled?, :is_this_enabled
     
     # Returns true if the given window is a top-level one.
     # Currently all frames and dialogs are considered to be top-level windows (even if they have a parent window).
-    # @return [true,false]
+    # @return [Boolean]
     def is_top_level; end
     alias_method :top_level?, :is_top_level
     
@@ -2254,7 +2287,7 @@ module Wx
     # @param hotkeyId [Integer]  Numeric identifier of the hotkey. For applications this must be between 0 and 0xBFFF. If this function is called from a shared DLL, it must be a system wide unique identifier between 0xC000 and 0xFFFF. This is a MSW specific detail.
     # @param modifiers [Integer]  A bitwise combination of {Wx::KeyModifier::MOD_SHIFT}, {Wx::KeyModifier::MOD_CONTROL}, {Wx::KeyModifier::MOD_ALT} or {Wx::KeyModifier::MOD_WIN} specifying the modifier keys that have to be pressed along with the key.
     # @param virtualKeyCode [Integer]  The key code of the hotkey, e.g. an ASCII character such as <code>'K'</code> or one of elements of {Wx::KeyCode} enum.
-    # @return [true,false]
+    # @return [Boolean]
     def register_hot_key(hotkeyId, modifiers, virtualKeyCode) end
     
     # Unregisters a system wide hotkey.
@@ -2263,7 +2296,7 @@ module Wx
     # This function is currently only implemented under MSW.
     # @see Wx::Window#register_hot_key 
     # @param hotkeyId [Integer]  Numeric identifier of the hotkey. Must be the same id that was passed to {Wx::Window#register_hot_key}.
-    # @return [true,false]
+    # @return [Boolean]
     def unregister_hot_key(hotkeyId) end
     
     # This function sends one or more {Wx::UpdateUIEvent} to the window.
@@ -2271,12 +2304,14 @@ module Wx
     # You can call this function from your application to ensure that your UI is up-to-date at this point (as far as your {Wx::UpdateUIEvent} handlers are concerned). This may be necessary if you have called {Wx::UpdateUIEvent.set_mode} or {Wx::UpdateUIEvent.set_update_interval} to limit the overhead that wxWidgets incurs by sending update UI events in idle time. flags should be a bitlist of one or more of the {Wx::UpdateUI} enumeration.
     # If you are calling this function from an OnInternalIdle or OnIdle function, make sure you pass the {Wx::UpdateUI::UPDATE_UI_FROMIDLE} flag, since this tells the window to only update the UI elements that need to be updated in idle time. Some windows update their elements only when necessary, for example when a menu is about to be shown. The following is an example of how to call UpdateWindowUI from an idle function.
     # 
-    # ```
-    #   void MyWindow::OnInternalIdle()
-    #   {
-    #       if (wxUpdateUIEvent::CanUpdate(this))
-    #           UpdateWindowUI(wxUPDATE_UI_FROMIDLE);
-    #   }
+    # ```ruby
+    #   class MyWindow
+    #     ...
+    #     def on_internal_idle
+    #       update_window_ui(Wx::UPDATE_UI_FROMIDLE) if Wx::UpdateUIEvent.can_update(self)
+    #     end
+    #     ...
+    #   end
     # ```
     # @see Wx::UpdateUIEvent
     # @see  Wx::Window#do_update_window_ui
@@ -2291,7 +2326,7 @@ module Wx
     # This static method is "overridden" in many derived classes and so calling, for example, {Wx::Button#get_class_default_attributes} will typically return the values appropriate for a button which will be normally different from those returned by, say, {Wx::ListCtrl#get_class_default_attributes}.
     # The {Wx::VisualAttributes} structure has at least the fields font, colFg and colBg. All of them may be invalid if it was not possible to determine the default control appearance or, especially for the background colour, if the field doesn't make sense as is the case for colBg for the controls with themed background.
     # @see Wx::Window#inherit_attributes 
-    # @param variant [WindowVariant] 
+    # @param variant [Wx::WindowVariant] 
     # @return [Wx::VisualAttributes]
     def self.get_class_default_attributes(variant=Wx::WindowVariant::WINDOW_VARIANT_NORMAL) end
     
@@ -2367,7 +2402,7 @@ module Wx
     
     # @overload initialize()
     #   Default constructor.
-    #   @return [Window]
+    #   @return [Wx::Window]
     # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=Wx::PanelNameStr)
     #   Constructs a window, which can be a child of a frame, dialog or any other non-control window.
     #   @param parent [Wx::Window]  Pointer to a parent window.
@@ -2376,41 +2411,51 @@ module Wx
     #   @param size [Array(Integer, Integer), Wx::Size]  Window size. {Wx::DEFAULT_SIZE} indicates that wxWidgets should generate a default size for the window. If no suitable size can be found, the window will be sized to 20x20 pixels so that the window is visible but obviously not correctly sized.
     #   @param style [Integer]  Window style. For generic window styles, please see {Wx::Window}.
     #   @param name [String]  Window name.
-    #   @return [Window]
+    #   @return [Wx::Window]
     def initialize(*args) end
     
     # Construct the actual window object after creating the C++ object.
     # The non-default constructor of {Wx::Window} class does two things: it initializes the C++ object and it also creates the window object in the underlying graphical toolkit. The {Wx::Window#create} method can be used to perform the second part later, while the default constructor can be used to perform the first part only.
     # Please note that the underlying window must be created exactly once, i.e. if you use the default constructor, which doesn't do this, you must call {Wx::Window#create} before using the window and if you use the non-default constructor, you can not call {Wx::Window#create}, as the underlying window is already created.
     # Note that it is possible and, in fact, useful, to call some methods on the object between creating the C++ object itself and calling {Wx::Window#create} on it, e.g. a common pattern to avoid showing the contents of a window before it is fully initialized is: 
-    # ```
-    #   wxPanel* panel = new wxPanel(); // Note: default constructor used.
-    #   panel->Hide(); // Can be called before actually creating it.
-    #   panel->Create(parent, wxID_ANY, ...); // Won't be shown yet.
+    # ```ruby
+    #   panel = Wx::Panel.new   # Note: default constructor used.
+    #   panel.hide  # Can be called before actually creating it.
+    #   panel.create(parent, Wx::ID_ANY, ...)   # Won't be shown yet.
     #   ... create all the panel children ...
-    #   panel->Show(); // Now everything will be shown at once.
+    #   panel.show  # Now everything will be shown at once.
     # ```
     # 
     # Also note that it is possible to create an object of a derived type and then call {Wx::Window#create} on it: 
-    # ```
-    #   // Suppose we have this function (which would typically be in a
-    #   // different translation unit (file) from the rest of the code).
-    #   wxWindow* MyCreateWindowObjectFunction() {
-    #       return new MyCustomClassDerivingFromWindow();
-    #   }
+    # ```ruby
+    #   # Suppose we have this function (which would typically be in a
+    #   # different file from the rest of the code).
+    #   def my_create_window_object_function
+    #      MyCustomClassDerivingFromWindow.new
+    #   end
     #   
-    #   // Then we can create a window of MyCustomClassDerivingFromWindow
-    #   // class without really knowing about this type, as we would have
-    #   // to do if we wanted to use the non-default constructor, like this:
+    #   # Then we can create a window of MyCustomClassDerivingFromWindow
+    #   # class without really knowing about this type, as we would have
+    #   # to do if we wanted to use the non-default constructor, like this:
     #   
-    #   // First create the C++ object using the factory function.
-    #   wxWindow* window = MyCreateWindowObjectFunction();
+    #   # First create the C++ object using the factory function.
+    #   window = my_create_window_object_function
     #   
-    #   // And now create the underlying window.
-    #   //
-    #   // This calls the base wxWindow::Create() as it is not virtual, so
-    #   // the derived class can't customize this part.
-    #   window->Create(parent, wxID_ANY, ...);
+    #   # And now create the underlying window.
+    #   #
+    #   # This should call the base Wx::Window#create.
+    #   # In C++ (wxWidgets) this method is not virtual and cannot be overloaded
+    #   # so the derived class can't customize this part.
+    #   # In wxRuby however this method can be overloaded as long as the following
+    #   # is kept in mind:
+    #   # 1. the overloaded version will **NOT** be called when using a non-default
+    #   #    constructor (Create will than be called from C++ which will always be 
+    #   #    the base Wx::Window version);
+    #   # 2. when calling the overloaded version from Ruby understand that the window
+    #   #    will not actually be created until after the `super` version has been called.
+    #   # In general it's best not to overload this method but to define a different method
+    #   # if a custom initializer is needed.
+    #   window.create(parent, Wx::ID_ANY, ...)
     # ```
     #  This is notably used by XML Based Resource System (XRC).
     # The parameters of this method have exactly the same meaning as the non-default constructor parameters, please refer to them for their description.
@@ -2421,10 +2466,55 @@ module Wx
     # @param size [Array(Integer, Integer), Wx::Size] 
     # @param style [Integer] 
     # @param name [String] 
-    # @return [true,false]
+    # @return [Boolean]
     def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=Wx::PanelNameStr) end
     
   end # Window
   
+  # Struct containing all the visual attributes of a control.
+  # 
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class VisualAttributes < ::Object
+  
+    # The font used for control label/text inside it.
+    # 
+    # 
+    # @return [Wx::Font]
+    def font; end
+    # The font used for control label/text inside it.
+    # 
+    # 
+    # @param val [Wx::Font]
+    # @return [void]
+    def font=(val); end
+    
+    # The foreground colour.
+    # 
+    # 
+    # @return [Wx::Colour]
+    def col_fg; end
+    # The foreground colour.
+    # 
+    # 
+    # @param val [Wx::Colour]
+    # @return [void]
+    def col_fg=(val); end
+    
+    # The background colour.
+    # May be {Wx::NULL_COLOUR} if the controls background colour is not solid.
+    # 
+    # @return [Wx::Colour]
+    def col_bg; end
+    # The background colour.
+    # May be {Wx::NULL_COLOUR} if the controls background colour is not solid.
+    # 
+    # @param val [Wx::Colour]
+    # @return [void]
+    def col_bg=(val); end
+    
+  end # VisualAttributes
+  
 
 end