wxruby3 0.9.0.pre.beta.14-x64-mingw-ucrt → 0.9.0.pre.rc.1-x64-mingw-ucrt

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

@@ -18,30 +18,10 @@ module Wx
   # @see  Wx::GraphicsContext 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GCDC < DC
   
-    # @overload initialize(windowDC)
-    #   Constructs a {Wx::GCDC} from a {Wx::WindowDC}.
-    #   @param windowDC [Wx::WindowDC] 
-    #   @return [GCDC]
-    # @overload initialize(memoryDC)
-    #   Constructs a {Wx::GCDC} from a {Wx::MemoryDC}.
-    #   @param memoryDC [Wx::MemoryDC] 
-    #   @return [GCDC]
-    # @overload initialize(printerDC)
-    #   Constructs a {Wx::GCDC} from a {Wx::PRT::PrinterDC}.
-    #   @param printerDC [Wx::PrinterDC] 
-    #   @return [GCDC]
-    # @overload initialize(context)
-    #   Construct a {Wx::GCDC} from an existing graphics context.
-    #   Note that this object takes ownership of context and will delete it when it is destroyed or when {Wx::GCDC#set_graphics_context} is called with a different context object.
-    #   Also notice that context will continue using the same font, pen and brush as before until {Wx::GCDC#set_font}, {Wx::GCDC#set_pen} or {Wx::GCDC#set_brush} is explicitly called to change them. This means that the code can use this {Wx::DC}-derived object to work using pens and brushes with alpha component, for example (which normally isn't supported by {Wx::DC} API), but it also means that the return values of {Wx::GCDC#get_font}, {Wx::GCDC#get_pen} and {Wx::GCDC#get_brush} won't really correspond to the actually used objects because they simply can't represent them anyhow. If you wish to avoid such discrepancy, you need to call the setter methods to bring {Wx::DC} and {Wx::GraphicsContext} font, pen and brush in sync with each other.
-    #   @param context [Wx::GraphicsContext] 
-    #   @return [GCDC]
-    # @overload initialize()
-    #   @return [GCDC]
-    def initialize(*args) end
-    
     # Retrieves associated {Wx::GraphicsContext}.
     # @return [Wx::GraphicsContext]
     def get_graphics_context; end

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

@@ -352,6 +352,8 @@ module Wx
   # @see Wx::RealPoint 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Point < ::Object
   
     # Returns true if neither of the point components is equal to {Wx::DEFAULT_COORD}.
@@ -363,10 +365,12 @@ module Wx
     # Combine this object with another one replacing the uninitialized values.
     # It is typically used like this:
     # 
+    # ```
     #   if ( !pos.IsFullySpecified() )
     #   {
     #       pos.SetDefaults(GetDefaultPosition());
     #   }
+    # ```
     # @see Wx::Point#is_fully_specified
     # @param pt [Array(Integer, Integer), Wx::Point] 
     # @return [void]
@@ -409,11 +413,12 @@ module Wx
     # @overload initialize(pt)
     #   Converts the given {Wx::RealPoint} (with floating point coordinates) to a {Wx::Point} instance.
     #   Notice that this truncates the floating point values of pt components, if you want to round them instead you need to do it manually, e.g. 
-    #   
+    #   ```
     #     #include <wx/math.h>    // for wxRound()
     #     
     #     wxRealPoint rp = ...;
     #     wxPoint p(wxRound(rp.x), wxRound(rp.y));
+    #   ```
     #   @param pt [Wx::RealPoint] 
     #   @return [Point]
     def initialize(*args) end
@@ -432,6 +437,8 @@ module Wx
   # @see  Wx::RealPoint 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Size < ::Object
   
     # @overload dec_by(pt)
@@ -551,10 +558,12 @@ module Wx
     # Combine this size object with another one replacing the default (i.e. equal to -1) components of this object with those of the other.
     # It is typically used like this:
     # 
+    # ```
     #   if ( !size.IsFullySpecified() )
     #   {
     #       size.SetDefaults(GetDefaultSize());
     #   }
+    # ```
     # @see Wx::Size#is_fully_specified 
     # @param sizeDefault [Array(Integer, Integer), Wx::Size] 
     # @return [void]
@@ -577,9 +586,10 @@ module Wx
   
   # Represents a rectangle with integer coordinates.
   # x and y members specify the coordinates of the rectangle top-left corner and width and height specify its width and height respectively. The usual C++ semi-open interval convention is used: point p lies inside the rectangle if and only if both conditions below are satisfied: 
-  # 
+  # ```
   #   x <= p.x < x + width
   #   y <= p.y < y + height
+  # ```
   # 
   # In other words, the rectangle left and right boundaries are at x and <code>x+width-1</code> and its top and bottom boundaries are at y and <code>y+height-1</code> respectively.
   # Note that the x and y coordinates may be negative, but width and height are always strictly positive for non-empty rectangles.
@@ -590,6 +600,8 @@ module Wx
   # @see  Wx::Size 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Rect < ::Object
   
     # Returns the rectangle having the same size as this one but centered relatively to the given rectangle r.
@@ -887,6 +899,8 @@ module Wx
   # @see Wx::Point 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class RealPoint < ::Object
   
     # X coordinate of this point.
@@ -1073,6 +1087,8 @@ module Wx
   # @see Wx::Colour 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class ColourDatabase < ::Object
   
     # Constructs the colour database.

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

@@ -17,6 +17,8 @@ module Wx
   # @see  Wx::Font 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GDIObject < Object
   
     # Default constructor.

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

@@ -165,6 +165,7 @@ module Wx
   # A {Wx::GraphicsContext} instance is the object that is drawn upon.
   # It is created by a renderer using Wx::GraphicsRenderer#create_context. This can be either directly using a renderer instance, or indirectly using the static convenience {Wx::GraphicsContext.create} functions of {Wx::GraphicsContext} that always delegate the task to the default renderer.
   # 
+  # ```
   #   void MyCanvas::OnPaint(wxPaintEvent &event)
   #   {
   #       // Create paint DC
@@ -191,6 +192,7 @@ module Wx
   #           delete gc;
   #       }
   #   }
+  # ```
   # 
   # For some renderers (like Direct2D or Cairo) processing of drawing operations may be deferred (Direct2D render target normally builds up a batch of rendering commands but defers processing of these commands, Cairo operates on a separate surface) so to make drawing results visible you need to update the content of the context by calling {Wx::GraphicsContext#flush} or by destroying the context.
   # 
@@ -202,51 +204,10 @@ module Wx
   # @see  Wx::DC 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GraphicsContext < GraphicsObject
   
-    # @overload self.create(window)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::Window}.
-    #   
-    #   @see Wx::GraphicsRenderer#create_context 
-    #   @param window [Wx::Window] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(windowDC)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::WindowDC}.
-    #   
-    #   @see Wx::GraphicsRenderer#create_context 
-    #   @param windowDC [Wx::WindowDC] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(memoryDC)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::MemoryDC}.
-    #   
-    #   @see Wx::GraphicsRenderer#create_context 
-    #   @param memoryDC [Wx::MemoryDC] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(printerDC)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::PRT::PrinterDC}.
-    #   Under GTK+, this will only work when using the GtkPrint printing backend which is available since GTK+ 2.10.
-    #   @see Wx::GraphicsRenderer#create_context
-    #   @see  Printing Under Unix (GTK+) 
-    #   @param printerDC [Wx::PrinterDC] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(image)
-    #   Creates a {Wx::GraphicsContext} associated with a {Wx::Image}.
-    #   The image specifies the size of the context as well as whether alpha is supported (if {Wx::Image#has_alpha}) or not and the initial contents of the context. The image object must have a life time greater than that of the new context as the context copies its contents back to the image when it is destroyed.
-    #   @param image [Wx::Image] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create()
-    #   Create a lightweight context that can be used only for measuring text.
-    #   @return [Wx::GraphicsContext]
-    def self.create(*args) end
-    
-    # Creates a {Wx::GraphicsContext} from a DC of unknown specific type.
-    # Creates a {Wx::GraphicsContext} if dc is a supported type (i.e. has a corresponding {Wx::GraphicsContext.create} method, e.g. {Wx::WindowDC} or {Wx::MemoryDC}). Returns NULL if the DC is unsupported.
-    # This method is only useful as a helper in generic code that operates with {Wx::DC} and doesn't known its exact type. Use {Wx::GraphicsContext.create} instead if you know that the DC is e.g. {Wx::WindowDC}.
-    # @see Wx::GraphicsRenderer#create_context_from_unknown_dc
-    # @param dc [Wx::DC] 
-    # @return [Wx::GraphicsContext]
-    def self.create_from_unknown_dc(dc) end
-    
     # Resets the clipping to original shape.
     # @return [void]
     def reset_clip; end

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

@@ -407,7 +407,9 @@ module Wx
     # Concatenates the matrix passed with the current matrix.
     # The effect of the resulting transformation is to first apply the transformation in t to the coordinates and then apply the transformation in the current matrix to the coordinates.
     # 
+    # ```
     #   // matrix = t x matrix
+    # ```
     # @param t [Wx::GraphicsMatrix]  The parameter matrix is the multiplicand.
     # @return [void]
     def concat(t) end

data/lib/wx/doc/gen/grid/grid_cell_attr.rb

@@ -97,10 +97,11 @@ module Wx::GRID
     # Get the alignment defined by this attribute.
     # Unlike {Wx::GRID::GridCellAttr#get_alignment} this function only modifies hAlign and vAlign if this attribute does define a non-default alignment. This means that they must be initialized before calling this function and that their values will be preserved unchanged if they are different from {Wx::Alignment::ALIGN_INVALID}.
     # For example, the following fragment can be used to use the cell alignment if one is defined but right-align its contents by default (instead of left-aligning it by default) while still using the default vertical alignment: 
-    # 
+    # ```
     #   int hAlign = wxALIGN_RIGHT,
     #       vAlign = wxALIGN_INVALID;
     #   attr.GetNonDefaultAlignment(&hAlign, &vAlign);
+    # ```
     # @return [Array(Integer,Integer)]
     def get_non_default_alignment; end
     alias_method :non_default_alignment, :get_non_default_alignment

data/lib/wx/doc/gen/grid/grid_ctrl.rb

@@ -374,7 +374,7 @@ module Wx::GRID
     # Returns the pen used for horizontal grid lines.
     # This virtual function may be overridden in derived classes in order to change the appearance of individual grid line for the given row.
     # Example: 
-    # 
+    # ```
     #   // in a grid displaying music notation, use a solid black pen between
     #   // octaves (C0=row 127, C1=row 115 etc.)
     #   wxPen MidiGrid::GetRowGridLinePen(int row)
@@ -384,6 +384,7 @@ module Wx::GRID
     #       else
     #           return GetDefaultGridLinePen();
     #   }
+    # ```
     # @param row [Integer] 
     # @return [Wx::Pen]
     def get_row_grid_line_pen(row) end
@@ -1258,7 +1259,7 @@ module Wx::GRID
     #   For normal cells, the function fills both num_rows and num_cols with 1 and returns CellSpan_None. For cells which span multiple cells, i.e. for which {Wx::GRID::Grid#set_cell_size} had been called, the returned values are the same ones as were passed to {Wx::GRID::Grid#set_cell_size} call and the function return value is CellSpan_Main.
     #   More unexpectedly, perhaps, the returned values may be negative for the cells which are inside a span covered by a cell occupying multiple rows or columns. They correspond to the offset of the main cell of the span from the cell passed to this functions and the function returns CellSpan_Inside value to indicate this.
     #   As an example, consider a 3*3 grid with the cell (1, 1) (the one in the middle) having a span of 2 rows and 2 columns, i.e. the grid looks like 
-    #   
+    #   ```
     #     +----+----+----+
     #     |    |    |    |
     #     +----+----+----+
@@ -1266,6 +1267,7 @@ module Wx::GRID
     #     +----+         |
     #     |    |         |
     #     +----+----+----+
+    #   ```
     #    Then the function returns 2 and 2 in num_rows and num_cols for the cell (1, 1) itself and -1 and -1 for the cell (2, 2) as well as -1 and 0 for the cell (2, 1).
     #   
     #   The kind of this cell span (the return value is new in wxWidgets 2.9.1, this function was void in previous wxWidgets versions).

data/lib/wx/doc/gen/grid/grid_table_message.rb

@@ -9,6 +9,8 @@ module Wx::GRID
   # Message class used by the grid table to send requests and notifications to the grid view.
   # A message object of this class must be sent to the grid using {Wx::GRID::Grid#process_table_message} every time the table changes, e.g. rows are added/deleted. The messages are just notifications and don't result in any actual changes but just allow the view to react to changes to the model.
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GridTableMessage < ::Object
   
     # @overload initialize()

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

@@ -207,6 +207,8 @@ module Wx
   # 
   # Category:  Window Layout
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GBSpan < ::Object
   
     # @overload initialize()
@@ -253,6 +255,8 @@ module Wx
   # 
   # Category:  Window Layout
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GBPosition < ::Object
   
     # @overload initialize()

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

@@ -34,8 +34,9 @@ module Wx
   # The remaining help controller classes need to be named explicitly by an application that wishes to make use of them.
   # The following help controller classes are defined:
   # - {Wx::WinHelpController}, for controlling Windows Help.- {Wx::CHMHelpController}, for controlling MS HTML Help. To use this, you need to set {Wx::Setup::USE_MS_HTML_HELP} to 1 in setup.h and have the htmlhelp.h header from Microsoft's HTML Help kit. (You don't need the VC++-specific htmlhelp.lib because wxWidgets loads necessary DLL at runtime and so it works with all compilers.)- {Wx::BestHelpController}, for controlling MS HTML Help or, if Microsoft's runtime is not available, {Wx::HTML::HtmlHelpController}. You need to provide <b>both</b> CHM and HTB versions of the help file. For {Wx::MSW} only.- {Wx::ExtHelpController}, for controlling external browsers under Unix. The default browser is Netscape Navigator. The 'help' sample shows its use.- {Wx::HTML::HtmlHelpController}, a sophisticated help controller using {Wx::HTML}, in a similar style to the Microsoft HTML Help viewer and using some of the same files. Although it has an API compatible with other help controllers, it has more advanced features, so it is recommended that you use the specific API for this class instead. Note that if you use .zip or .htb formats for your books, you must add this line to your application initialization: 
-  # 
+  # ```
   # wxFileSystem::AddHandler(new wxArchiveFSHandler); 
+  # ```
   # or nothing will be shown in your help window.
   # 
   # === 
@@ -119,9 +120,11 @@ module Wx
     # Sets detailed viewer information.
     # So far this is only relevant to {Wx::ExtHelpController}. Some examples of usage:
     # 
+    # ```
     #   m_help.SetViewer("kdehelp");
     #   m_help.SetViewer("gnome-help-browser");
     #   m_help.SetViewer("netscape", wxHELP_NETSCAPE);
+    # ```
     # 
     # Todomodernize this function with {Wx::LaunchDefaultBrowser}
     # @param viewer [String]  This defaults to "netscape" for {Wx::ExtHelpController}.

data/lib/wx/doc/gen/html/html_cell.rb

@@ -269,6 +269,8 @@ module Wx::HTML
   # 
   # Category:  {Wx::HTML}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class HtmlLinkInfo < Object
   
     # @overload initialize()
@@ -420,8 +422,9 @@ module Wx::HTML
     #   Sets floating width adjustment.
     #   The normal behaviour of container is that its width is the same as the width of parent container (and thus you can have only one sub-container per line). You can change this by setting the floating width adjustment.
     #   @param w [Integer]  Width of the container. If the value is negative it means complement to full width of parent container. E.g. 
-    #     
+    #     ```
     #       SetWidthFloat(-50, wxHTML_UNITS_PIXELS) 
+    #     ```
     #      sets the width of container to parent's width minus 50 pixels. This is useful when creating tables - you can call SetWidthFloat(50) and SetWidthFloat(-50).
     #   @param units [Integer]  Units of w This parameter affects the interpretation of value.
     #     - {Wx::HTML::HTML_UNITS_PIXELS}: w is number of pixels- {Wx::HTML::HTML_UNITS_PERCENT}: w is interpreted as percents of width of parent container

data/lib/wx/doc/gen/html/html_help_controller.rb

@@ -73,8 +73,9 @@ module Wx::HTML
     #   Adds a book (i.e.
     #   a .hhp file; an HTML Help Workshop project file) into the list of loaded books.
     #   This must be called at least once before displaying any help. bookFile or bookUrl may be either <code>".hhp"</code> file or a ZIP archive that contains an arbitrary number of <code>".hhp"</code> files in its top-level directory. This ZIP archive must have <code>".zip"</code> or <code>".htb"</code> extension (the latter stands for "HTML book"). In other words, 
-    #   
+    #   ```
     #     AddBook(wxFileName("help.zip"))
+    #   ```
     #    is possible and is the recommended way.
     #   @param bookFile [Wx::FileName]  Help book filename. It is recommended to use this prototype instead of the one taking URL, because it is less error-prone.
     #   @param showWaitMsg [true,false]  If true then a decoration-less window with progress message is displayed.
@@ -239,9 +240,11 @@ module Wx::HTML
     # Sets detailed viewer information.
     # So far this is only relevant to {Wx::ExtHelpController}. Some examples of usage:
     # 
+    # ```
     #   m_help.SetViewer("kdehelp");
     #   m_help.SetViewer("gnome-help-browser");
     #   m_help.SetViewer("netscape", wxHELP_NETSCAPE);
+    # ```
     # 
     # Todomodernize this function with {Wx::LaunchDefaultBrowser}
     # @param viewer [String]  This defaults to "netscape" for {Wx::ExtHelpController}.

data/lib/wx/doc/gen/html/html_help_data.rb

@@ -62,6 +62,8 @@ module Wx::HTML
   # Helper class for {Wx::HTML::HtmlHelpData}.
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class HtmlBookRecord < ::Object
   
     # @param bookfile [String] 
@@ -125,6 +127,8 @@ module Wx::HTML
   # Helper class for {Wx::HTML::HtmlHelpData}.
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class HtmlHelpDataItem < ::Object
   
     # @return [HtmlHelpDataItem]

data/lib/wx/doc/gen/html/html_help_window.rb

@@ -108,7 +108,7 @@ module Wx::HTML
   
   # This class is used by {Wx::HTML::HtmlHelpController} to display help within a frame or dialog, but you can use it yourself to create an embedded HTML help window.
   # For example: 
-  # 
+  # ```
   #   // m_embeddedHelpWindow is a wxHtmlHelpWindow
   #   // m_embeddedHtmlHelp is a wxHtmlHelpController
   #   
@@ -119,6 +119,7 @@ module Wx::HTML
   #   m_embeddedHelpWindow->Create(this, wxID_ANY, wxDefaultPosition, GetClientSize(),
   #                                wxTAB_TRAVERSAL|wxBORDER_NONE, wxHF_DEFAULT_STYLE);
   #   m_embeddedHtmlHelp.AddBook(wxFileName(wxT("doc.zip")));
+  # ```
   # 
   # You should pass the style {Wx::HTML::HF_EMBEDDED} to the style parameter of {Wx::HTML::HtmlHelpController} to allow the embedded window to be destroyed independently of the help controller.
   # === 

data/lib/wx/doc/gen/html/html_list_box.rb

@@ -56,6 +56,46 @@ module Wx::HTML
     # @return [true,false]
     def create(parent, id=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=Wx::HtmlListBoxNameStr) end
     
+    
+    protected
+    
+    # Called when the user clicks on hypertext link.
+    # Does nothing by default. Overloading this method is deprecated; intercept the event instead.
+    # @see Wx::HTML::HtmlLinkInfo. 
+    # @param n [Integer]  Index of the item containing the link.
+    # @param link [Wx::HtmlLinkInfo]  Description of the link.
+    # @return [void]
+    def on_link_clicked(n, link) end
+    
+    # This virtual function may be overridden to change the appearance of the background of the selected cells in the same way as {Wx::HTML::HtmlListBox#get_selected_text_colour}.
+    # It should be rarely, if ever, used because {Wx::VListBox#set_selection_background} allows changing the selection background for all cells at once and doing anything more fancy is probably going to look strangely.
+    # @see Wx::HTML::HtmlListBox#get_selected_text_colour 
+    # @param colBg [Wx::Colour,String,Symbol] 
+    # @return [Wx::Colour]
+    def get_selected_text_bg_colour(colBg) end
+    alias_method :selected_text_bg_colour, :get_selected_text_bg_colour
+    
+    # This virtual function may be overridden to customize the appearance of the selected cells.
+    # It is used to determine how the colour colFg is going to look inside selection. By default all original colours are completely ignored and the standard, system-dependent, selection colour is used but the program may wish to override this to achieve some custom appearance.
+    # @see Wx::HTML::HtmlListBox#get_selected_text_bg_colour
+    # @see  Wx::VListBox#set_selection_background
+    # @see  Wx::SystemSettings.get_colour 
+    # @param colFg [Wx::Colour,String,Symbol] 
+    # @return [Wx::Colour]
+    def get_selected_text_colour(colFg) end
+    alias_method :selected_text_colour, :get_selected_text_colour
+    
+    # This function may be overridden to decorate HTML returned by {Wx::HTML::HtmlListBox#on_get_item}.
+    # @param n [Integer] 
+    # @return [String]
+    def on_get_item_markup(n) end
+    
+    # This method must be implemented in the derived class and should return the body (i.e. without html nor body tags) of the HTML fragment for the given item.
+    # Note that this function should always return a text fragment for the n item which renders with the same height both when it is selected and when it's not: i.e. if you call, inside your {Wx::HTML::HtmlListBox#on_get_item} implementation, <code>IsSelected(n)</code> to make the items appear differently when they are selected, then you should make sure that the returned HTML fragment will render with the same height or else you'll see some artifacts when the user selects an item.
+    # @param n [Integer] 
+    # @return [String]
+    def on_get_item(n) end
+    
   end # HtmlListBox
   
   # {Wx::HTML::SimpleHtmlListBox} is an implementation of {Wx::HTML::HtmlListBox} which shows HTML content in the listbox rows.
@@ -117,17 +157,6 @@ module Wx::HTML
     #   @return [true,false]
     def create(*args) end
     
-    # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=Wx::HTML::HLB_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SimpleHtmlListBoxNameStr)
-    #   Constructor, creating and showing the HTML list box.
-    #   @param parent [Wx::Window]  Parent window. Must not be NULL.
-    #   @param id [Integer]  Window identifier. A value of -1 indicates a default value.
-    #   @param pos [Array(Integer, Integer), Wx::Point]  Window position. If {Wx::DEFAULT_POSITION} is specified then a default position is chosen.
-    #   @param size [Array(Integer, Integer), Wx::Size]  Window size. If {Wx::DEFAULT_SIZE} is specified then the window is sized appropriately.
-    #   @param choices [Array<String>]  An array of strings with which to initialise the control.
-    #   @param style [Integer]  Window style. See {Wx::HLB_}* flags.
-    #   @param validator [Wx::Validator]  Window validator.
-    #   @param name [String]  Window name.
-    #   @return [SimpleHtmlListBox]
     # @overload initialize(parent, id, pos, size, choices, style=Wx::HTML::HLB_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SimpleHtmlListBoxNameStr)
     #   Constructor, creating and showing the HTML list box.
     #   @param parent [Wx::Window]  Parent window. Must not be NULL.
@@ -144,6 +173,104 @@ module Wx::HTML
     #   @return [SimpleHtmlListBox]
     def initialize(*args) end
     
+    # @overload append(item)
+    #   Appends item into the control.
+    #   The return value is the index of the newly inserted item. Note that this may be different from the last one if the control is sorted (e.g. has {Wx::LB_SORT} or {Wx::CB_SORT} style).
+    #   @param item [String]  String to add.
+    #   @return [Integer]
+    # @overload append(item, clientData)
+    #   Appends item into the control.
+    #   The return value is the index of the newly inserted item. Note that this may be different from the last one if the control is sorted (e.g. has {Wx::LB_SORT} or {Wx::CB_SORT} style).
+    #   @param item [String]  String to add.
+    #   @param clientData [Object]  Pointer to client data to associate with the new item.
+    #   @return [Integer]
+    # @overload append(items)
+    #   Appends several items at once into the control.
+    #   Notice that calling this method is usually much faster than appending them one by one if you need to add a lot of items.
+    #   @param items [Array<String>]  Array of strings to insert.
+    #   @return [Integer]
+    # @overload append(items, clientData)
+    #   Appends several items at once into the control.
+    #   Notice that calling this method is usually much faster than appending them one by one if you need to add a lot of items.
+    #   @param items [Array<String>]  Array of strings to insert.
+    #   @param clientData [Array]  Array of client data pointers of the same size as items to associate with the new items.
+    #   @return [Integer]
+    def append(*args) end
+    
+    # Returns a pointer to the client data associated with the given item (if any).
+    # It is an error to call this function for a control which doesn't have untyped client data at all although it is OK to call it even if the given item doesn't have any client data associated with it (but other items do).
+    # 
+    # A pointer to the client data, or NULL if not present.
+    # @param n [Integer]  The zero-based position of the item.
+    # @return [Object]
+    def get_client_data(n) end
+    alias_method :client_data, :get_client_data
+    
+    # Associates the given untyped client data pointer with the given item.
+    # Note that it is an error to call this function if any typed client data pointers had been associated with the control items before.
+    # @param n [Integer]  The zero-based item index.
+    # @param data [Object]  The client data to associate with the item.
+    # @return [void]
+    def set_client_data(n, data) end
+    
+    # @overload insert(item, pos)
+    #   Inserts item into the control.
+    #   The return value is the index of the newly inserted item. If the insertion failed for some reason, -1 is returned.
+    #   @param item [String]  String to add.
+    #   @param pos [Integer]  Position to insert item before, zero based.
+    #   @return [Integer]
+    # @overload insert(item, pos, clientData)
+    #   Inserts item into the control.
+    #   The return value is the index of the newly inserted item. If the insertion failed for some reason, -1 is returned.
+    #   @param item [String]  String to add.
+    #   @param pos [Integer]  Position to insert item before, zero based.
+    #   @param clientData [Object]  Pointer to client data to associate with the new item.
+    #   @return [Integer]
+    # @overload insert(items, pos)
+    #   Inserts several items at once into the control.
+    #   Notice that calling this method is usually much faster than inserting them one by one if you need to insert a lot of items.
+    #   
+    #   The return value is the index of the last inserted item. If the insertion failed for some reason, -1 is returned.
+    #   @param items [Array<String>]  Array of strings to insert.
+    #   @param pos [Integer]  Position to insert the items before, zero based.
+    #   @return [Integer]
+    # @overload insert(items, pos, clientData)
+    #   Inserts several items at once into the control.
+    #   Notice that calling this method is usually much faster than inserting them one by one if you need to insert a lot of items.
+    #   
+    #   The return value is the index of the last inserted item. If the insertion failed for some reason, -1 is returned.
+    #   @param items [Array<String>]  Array of strings to insert.
+    #   @param pos [Integer]  Position to insert the items before, zero based.
+    #   @param clientData [Array]  Array of client data pointers of the same size as items to associate with the new items.
+    #   @return [Integer]
+    def insert(*args) end
+    
+    # @overload set(items)
+    #   Replaces the current control contents with the given items.
+    #   Notice that calling this method is usually much faster than appending them one by one if you need to add a lot of items.
+    #   @param items [Array<String>]  Array of strings to insert.
+    #   @return [void]
+    # @overload set(items, clientData)
+    #   Replaces the current control contents with the given items.
+    #   Notice that calling this method is usually much faster than appending them one by one if you need to add a lot of items.
+    #   @param items [Array<String>]  Array of strings to insert.
+    #   @param clientData [Array]  Array of client data pointers of the same size as items to associate with the new items.
+    #   @return [void]
+    def set(*args) end
+    
+    # Deletes an item from the control.
+    # The client data associated with the item will be also deleted if it is owned by the control. Note that it is an error (signalled by an assert failure in debug builds) to remove an item with the index negative or greater or equal than the number of items in the control.
+    # If there is a currently selected item below the item being deleted, i.e. if {Wx::HTML::SimpleHtmlListBox#get_selection} returns a valid index greater than or equal to n, the selection is invalidated when this function is called. However if the selected item appears before the item being deleted, the selection is preserved unchanged.
+    # @see Wx::HTML::SimpleHtmlListBox#clear 
+    # @param n [Integer]  The zero-based item index.
+    # @return [void]
+    def delete(n) end
+    
+    # Returns true, if either untyped data (<code>void*</code>) or object data ({Wx::ClientData}*) is associated with the items of the control.
+    # @return [true,false]
+    def has_client_data; end
+    alias_method :has_client_data?, :has_client_data
+    
   end # SimpleHtmlListBox
   
 

data/lib/wx/doc/gen/html/html_window.rb

@@ -273,7 +273,9 @@ module Wx::HTML
     alias_method :standard_fonts=, :set_standard_fonts
     
     # Sets the source of a page and displays it, for example:
-    # htmlwin -> SetPage("<html><body>Hello, world!</body></html>");
+    # ```
+    #   htmlwin -> SetPage("<html><body>Hello, world!</body></html>");
+    # ```
     # 
     # If you want to load a document from some location use {Wx::HTML::HtmlWindow#load_page} instead.
     # 
@@ -319,9 +321,11 @@ module Wx::HTML
     # Adds an input filter to the static list of available filters.
     # These filters are present by default:
     # 
+    # ```
     #   text/html
     #   text/plain
     #   image/*
+    # ```
     # 
     # The plain text filter will be used if no other filter matches.
     # @param filter [Wx::HtmlFilter] 
@@ -358,11 +362,12 @@ module Wx::HTML
     
     # Returns true if this filter is capable of reading file file.
     # Example: 
-    # 
+    # ```
     #   bool MyFilter::CanRead(const wxFSFile& file)
     #   {
     #       return (file.GetMimeType() == "application/x-ugh");
     #   }
+    # ```
     # @param file [Wx::FSFile] 
     # @return [true,false]
     def can_read(file) end
@@ -370,12 +375,13 @@ module Wx::HTML
     
     # Reads the file and returns string with HTML document.
     # Example: 
-    # 
+    # ```
     #   wxString MyImgFilter::ReadFile(const wxFSFile& file)
     #   {
     #       return "<html><body><img src=\"" + file.GetLocation() +
     #              "\"></body></html>";
     #   }
+    # ```
     # @param file [Wx::FSFile] 
     # @return [String]
     def read_file(file) end

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

@@ -32,6 +32,8 @@ module Wx
   # @see  Wx::Cursor 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Icon < GDIObject
   
     # @overload initialize()
@@ -149,6 +151,8 @@ module Wx
   # Category:  Graphics Device Interface (GDI)
   # Predefined objects/pointers: {Wx::NULL_ICON_BUNDLE}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class IconBundle < GDIObject
   
     # Return invalid icon if exact size is not found.
@@ -231,7 +235,9 @@ module Wx
     #   @return [Wx::Icon]
     # @overload get_icon(size=Wx::DEFAULT_COORD, flags=Wx::IconBundle::FALLBACK_SYSTEM)
     #   Same as.
-    #   GetIcon( wxSize( size, size ) ) 
+    #   ```
+    #     GetIcon( wxSize( size, size ) ) 
+    #   ```
     #   .
     #   @param size [Integer] 
     #   @param flags [Integer] 

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

@@ -16,6 +16,8 @@ module Wx
   # @see  Wx::FileType::GetIcon 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class IconLocation < ::Object
   
     # Returns true if the object is valid, i.e. was properly initialized, and false otherwise.