wxruby3 0.9.1-x64-mingw-ucrt → 0.9.3-x64-mingw-ucrt

data/lib/wx/doc/gen/rtc/rich_text_xml_handler.rb

@@ -7,18 +7,18 @@
 module Wx::RTC
 
   # A handler for loading and saving content in an XML format specific to {Wx::RTC::RichTextBuffer}.
+  # 
   # You can either add the handler to the buffer and load and save through the buffer or control API, or you can create an instance of the handler on the stack and call its functions directly.
   # 
-  # == Handler flags
+  # ## Handler flags
   # 
   # The following flags can be used with this handler, via the handler's {Wx::RTC::RichTextXMLHandler#set_flags} function or the buffer or control's SetHandlerFlags() function:
   # 
   # - {Wx::RTC::RICHTEXT_HANDLER_INCLUDE_STYLESHEET} Include the style sheet in loading and saving operations.
   # 
-  # === 
-  # 
   # Category:  Rich Text
   # 
+  # @wxrb_require USE_RICHTEXT
   class RichTextXMLHandler < RichTextFileHandler
   
     # Constructor.
@@ -39,6 +39,7 @@ module Wx::RTC
     alias_method :can_save?, :can_save
     
     # Call with XML node name, C++ class name so that {Wx::RTC} can read in the node.
+    # 
     # If you add a custom object, call this.
     # @param nodeName [String] 
     # @param className [String] 

data/lib/wx/doc/gen/rtc/symbol_picker_dialog.rb

@@ -7,6 +7,7 @@
 module Wx::RTC
 
   # {Wx::RTC::SymbolPickerDialog} presents the user with a choice of fonts and a grid of available characters.
+  # 
   # This modal dialog provides the application with a selected symbol and optional font selection.
   # Although this dialog is contained in the rich text library, the dialog is generic and can be used in other contexts.
   # To use the dialog, pass a default symbol specified as a string, an initial font name, and a current font name. The difference between the initial font and current font is that the initial font determines what the font control will be set to when the dialog shows - an empty string will show the selection normal text. The current font, on the other hand, is used by the dialog to determine what font to display the characters in, even when no initial font is selected. This allows the user (and application) to distinguish between inserting a symbol in the current font, and inserting it with a specified font.
@@ -46,10 +47,9 @@ module Wx::RTC
   #   end
   # ```
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # 
+  # @wxrb_require USE_RICHTEXT
   class SymbolPickerDialog < Dialog
   
     # @overload initialize()

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

@@ -25,6 +25,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_SASH
   class SashEdgePosition < Wx::Enum
   
     # 
@@ -53,6 +54,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_SASH
   class SashDragStatus < Wx::Enum
   
     # 
@@ -73,9 +75,14 @@ module Wx
   EVT_SASH_DRAGGED_RANGE = 10050
   
   # A sash event is sent when the sash of a {Wx::SashWindow} has been dragged by the user.
-  # When a sash belonging to a sash window is dragged by the user, and then released, this event is sent to the window, where it may be processed by an event table entry in a derived class, a plug-in event handler or an ancestor class. Note that the {Wx::SashWindow} doesn't change the window's size itself. It relies on the application's event handler to do that. This is because the application may have to handle other consequences of the resize, or it may wish to veto it altogether. The event handler should look at the drag rectangle: see {Wx::SashEvent#get_drag_rect} to see what the new size of the window would be if the resize were to be applied. It should also call {Wx::SashEvent#get_drag_status} to see whether the drag was OK or out of the current allowed range.
   # 
-  # === Events using this class
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>When a sash belonging to a sash window is dragged by the user, and then released, this event is sent to the window, where it may be processed by an event table entry in a derived class, a plug-in event handler or an ancestor class. Note that the {Wx::SashWindow} doesn't change the window's size itself. It relies on the application's event handler to do that. This is because the application may have to handle other consequences of the resize, or it may wish to veto it altogether. The event handler should look at the drag rectangle: see {Wx::SashEvent#get_drag_rect} to see what the new size of the window would be if the resize were to be applied. It should also call {Wx::SashEvent#get_drag_status} to see whether the drag was OK or out of the current allowed range.
+  # </p>
+  # </div>
+  # 
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::SashEvent} events.
   # Event handler methods:
@@ -84,13 +91,12 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_sash_dragged_range}(id1,  id2, meth = nil, &block): Process a {Wx::EVT_SASH_DRAGGED_RANGE} event, when the user has finished dragging a sash. The event handler is called when windows with ids in the given range have their sashes dragged. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::SashWindow
   # @see  Events and Event Handling 
   # 
   # 
+  # @wxrb_require USE_SASH
   class SashEvent < CommandEvent
   
     # Constructor.
@@ -100,18 +106,21 @@ module Wx
     def initialize(id=0, edge=Wx::SashEdgePosition::SASH_NONE) end
     
     # Returns the rectangle representing the new size the window would be if the resize was applied.
+    # 
     # It is up to the application to set the window size if required.
     # @return [Wx::Rect]
     def get_drag_rect; end
     alias_method :drag_rect, :get_drag_rect
     
     # Returns the status of the sash: one of {Wx::SashDragStatus::SASH_STATUS_OK}, {Wx::SashDragStatus::SASH_STATUS_OUT_OF_RANGE}.
+    # 
     # If the drag caused the notional bounding box of the window to flip over, for example, the drag will be out of rage.
     # @return [Wx::SashDragStatus]
     def get_drag_status; end
     alias_method :drag_status, :get_drag_status
     
     # Returns the dragged edge.
+    # 
     # The return value is one of {Wx::SashEdgePosition::SASH_TOP}, {Wx::SashEdgePosition::SASH_RIGHT}, {Wx::SashEdgePosition::SASH_BOTTOM}, {Wx::SashEdgePosition::SASH_LEFT}.
     # @return [Wx::SashEdgePosition]
     def get_edge; end

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

@@ -10,6 +10,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_SASH
   class LayoutOrientation < Wx::Enum
   
     # 
@@ -26,6 +27,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_SASH
   class LayoutAlignment < Wx::Enum
   
     # 
@@ -59,12 +61,12 @@ module Wx
   EVT_CALCULATE_LAYOUT = 10012
   
   # {Wx::SashLayoutWindow} responds to OnCalculateLayout events generated by {Wx::LayoutAlgorithm}.
+  # 
   # It allows the application to use simple accessors to specify how the window should be laid out, rather than having to respond to events.
   # The fact that the class derives from {Wx::SashWindow} allows sashes to be used if required, to allow the windows to be user-resizable.
   # The documentation for {Wx::LayoutAlgorithm} explains the purpose of this class in more detail.
   # For the window styles see {Wx::SashWindow}.
   # This class handles the EVT_QUERY_LAYOUT_INFO and EVT_CALCULATE_LAYOUT events for you. However, if you use sashes, see {Wx::SashWindow} for relevant event information. See also {Wx::LayoutAlgorithm} for information about the layout events.
-  # === 
   # 
   # Category:  Miscellaneous Windows
   # @see Wx::LayoutAlgorithm
@@ -72,6 +74,7 @@ module Wx
   # @see  Events and Event Handling 
   # 
   # 
+  # @wxrb_require USE_SASH
   class SashLayoutWindow < SashWindow
   
     # @overload initialize()
@@ -109,12 +112,14 @@ module Wx
     alias_method :orientation, :get_orientation
     
     # The default handler for the event that is generated by {Wx::LayoutAlgorithm}.
+    # 
     # The implementation of this function calls {Wx::CalculateLayoutEvent#set_rect} to shrink the provided size according to how much space this window takes up. For further details, see {Wx::LayoutAlgorithm} and {Wx::CalculateLayoutEvent}.
     # @param event [Wx::CalculateLayoutEvent] 
     # @return [void]
     def on_calculate_layout(event) end
     
     # The default handler for the event that is generated by OnCalculateLayout to get size, alignment and orientation information for the window.
+    # 
     # The implementation of this function uses member variables as set by accessors called by the application.
     # For further details, see {Wx::LayoutAlgorithm} and {Wx::QueryLayoutInfoEvent}.
     # @param event [Wx::QueryLayoutInfoEvent] 
@@ -122,6 +127,7 @@ module Wx
     def on_query_layout_info(event) end
     
     # Sets the alignment of the window (which edge of the available parent client area the window is attached to).
+    # 
     # alignment is one of {Wx::LayoutAlignment::LAYOUT_TOP}, {Wx::LayoutAlignment::LAYOUT_LEFT}, {Wx::LayoutAlignment::LAYOUT_RIGHT}, {Wx::LayoutAlignment::LAYOUT_BOTTOM}.
     # @param alignment [Wx::LayoutAlignment] 
     # @return [void]
@@ -129,6 +135,7 @@ module Wx
     alias_method :alignment=, :set_alignment
     
     # Sets the default dimensions of the window.
+    # 
     # The dimension other than the orientation will be fixed to this value, and the orientation dimension will be ignored and the window stretched to fit the available space.
     # @param size [Array(Integer, Integer), Wx::Size] 
     # @return [void]
@@ -136,6 +143,7 @@ module Wx
     alias_method :default_size=, :set_default_size
     
     # Sets the orientation of the window (the direction the window will stretch in, to fill the available parent client area).
+    # 
     # orientation is one of {Wx::LayoutOrientation::LAYOUT_HORIZONTAL}, {Wx::LayoutOrientation::LAYOUT_VERTICAL}.
     # @param orientation [Wx::LayoutOrientation] 
     # @return [void]
@@ -145,6 +153,7 @@ module Wx
   end # SashLayoutWindow
   
   # {Wx::LayoutAlgorithm} implements layout of subwindows in MDI or SDI frames.
+  # 
   # It sends a {Wx::CalculateLayoutEvent} event to children of the frame, asking them for information about their size. For MDI parent frames, the algorithm allocates the remaining space to the MDI client window (which contains the MDI child frames).
   # For SDI (normal) frames, a 'main' window is specified as taking up the remaining space.
   # Because the event system is used, this technique can be applied to any windows, which are not necessarily 'aware' of the layout classes (no virtual functions in {Wx::Window} refer to {Wx::LayoutAlgorithm} or its events). However, you may wish to use {Wx::SashLayoutWindow} for your subwindows since this class provides handlers for the required events, and accessors to specify the desired size of the window. The sash behaviour in the base class can be used, optionally, to make the windows user-resizable.
@@ -152,9 +161,14 @@ module Wx
   # When a window receives an OnCalculateLayout event, it should call SetRect in the given event object, to be the old supplied rectangle minus whatever space the window takes up. It should also set its own size accordingly. {Wx::SashLayoutWindow#on_calculate_layout} generates an OnQueryLayoutInfo event which it sends to itself to determine the orientation, alignment and size of the window, which it gets from internal member variables set by the application.
   # The algorithm works by starting off with a rectangle equal to the whole frame client area. It iterates through the frame children, generating {Wx::LayoutAlgorithm::OnCalculateLayout} events which subtract the window size and return the remaining rectangle for the next window to process. It is assumed (by {Wx::SashLayoutWindow#on_calculate_layout}) that a window stretches the full dimension of the frame client, according to the orientation it specifies. For example, a horizontal window will stretch the full width of the remaining portion of the frame client area. In the other orientation, the window will be fixed to whatever size was specified by {Wx::LayoutAlgorithm::OnQueryLayoutInfo}. An alignment setting will make the window 'stick' to the left, top, right or bottom of the remaining client area. This scheme implies that order of window creation is important. Say you wish to have an extra toolbar at the top of the frame, a project window to the left of the MDI client window, and an output window above the status bar. You should therefore create the windows in this order: toolbar, output window, project window. This ensures that the toolbar and output window take up space at the top and bottom, and then the remaining height in-between is used for the project window.
   # {Wx::LayoutAlgorithm} is quite independent of the way in which {Wx::LayoutAlgorithm::OnCalculateLayout} chooses to interpret a window's size and alignment. Therefore you could implement a different window class with a new {Wx::LayoutAlgorithm::OnCalculateLayout} event handler, that has a more sophisticated way of laying out the windows. It might allow specification of whether stretching occurs in the specified orientation, for example, rather than always assuming stretching. (This could, and probably should, be added to the existing implementation).
-  # {Wx::LayoutAlgorithm} has nothing to do with {Wx::LayoutConstraints}. It is an alternative way of specifying layouts for which the normal constraint system is unsuitable.
   # 
-  # === Events emitted by this class
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>{Wx::LayoutAlgorithm} has nothing to do with {Wx::LayoutConstraints}. It is an alternative way of specifying layouts for which the normal constraint system is unsuitable.
+  # </p>
+  # </div>
+  # 
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CalculateLayoutEvent} events.
   # Event handler methods for events emitted by this class:
@@ -164,7 +178,6 @@ module Wx
   # - {Wx::EvtHandler#evt_calculate_layout}(meth = nil, &block): Process a {Wx::EVT_CALCULATE_LAYOUT} event, which asks the window to take a 'bite' out of a rectangle provided by the algorithm. See {Wx::CalculateLayoutEvent}. 
   # 
   # Note that the algorithm object does not respond to events, but itself generates the previous events in order to calculate window sizes.
-  # === 
   # 
   # Category:  Window Layout
   # @see Wx::SashEvent
@@ -172,6 +185,7 @@ module Wx
   # @see  Events and Event Handling 
   # 
   # 
+  # @wxrb_require USE_SASH
   class LayoutAlgorithm < Object
   
     # Default constructor.
@@ -179,6 +193,7 @@ module Wx
     def initialize; end
     
     # Lays out the children of a normal frame.
+    # 
     # mainWindow is set to occupy the remaining space. This function simply calls {Wx::LayoutAlgorithm#layout_window}.
     # @param frame [Wx::Frame] 
     # @param mainWindow [Wx::Window] 
@@ -186,6 +201,7 @@ module Wx
     def layout_frame(frame, mainWindow=nil) end
     
     # Lays out the children of an MDI parent frame.
+    # 
     # If rect is non-NULL, the given rectangle will be used as a starting point instead of the frame's client area. The MDI client window is set to occupy the remaining space.
     # @param frame [Wx::MDIParentFrame] 
     # @param rect [Wx::Rect] 
@@ -193,6 +209,7 @@ module Wx
     def layout_mdi_frame(frame, rect=nil) end
     
     # Lays out the children of a normal frame or other window.
+    # 
     # mainWindow is set to occupy the remaining space. If this is not specified, then the last window that responds to a calculate layout event in query mode will get the remaining space (that is, a non-query OnCalculateLayout event will not be sent to this window and the window will be set to the remaining size).
     # @param parent [Wx::Window] 
     # @param mainWindow [Wx::Window] 

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

@@ -7,9 +7,10 @@
 module Wx
 
   # {Wx::SashWindow} allows any of its edges to have a sash which can be dragged to resize the window.
+  # 
   # The actual content window will be created by the application as a child of {Wx::SashWindow}.
   # The window (or an ancestor) will be notified of a drag via a {Wx::SashEvent} notification.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -21,7 +22,7 @@ module Wx
   # 
   # - {Wx::SW_BORDER}: Draws a thin black border. 
   # 
-  # === 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::SashEvent} events.
   # Event handler methods for events emitted by this class:
@@ -30,14 +31,13 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_sash_dragged_range}(id1,  id2, meth = nil, &block): Process a {Wx::EVT_SASH_DRAGGED_RANGE} event, when the user has finished dragging a sash. The event handler is called when windows with ids in the given range have their sashes dragged. 
   # 
-  # === 
-  # 
   # Category:  Miscellaneous Windows
   # @see Wx::SashEvent
   # @see  Wx::SashLayoutWindow
   # @see  Events and Event Handling 
   # 
   # 
+  # @wxrb_require USE_SASH
   class SashWindow < Window
   
     # @overload initialize()
@@ -76,6 +76,7 @@ module Wx
     
     # Returns true if a sash is visible on the given edge, false otherwise.
     # 
+    # 
     # @see Wx::SashWindow#set_sash_visible 
     # @param edge [Wx::SashEdgePosition]  Edge. One of {Wx::SashEdgePosition::SASH_TOP}, {Wx::SashEdgePosition::SASH_RIGHT}, {Wx::SashEdgePosition::SASH_BOTTOM}, {Wx::SashEdgePosition::SASH_LEFT}.
     # @return [Boolean]
@@ -108,6 +109,7 @@ module Wx
     
     # Call this function to make a sash visible or invisible on a particular edge.
     # 
+    # 
     # @see Wx::SashWindow#get_sash_visible 
     # @param edge [Wx::SashEdgePosition]  Edge to change. One of {Wx::SashEdgePosition::SASH_TOP}, {Wx::SashEdgePosition::SASH_RIGHT}, {Wx::SashEdgePosition::SASH_BOTTOM}, {Wx::SashEdgePosition::SASH_LEFT}.
     # @param visible [Boolean]  true to make the sash visible, false to make it invisible.

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

@@ -7,9 +7,9 @@
 module Wx
 
   # A {Wx::ScreenDC} can be used to paint on the screen.
+  # 
   # This should normally be constructed as a temporary stack object; don't store a {Wx::ScreenDC} object.
   # When using multiple monitors, {Wx::ScreenDC} corresponds to the entire virtual screen composed of all of them. Notice that coordinates on {Wx::ScreenDC} can be negative in this case, see Wx::Display#get_geometry for more.
-  # === 
   # 
   # Category:  Device Contexts
   # @see Wx::DC

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

@@ -7,10 +7,16 @@
 module Wx
 
   # A {Wx::ScrollBar} is a control that represents a horizontal or vertical scrollbar.
+  # 
   # It is distinct from the two scrollbars that some windows provide automatically, but the two types of scrollbar share the way events are received.
-  # A scrollbar has the following main attributes: range, thumb size, page size, and position. The range is the total number of units associated with the view represented by the scrollbar. For a table with 15 columns, the range would be 15. The thumb size is the number of units that are currently visible. For the table example, the window might be sized so that only 5 columns are currently visible, in which case the application would set the thumb size to 5. When the thumb size becomes the same as or greater than the range, the scrollbar will be automatically hidden on most platforms. The page size is the number of units that the scrollbar should scroll by, when 'paging' through the data. This value is normally the same as the thumb size length, because it is natural to assume that the visible window size defines a page. The scrollbar position is the current thumb position. Most applications will find it convenient to provide a function called AdjustScrollbars() which can be called initially, from an OnSize event handler, and whenever the application data changes in size. It will adjust the view, object and page size according to the size of the window and the size of the data.
   # 
-  # === Styles
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>A scrollbar has the following main attributes: range, thumb size, page size, and position. The range is the total number of units associated with the view represented by the scrollbar. For a table with 15 columns, the range would be 15. The thumb size is the number of units that are currently visible. For the table example, the window might be sized so that only 5 columns are currently visible, in which case the application would set the thumb size to 5. When the thumb size becomes the same as or greater than the range, the scrollbar will be automatically hidden on most platforms. The page size is the number of units that the scrollbar should scroll by, when 'paging' through the data. This value is normally the same as the thumb size length, because it is natural to assume that the visible window size defines a page. The scrollbar position is the current thumb position. Most applications will find it convenient to provide a function called AdjustScrollbars() which can be called initially, from an OnSize event handler, and whenever the application data changes in size. It will adjust the view, object and page size according to the size of the window and the size of the data.
+  # </p>
+  # </div>
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -18,7 +24,7 @@ module Wx
   # 
   # - {Wx::SB_VERTICAL}: Specifies a vertical scrollbar. 
   # 
-  # === 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::ScrollEvent} events.
   # Event handler methods for events emitted by this class: except for this, the macros behave exactly the same. 
@@ -63,22 +69,22 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_command_scroll_changed}(meth = nil, &block): Process {Wx::EVT_SCROLL_CHANGED} end of scrolling events (MSW only). 
   # 
-  # == The difference between EVT_SCROLL_THUMBRELEASE and EVT_SCROLL_CHANGED
+  # ## The difference between EVT_SCROLL_THUMBRELEASE and EVT_SCROLL_CHANGED
   # 
   # The EVT_SCROLL_THUMBRELEASE event is only emitted when actually dragging the thumb using the mouse and releasing it (This EVT_SCROLL_THUMBRELEASE event is also followed by an EVT_SCROLL_CHANGED event).
   # The EVT_SCROLL_CHANGED event also occurs when using the keyboard to change the thumb position, and when clicking next to the thumb (In all these cases the EVT_SCROLL_THUMBRELEASE event does not happen).
   # In short, the EVT_SCROLL_CHANGED event is triggered when scrolling/moving has finished independently of the way it had started. Please see the Widgets Sample ("Slider" page) to see the difference between EVT_SCROLL_THUMBRELEASE and EVT_SCROLL_CHANGED in action.
-  # === 
   # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Scrolled Windows
   # @see  Events and Event Handling
   # @see  Wx::Scrolled 
   # 
   # 
+  # @wxrb_require USE_SCROLLBAR
   class ScrollBar < Control
   
     # @overload initialize()
@@ -87,6 +93,7 @@ module Wx
     # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::SB_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SCROLL_BAR_NAME_STR)
     #   Constructor, creating and showing a scrollbar.
     #   
+    #   
     #   @see Wx::ScrollBar#create
     #   @see  Wx::Validator 
     #   @param parent [Wx::Window]  Parent window. Must be non-NULL.
@@ -100,6 +107,7 @@ module Wx
     def initialize(*args) end
     
     # Scrollbar creation function called by the scrollbar constructor.
+    # 
     # See {Wx::ScrollBar#initialize} for details.
     # @param parent [Wx::Window] 
     # @param id [Integer] 
@@ -112,6 +120,7 @@ module Wx
     def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::SB_HORIZONTAL, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SCROLL_BAR_NAME_STR) end
     
     # Returns the page size of the scrollbar.
+    # 
     # This is the number of scroll units that will be scrolled when the user pages up or down. Often it is the same as the thumb size.
     # @see Wx::ScrollBar#set_scrollbar 
     # @return [Integer]
@@ -120,6 +129,7 @@ module Wx
     
     # Returns the length of the scrollbar.
     # 
+    # 
     # @see Wx::ScrollBar#set_scrollbar 
     # @return [Integer]
     def get_range; end
@@ -127,6 +137,7 @@ module Wx
     
     # Returns the current position of the scrollbar thumb.
     # 
+    # 
     # @see Wx::ScrollBar#set_thumb_position 
     # @return [Integer]
     def get_thumb_position; end
@@ -134,17 +145,23 @@ module Wx
     
     # Returns the thumb or 'view' size.
     # 
+    # 
     # @see Wx::ScrollBar#set_scrollbar 
     # @return [Integer]
     def get_thumb_size; end
     alias_method :thumb_size, :get_thumb_size
     
     # Sets the scrollbar properties.
-    # 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: 
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>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: 
     # ```ruby
     #   scrollbar.set_scrollbar(0, 16, 50, 15)
     # ```
-    #  The page size is 1 less than the thumb size so that the last line of the previous page will be visible on the next page, to help orient the user. 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 {Wx::ScrollBar#set_scrollbar} call into a function named AdjustScrollbars, which can be called initially and also from a {Wx::SizeEvent} event handler function.
+    #  The page size is 1 less than the thumb size so that the last line of the previous page will be visible on the next page, to help orient the user. 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 {Wx::ScrollBar#set_scrollbar} call into a function named AdjustScrollbars, which can be called initially and also from a {Wx::SizeEvent} event handler function. 
+    # </p>
+    # </div>
     # @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.
@@ -155,6 +172,7 @@ module Wx
     
     # Sets the position of the scrollbar.
     # 
+    # 
     # @see Wx::ScrollBar#get_thumb_position 
     # @param viewStart [Integer]  The position of the scrollbar thumb.
     # @return [void]

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

@@ -7,12 +7,17 @@
 module Wx
 
   # The {Wx::Scrolled} class manages scrolling for its client area, transforming the coordinates according to the scrollbar positions, and setting the scroll positions, thumb sizes and ranges according to the area in view.
+  # 
   # There are two commonly used (but not the only possible!) specializations of this class:
   # 
   # - {Wx::ScrolledWindow}, aka {Wx::Scrolled}<{Wx::Panel}>, is equivalent to {Wx::ScrolledWindow} from earlier versions. Derived from {Wx::Panel}, it shares {Wx::Panel}'s behaviour with regard to TAB traversal and focus handling. Use this if the scrolled window will have child controls.
   # - {Wx::ScrolledCanvas}, aka {Wx::Scrolled}<{Wx::Window}>, derives from {Wx::Window} and so doesn't handle children specially. This is suitable e.g. for implementing scrollable controls such as tree or list controls.
   # 
-  # See Wx::Scrolled#create if you want to use {Wx::Scrolled} with a custom class.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>See Wx::Scrolled#create if you want to use {Wx::Scrolled} with a custom class.
+  # </p>
+  # </div>
   # 
   # Starting from version 2.4 of wxWidgets, there are several ways to use a {Wx::ScrolledWindow} (and now {Wx::Scrolled}). In particular, there are three ways to set the size of the scrolling area:
   # One way is to set the scrollbars directly using a call to Wx::Scrolled#set_scrollbars. This is the way it used to be in any previous version of wxWidgets and it will be kept for backwards compatibility.
@@ -26,7 +31,7 @@ module Wx
   # If you don't wish to calculate your own scrolling, you must call Wx::Scrolled#do_prepare_dc when not drawing from within Wx::Scrolled#on_draw, to set the device origin for the device context according to the current scroll position.
   # A {Wx::Scrolled} will normally scroll itself and therefore its child windows as well. It might however be desired to scroll a different window than itself: e.g. when designing a spreadsheet, you will normally only have to scroll the (usually white) cell area, whereas the (usually grey) label area will scroll very differently. For this special purpose, you can call Wx::Scrolled#set_target_window which means that pressing the scrollbars will scroll a different window.
   # Note that the underlying system knows nothing about scrolling coordinates, so that all system functions (mouse events, expose events, refresh calls etc) as well as the position of subwindows are relative to the "physical" origin of the scrolled window. If the user insert a child window at position (10,10) and scrolls the window down 100 pixels (moving the child window out of the visible area), the child window will report a position of (10,-90).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -38,7 +43,7 @@ module Wx
   # 
   # - {Wx::RETAINED}: Uses a backing pixmap to speed refreshes. Motif only. 
   # 
-  # === 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::ScrollWinEvent} events.
   # Event handler methods for events emitted by this class:
@@ -61,11 +66,17 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_scrollwin_thumbrelease}(meth = nil, &block): Process {Wx::EVT_SCROLLWIN_THUMBRELEASE} thumb release events. 
   # 
-  # Don't confuse {Wx::ScrollWinEvents} generated by this class with {Wx::ScrollEvent} objects generated by {Wx::ScrollBar} and {Wx::Slider}.
-  # 
-  # Use {Wx::Scrolled} for applications where the user scrolls by a fixed amount, and where a 'page' can be interpreted to be the current visible portion of the window. For more sophisticated applications, use the {Wx::Scrolled} implementation as a guide to build your own scroll behaviour or use {Wx::VScrolledWindow} or its variants.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Don't confuse {Wx::ScrollWinEvents} generated by this class with {Wx::ScrollEvent} objects generated by {Wx::ScrollBar} and {Wx::Slider}.
+  # </p>
+  # </div>
   # 
-  # === 
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>Use {Wx::Scrolled} for applications where the user scrolls by a fixed amount, and where a 'page' can be interpreted to be the current visible portion of the window. For more sophisticated applications, use the {Wx::Scrolled} implementation as a guide to build your own scroll behaviour or use {Wx::VScrolledWindow} or its variants.
+  # </p>
+  # </div>
   # 
   # Category:  Miscellaneous Windows
   # @see Wx::ScrollBar
@@ -84,7 +95,12 @@ module Wx
     #   @return [Wx::ScrolledCanvas]
     # @overload initialize(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW"))
     #   Constructor.
-    #   The window is initially created without visible scrollbars. Call Wx::Scrolled#set_scrollbars to specify how big the virtual window size should be.
+    #   
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>The window is initially created without visible scrollbars. Call Wx::Scrolled#set_scrollbars to specify how big the virtual window size should be. 
+    #   </p>
+    #   </div>
     #   @param parent [Wx::Window]  Parent window.
     #   @param id [Integer]  Window identifier. The value {Wx::StandardID::ID_ANY} indicates a default value.
     #   @param pos [Array(Integer, Integer), Wx::Point]  Window position. If a position of {Wx::DEFAULT_POSITION} is specified then a default position is chosen.
@@ -96,6 +112,7 @@ module Wx
     
     # @overload calc_scrolled_position(x, y)
     #   Translates the logical coordinates to the device ones.
+    #   
     #   For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcScrolledPosition(0, 10, xx, yy) will return 0 in yy.
     #   @see Wx::Scrolled#calc_unscrolled_position 
     #   @param x [Integer] 
@@ -108,6 +125,7 @@ module Wx
     
     # @overload calc_unscrolled_position(x, y)
     #   Translates the device coordinates to the logical ones.
+    #   
     #   For example, if a window is scrolled 10 pixels to the bottom, the device coordinates of the origin are (0, 0) (as always), but the logical coordinates are (0, 10) and so the call to CalcUnscrolledPosition(0, 0, xx, yy) will return 10 in yy.
     #   @see Wx::Scrolled#calc_scrolled_position 
     #   @param x [Integer] 
@@ -119,6 +137,7 @@ module Wx
     def calc_unscrolled_position(*args) end
     
     # Creates the window for two-step construction.
+    # 
     # Derived classes should call or replace this function. If it is not replaced, bear in mind that it calls T::Create() through the global function {create_scrolled} so if T::Create() has a different signature than Wx::Scrolled#create you should implement overloaded {create_scrolled} which would call T::Create() in the correct manner.
     # @see Wx::Scrolled#initialize and create_scrolled for details. 
     # @param parent [Wx::Window] 
@@ -131,11 +150,13 @@ module Wx
     def create(parent, id=-1, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::HSCROLL|Wx::VSCROLL), name=("SCROLLED_WINDOW")) end
     
     # Disable use of keyboard keys for scrolling.
+    # 
     # By default cursor movement keys (including Home, End, Page Up and Down) are used to scroll the window appropriately. If the derived class uses these keys for something else, e.g. changing the currently selected item, this function can be used to disable this behaviour as it's not only not necessary then but can actually be actively harmful if another object forwards a keyboard event corresponding to one of the above keys to us using ProcessWindowEvent() because the event will always be processed which can be undesirable.
     # @return [void]
     def disable_keyboard_scrolling; end
     
     # Call this function to prepare the device context for drawing a scrolled image.
+    # 
     # It sets the device origin according to the current scroll position. Wx::Scrolled#do_prepare_dc is called automatically within the default {Wx::EVT_PAINT} event handler, so your Wx::Scrolled#on_draw override will be passed an already 'pre-scrolled' device context. However, if you wish to draw from outside of Wx::Scrolled#on_draw (e.g. from your own {Wx::EVT_PAINT} handler), you must call this function yourself.
     # For example: 
     # ```ruby
@@ -164,6 +185,7 @@ module Wx
     def do_prepare_dc(dc) end
     
     # Enable or disable use of {Wx::Window#scroll_window} for scrolling.
+    # 
     # By default, when a scrolled window is logically scrolled, {Wx::Window#scroll_window} is called on the underlying window which scrolls the window contents and only invalidates the part of the window newly brought into view. If false is passed as an argument, then this "physical scrolling" is disabled and the window is entirely invalidated whenever it is scrolled by calling {Wx::Window#refresh}.
     # It should be rarely necessary to disable physical scrolling, so this method shouldn't be called in normal circumstances.
     # @param xScrolling [Boolean]  If true, enables physical scrolling in the x direction.
@@ -172,6 +194,7 @@ module Wx
     def enable_scrolling(xScrolling, yScrolling) end
     
     # Set the scrollbar visibility.
+    # 
     # By default the scrollbar in the corresponding direction is only shown if it is needed, i.e. if the virtual size of the scrolled window in this direction is greater than the current physical window size. Using this function the scrollbar visibility can be changed to be:
     # 
     # - {Wx::ScrollbarVisibility::SHOW_SB_ALWAYS}: To always show the scrollbar, even if it is not needed currently ({Wx::ALWAYS_SHOW_SB} style can be used during the window creation to achieve the same effect but it applies in both directions).
@@ -185,6 +208,7 @@ module Wx
     def show_scrollbars(horz, vert) end
     
     # Get the number of pixels per scroll unit (line), in each direction, as set by Wx::Scrolled#set_scrollbars.
+    # 
     # A value of zero indicates no scrolling in that direction.
     # @see Wx::Scrolled#set_scrollbars
     # @see  Wx::Scrolled#get_virtual_size 
@@ -198,7 +222,12 @@ module Wx
     alias_method :view_start, :get_view_start
     
     # Gets the size in device units of the scrollable window area (as opposed to the client size, which is the area of the window currently visible).
-    # Use {Wx::DC#device_to_logical_x} and {Wx::DC#device_to_logical_y} to translate these units to logical units.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use {Wx::DC#device_to_logical_x} and {Wx::DC#device_to_logical_y} to translate these units to logical units.
+    # </p>
+    # </div>
     # @see Wx::Scrolled#set_scrollbars
     # @see  Wx::Scrolled#get_scroll_pixels_per_unit 
     # @return [Array(Integer,Integer)]
@@ -211,6 +240,7 @@ module Wx
     alias_method :retained?, :is_retained
     
     # This function is for backwards compatibility only and simply calls Wx::Scrolled#do_prepare_dc now.
+    # 
     # Notice that it is not called by the default paint event handle (Wx::Scrolled#do_prepare_dc is), so overriding this method in your derived class is useless.
     # @param dc [Wx::DC] 
     # @return [void]
@@ -218,7 +248,12 @@ module Wx
     
     # @overload scroll(x, y)
     #   Scrolls a window so the view start is at the given point.
-    #   The positions are in scroll units, not pixels, so to convert to pixels you will have to multiply by the number of pixels per scroll increment. If either parameter is {Wx::DEFAULT_COORD} (-1), that position will be ignored (no change in that direction).
+    #   
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>The positions are in scroll units, not pixels, so to convert to pixels you will have to multiply by the number of pixels per scroll increment. If either parameter is {Wx::DEFAULT_COORD} (-1), that position will be ignored (no change in that direction).
+    #   </p>
+    #   </div>
     #   @see Wx::Scrolled#set_scrollbars
     #   @see  Wx::Scrolled#get_scroll_pixels_per_unit 
     #   @param x [Integer]  The x position to scroll to, in scroll units.
@@ -231,6 +266,7 @@ module Wx
     def scroll(*args) end
     
     # Set the horizontal and vertical scrolling increment only.
+    # 
     # See the pixelsPerUnit parameter in Wx::Scrolled#set_scrollbars.
     # @param xstep [Integer] 
     # @param ystep [Integer] 
@@ -238,6 +274,7 @@ module Wx
     def set_scroll_rate(xstep, ystep) end
     
     # Sets up vertical and/or horizontal scrollbars.
+    # 
     # The first pair of parameters give the number of pixels per 'scroll step', i.e. amount moved when the up or down scroll arrows are pressed. The second pair gives the length of scrollbar in scroll steps, which sets the size of the virtual window.
     # xPos and yPos optionally specify a position to scroll to immediately.
     # For example, the following gives a window horizontal and vertical scrollbars with 20 pixels per scroll step, and a size of 50 steps (1000 pixels) in each direction: 
@@ -259,6 +296,7 @@ module Wx
     def set_scrollbars(pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY, xPos=0, yPos=0, noRefresh=false) end
     
     # Call this function to tell {Wx::Scrolled} to perform the actual scrolling on a different window (and not on itself).
+    # 
     # This method is useful when only a part of the window should be scrolled. A typical example is a control consisting of a fixed header and the scrollable contents window: the scrollbars are attached to the main window itself, hence it, and not the contents window must be derived from {Wx::Scrolled}, but only the contents window scrolls when the scrollbars are used. To implement such setup, you need to call this method with the contents window as argument.
     # Notice that if this method is used, Wx::Scrolled#get_size_available_for_scroll_target method must be overridden.
     # @param window [Wx::Window]