wxruby3 1.6.1 → 1.7.0

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

@@ -0,0 +1,258 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  module HTML
+
+    # 
+    # 
+    ID_HTML_PANEL = 6010
+    
+    # 
+    # 
+    ID_HTML_BACK = 6011
+    
+    # 
+    # 
+    ID_HTML_FORWARD = 6012
+    
+    # 
+    # 
+    ID_HTML_UPNODE = 6013
+    
+    # 
+    # 
+    ID_HTML_UP = 6014
+    
+    # 
+    # 
+    ID_HTML_DOWN = 6015
+    
+    # 
+    # 
+    ID_HTML_PRINT = 6016
+    
+    # 
+    # 
+    ID_HTML_OPENFILE = 6017
+    
+    # 
+    # 
+    ID_HTML_OPTIONS = 6018
+    
+    # 
+    # 
+    ID_HTML_BOOKMARKSLIST = 6019
+    
+    # 
+    # 
+    ID_HTML_BOOKMARKSADD = 6020
+    
+    # 
+    # 
+    ID_HTML_BOOKMARKSREMOVE = 6021
+    
+    # 
+    # 
+    ID_HTML_TREECTRL = 6022
+    
+    # 
+    # 
+    ID_HTML_INDEXPAGE = 6023
+    
+    # 
+    # 
+    ID_HTML_INDEXLIST = 6024
+    
+    # 
+    # 
+    ID_HTML_INDEXTEXT = 6025
+    
+    # 
+    # 
+    ID_HTML_INDEXBUTTON = 6026
+    
+    # 
+    # 
+    ID_HTML_INDEXBUTTONALL = 6027
+    
+    # 
+    # 
+    ID_HTML_NOTEBOOK = 6028
+    
+    # 
+    # 
+    ID_HTML_SEARCHPAGE = 6029
+    
+    # 
+    # 
+    ID_HTML_SEARCHTEXT = 6030
+    
+    # 
+    # 
+    ID_HTML_SEARCHLIST = 6031
+    
+    # 
+    # 
+    ID_HTML_SEARCHBUTTON = 6032
+    
+    # 
+    # 
+    ID_HTML_SEARCHCHOICE = 6033
+    
+    # 
+    # 
+    ID_HTML_COUNTINFO = 6034
+    
+    # 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: 
+    # ```ruby
+    #   # @embeddedHelpWindow is a wxHtmlHelpWindow
+    #   # @embeddedHtmlHelp is a wxHtmlHelpController
+    #   #   
+    #   # Create embedded HTML Help window
+    #   @embeddedHelpWindow = Wx::HTML::HtmlHelpWindow.new
+    #   @embeddedHtmlHelp.use_config(config, rootPath) # Set your own config object here
+    #   @embeddedHtmlHelp.set_help_window(@embeddedHelpWindow)
+    #   @embeddedHelpWindow.create(self, Wx::ID_ANY, 
+    #                              size: get_client_size,
+    #                              style: Wx::TAB_TRAVERSAL|Wx::BORDER_NONE)
+    #   @embeddedHtmlHelp.add_book('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.
+    # 
+    # Category:  {Wx::HELP}, {Wx::HTML}
+    # 
+    # @wxrb_require USE_HELP,USE_HTML
+    class HtmlHelpWindow < Window
+    
+      # @overload initialize(data=nil)
+      #   @param data [Wx::HTML::HtmlHelpData] 
+      #   @return [Wx::HTML::HtmlHelpWindow]
+      # @overload initialize(data=nil, &block)
+      #   @param data [Wx::HTML::HtmlHelpData] 
+      #   @yieldparam [Wx::HTML::HtmlHelpWindow] win new instance
+      #   @return [Wx::HTML::HtmlHelpWindow]
+      # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::TAB_TRAVERSAL|Wx::Border::BORDER_NONE), helpStyle=Wx::HF_DEFAULT_STYLE, data=nil)
+      #   Constructor.
+      #   
+      #   For the values of helpStyle, please see the documentation for {Wx::HTML::HtmlHelpController}.
+      #   @param parent [Wx::Window] 
+      #   @param id [Integer] 
+      #   @param pos [Array(Integer, Integer), Wx::Point] 
+      #   @param size [Array(Integer, Integer), Wx::Size] 
+      #   @param style [Integer] 
+      #   @param helpStyle [Integer] 
+      #   @param data [Wx::HTML::HtmlHelpData] 
+      #   @return [Wx::HTML::HtmlHelpWindow]
+      # @overload initialize(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::TAB_TRAVERSAL|Wx::Border::BORDER_NONE), helpStyle=Wx::HF_DEFAULT_STYLE, data=nil, &block)
+      #   Constructor.
+      #   
+      #   For the values of helpStyle, please see the documentation for {Wx::HTML::HtmlHelpController}.
+      #   @param parent [Wx::Window] 
+      #   @param id [Integer] 
+      #   @param pos [Array(Integer, Integer), Wx::Point] 
+      #   @param size [Array(Integer, Integer), Wx::Size] 
+      #   @param style [Integer] 
+      #   @param helpStyle [Integer] 
+      #   @param data [Wx::HTML::HtmlHelpData] 
+      #   @yieldparam [Wx::HTML::HtmlHelpWindow] win new instance
+      #   @return [Wx::HTML::HtmlHelpWindow]
+      def initialize(*args) end
+      
+      # Creates the help window.
+      # 
+      # See the constructor for a description of the parameters.
+      # @param parent [Wx::Window] 
+      # @param id [Integer] 
+      # @param pos [Array(Integer, Integer), Wx::Point] 
+      # @param size [Array(Integer, Integer), Wx::Size] 
+      # @param style [Integer] 
+      # @param helpStyle [Integer] 
+      # @return [Boolean]
+      def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::TAB_TRAVERSAL|Wx::Border::BORDER_NONE), helpStyle=Wx::HF_DEFAULT_STYLE) end
+      
+      # @overload display(x)
+      #   Displays page x.
+      #   
+      #   If not found it will give the user the choice of searching books. Looking for the page runs in these steps:
+      #   
+      #   - try to locate file named x (if x is for example "doc/howto.htm")
+      #   - try to open starting page of book x
+      #   - try to find x in contents (if x is for example "How To ...")
+      #   - try to find x in index (if x is for example "How To ...")
+      #   @param x [String] 
+      #   @return [Boolean]
+      # @overload display(id)
+      #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
+      #   This form takes numeric ID as the parameter (uses an extension to MS format, param name="ID" value=id).
+      #   @param id [Integer] 
+      #   @return [Boolean]
+      def display(*args) end
+      
+      # Displays contents panel.
+      # @return [Boolean]
+      def display_contents; end
+      
+      # Displays index panel.
+      # @return [Boolean]
+      def display_index; end
+      
+      # Returns the {Wx::HTML::HtmlHelpData} object, which is usually a pointer to the controller's data.
+      # @return [Wx::HTML::HtmlHelpData]
+      def get_data; end
+      alias_method :data, :get_data
+      
+      # Search for given keyword.
+      # 
+      # Optionally it searches through the index (mode = {Wx::HelpSearchMode::HELP_SEARCH_INDEX}), default the content (mode = {Wx::HelpSearchMode::HELP_SEARCH_ALL}).
+      # @param keyword [String] 
+      # @param mode [Wx::HelpSearchMode] 
+      # @return [Boolean]
+      def keyword_search(keyword, mode=Wx::HelpSearchMode::HELP_SEARCH_ALL) end
+      
+      # Reads the user's settings for this window.
+      # 
+      # 
+      # @see Wx::HTML::HtmlHelpController#read_customization 
+      # @param cfg [Wx::ConfigBase] 
+      # @param path [String] 
+      # @return [void]
+      def read_customization(cfg, path=('')) end
+      
+      # Saves the user's settings for this window.
+      # 
+      # 
+      # @see Wx::HTML::HtmlHelpController#write_customization 
+      # @param cfg [Wx::ConfigBase] 
+      # @param path [String] 
+      # @return [void]
+      def write_customization(cfg, path=('')) end
+      
+      # Refresh all panels.
+      # 
+      # This is necessary if a new book was added.
+      # @return [void]
+      def refresh_lists; end
+      
+      # @return [Wx::HTML::HtmlHelpController]
+      def get_controller; end
+      alias_method :controller, :get_controller
+      
+      # @param controller [Wx::HTML::HtmlHelpController] 
+      # @return [void]
+      def set_controller(controller) end
+      alias_method :controller=, :set_controller
+      
+    end # HtmlHelpWindow
+    
+
+  end
+
+end

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

@@ -0,0 +1,41 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  module HTML
+
+    # This event class is used for the events generated by {Wx::HTML::HtmlWindow}.
+    # 
+    # ### Events using this class
+    # 
+    # The following event-handler methods redirect the events to member method or handler blocks for {Wx::HTML::HtmlLinkEvent} events.
+    # Event handler methods:
+    # 
+    # - {Wx::EvtHandler#evt_html_link_clicked}(id, meth = nil, &block): User clicked on a hyperlink. 
+    # 
+    # Category:  {Wx::HTML}, {Wx::Events}
+    # 
+    # @wxrb_require USE_HTML
+    class HtmlLinkEvent < CommandEvent
+    
+      # The constructor is not normally used by the user code.
+      # @param id [Integer] 
+      # @param linkinfo [Wx::HTML::HtmlLinkInfo] 
+      # @return [Wx::HTML::HtmlLinkEvent]
+      def initialize(id, linkinfo) end
+      
+      # Returns the {Wx::HTML::HtmlLinkInfo} which contains info about the cell clicked and the hyperlink it contains.
+      # @return [Wx::HTML::HtmlLinkInfo]
+      def get_link_info; end
+      alias_method :link_info, :get_link_info
+      
+    end # HtmlLinkEvent
+    
+
+  end
+
+end

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

@@ -0,0 +1,346 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  module HTML
+
+    # 
+    HLB_DEFAULT_STYLE = 134217728
+    
+    # 
+    HLB_MULTIPLE = 64
+    
+    # {Wx::HTML::HtmlListBox} is an implementation of {Wx::VListBox} which shows HTML content in the listbox rows.
+    # 
+    # This is still an abstract base class and you will need to derive your own class from it (see htlbox sample for the example), but you will only need to override a single {Wx::HTML::HtmlListBox#on_get_item} function.
+    # ### Events emitted by this class
+    # 
+    # The following event-handler methods redirect the events to member method or handler blocks for {Wx::HTML::HtmlLinkEvent} events.
+    # Event handler methods for events emitted by this class:
+    # 
+    # - {Wx::EvtHandler#evt_html_cell_clicked}(id, meth = nil, &block): A {Wx::HTML::HtmlCell} was clicked. 
+    # 
+    # - {Wx::EvtHandler#evt_html_cell_hover}(id, meth = nil, &block): The mouse passed over a {Wx::HTML::HtmlCell}. 
+    # 
+    # - {Wx::EvtHandler#evt_html_link_clicked}(id, meth = nil, &block): A {Wx::HTML::HtmlCell} which contains a hyperlink was clicked. 
+    # 
+    # Category:  {Wx::Controls}
+    # @see Wx::HTML::SimpleHtmlListBox 
+    # 
+    # 
+    # @wxrb_require USE_HTML
+    class HtmlListBox < VListBox
+    
+      # @overload initialize(parent, id=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=Wx::HTML_LIST_BOX_NAME_STR)
+      #   Normal constructor which calls {Wx::HTML::HtmlListBox#create} internally.
+      #   @param parent [Wx::Window] 
+      #   @param id [Integer] 
+      #   @param pos [Array(Integer, Integer), Wx::Point] 
+      #   @param size [Array(Integer, Integer), Wx::Size] 
+      #   @param style [Integer] 
+      #   @param name [String] 
+      #   @return [Wx::HTML::HtmlListBox]
+      # @overload initialize()
+      #   Default constructor, you must call {Wx::HTML::HtmlListBox#create} later.
+      #   @return [Wx::HTML::HtmlListBox]
+      def initialize(*args) end
+      
+      # Creates the control and optionally sets the initial number of items in it (it may also be set or changed later with {Wx::VListBox#set_item_count}).
+      # 
+      # There are no special styles defined for {Wx::HTML::HtmlListBox}, in particular the {Wx::ListBox} styles (with the exception of {Wx::LB_MULTIPLE}) cannot be used here.
+      # Returns true on success or false if the control couldn't be created
+      # @param parent [Wx::Window] 
+      # @param id [Integer] 
+      # @param pos [Array(Integer, Integer), Wx::Point] 
+      # @param size [Array(Integer, Integer), Wx::Size] 
+      # @param style [Integer] 
+      # @param name [String] 
+      # @return [Boolean]
+      def create(parent, id=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=Wx::HTML_LIST_BOX_NAME_STR) 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::HTML::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.
+    # 
+    # Unlike {Wx::HTML::HtmlListBox}, this is not an abstract class and thus it has the advantage that you can use it without deriving your own class from it. However, it also has the disadvantage that this is not a virtual control and thus it's not well-suited for those cases where you need to show a huge number of items: every time you add/insert a string, it will be stored internally and thus will take memory.
+    # The interface exposed by {Wx::HTML::SimpleHtmlListBox} fully implements the {Wx::ControlWithItems} interface, thus you should refer to {Wx::ControlWithItems}'s documentation for the API reference for adding/removing/retrieving items in the listbox. Also note that the {Wx::VListBox#set_item_count} function is protected in {Wx::HTML::SimpleHtmlListBox}'s context so that you cannot call it directly, {Wx::HTML::SimpleHtmlListBox} will do it for you.
+    # Note: in case you need to append a lot of items to the control at once, make sure to use the Append(const wxArrayString&) function.
+    # Thus the only difference between a {Wx::ListBox} and a {Wx::HTML::SimpleHtmlListBox} is that the latter stores strings which can contain HTML fragments (see the list of tags supported by wxHTML).
+    # Note that the HTML strings you fetch to {Wx::HTML::SimpleHtmlListBox} should not contain the <code><html></code> or <code><body></code> tags.
+    # ### Styles
+    # 
+    # This class supports the following styles:
+    # 
+    # - {Wx::HTML::HLB_DEFAULT_STYLE}: The default style: {Wx::Border::BORDER_SUNKEN} 
+    # 
+    # - {Wx::HTML::HLB_MULTIPLE}: Multiple-selection list: the user can toggle multiple items on and off. 
+    # 
+    # A {Wx::HTML::SimpleHtmlListBox} emits the same events used by {Wx::ListBox} and by {Wx::HTML::HtmlListBox}.
+    # ### Events emitted by this class
+    # 
+    # Event handler methods for events emitted by this class:
+    # 
+    # - {Wx::EvtHandler#evt_listbox}(id, meth = nil, &block): Process a {Wx::EVT_LISTBOX} event, when an item on the list is selected. See {Wx::CommandEvent}. 
+    # 
+    # - {Wx::EvtHandler#evt_listbox_dclick}(id, meth = nil, &block): Process a {Wx::EVT_LISTBOX_DCLICK} event, when the listbox is double-clicked. See {Wx::CommandEvent}. 
+    # 
+    # - {Wx::EvtHandler#evt_html_cell_clicked}(id, meth = nil, &block): A {Wx::HTML::HtmlCell} was clicked. See {Wx::HTML::HtmlCellEvent}. 
+    # 
+    # - {Wx::EvtHandler#evt_html_cell_hover}(id, meth = nil, &block): The mouse passed over a {Wx::HTML::HtmlCell}. See {Wx::HTML::HtmlCellEvent}. 
+    # 
+    # - {Wx::EvtHandler#evt_html_link_clicked}(id, meth = nil, &block): A {Wx::HTML::HtmlCell} which contains a hyperlink was clicked. See {Wx::HTML::HtmlLinkEvent} 
+    # 
+    # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table class='appearance'><tr><td> Generic Appearance
+    #   </td></tr></table></div>
+    # @see Wx::HTML::SimpleHtmlListBox#create 
+    # 
+    # 
+    # @wxrb_require USE_HTML
+    class SimpleHtmlListBox < HtmlListBox
+    
+      # @overload create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=Wx::HTML::HLB_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SIMPLE_HTML_LIST_BOX_NAME_STR)
+      #   Creates the HTML listbox for two-step construction.
+      #   
+      #   See {Wx::HTML::SimpleHtmlListBox#initialize} for further details.
+      #   @param parent [Wx::Window] 
+      #   @param id [Integer] 
+      #   @param pos [Array(Integer, Integer), Wx::Point] 
+      #   @param size [Array(Integer, Integer), Wx::Size] 
+      #   @param choices [Array<String>] 
+      #   @param style [Integer] 
+      #   @param validator [Wx::Validator] 
+      #   @param name [String] 
+      #   @return [Boolean]
+      # @overload create(parent, id, pos, size, choices, style=Wx::HTML::HLB_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SIMPLE_HTML_LIST_BOX_NAME_STR)
+      #   Creates the HTML listbox for two-step construction.
+      #   
+      #   See {Wx::HTML::SimpleHtmlListBox#initialize} for further details.
+      #   @param parent [Wx::Window] 
+      #   @param id [Integer] 
+      #   @param pos [Array(Integer, Integer), Wx::Point] 
+      #   @param size [Array(Integer, Integer), Wx::Size] 
+      #   @param choices [Array<String>] 
+      #   @param style [Integer] 
+      #   @param validator [Wx::Validator] 
+      #   @param name [String] 
+      #   @return [Boolean]
+      def create(*args) end
+      
+      # @overload initialize(parent, id, pos, size, choices, style=Wx::HTML::HLB_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SIMPLE_HTML_LIST_BOX_NAME_STR)
+      #   Constructor, creating and showing the HTML list box.
+      #   @param parent [Wx::Window]  Parent window. Must not be nil.
+      #   @param id [Integer]  Window identifier. A value of -1 indicates a default value.
+      #   @param pos [Array(Integer, Integer), Wx::Point]  Window position.
+      #   @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 [Wx::HTML::SimpleHtmlListBox]
+      # @overload initialize(parent, id, pos, size, choices, style=Wx::HTML::HLB_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::SIMPLE_HTML_LIST_BOX_NAME_STR, &block)
+      #   Constructor, creating and showing the HTML list box.
+      #   @param parent [Wx::Window]  Parent window. Must not be nil.
+      #   @param id [Integer]  Window identifier. A value of -1 indicates a default value.
+      #   @param pos [Array(Integer, Integer), Wx::Point]  Window position.
+      #   @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.
+      #   @yieldparam [Wx::HTML::SimpleHtmlListBox] win new instance
+      #   @return [Wx::HTML::SimpleHtmlListBox]
+      # @overload initialize()
+      #   Default constructor, you must call {Wx::HTML::SimpleHtmlListBox#create} later.
+      #   @return [Wx::HTML::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 [Wx::ClientData]  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 typed 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).
+      # Notice that the returned pointer is still owned by the control and will be deleted by it, use {Wx::HTML::SimpleHtmlListBox#detach_client_object} if you want to remove the pointer from the control.
+      # 
+      # A pointer to the client data, or nil if not present.
+      # @param n [Integer]  The zero-based position of the item.
+      # @return [Object]
+      def get_client_object(n) end
+      alias_method :client_object, :get_client_object
+      
+      # Associates the given typed client data pointer with the given item: the data object will be deleted when the item is deleted (either explicitly by using {Wx::HTML::SimpleHtmlListBox#delete} or implicitly when the control itself is destroyed).
+      # 
+      # Note that it is an error to call this function if any untyped 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_object(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 [Wx::ClientData]  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 [Wx::ClientData]  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
+      
+      # The control may maintain its items in a sorted order in which case items are automatically inserted at the right position when they are inserted or appended.
+      # 
+      # Returns true if the control maintains its items in a sorted order.
+      # @return [Boolean]
+      def is_sorted; end
+      alias_method :sorted?, :is_sorted
+      
+      # Returns the client object associated with the given item and transfers its ownership to the caller.
+      # 
+      # This method, unlike {Wx::HTML::SimpleHtmlListBox#get_client_object}, expects the caller to delete the returned pointer. It also replaces the internally stored pointer with nil, i.e. completely detaches the client object pointer from the control.
+      # It's an error to call this method unless {Wx::HTML::SimpleHtmlListBox#has_client_object_data} returns true.
+      # 
+      # The associated client object pointer to be deleted by caller or nil.
+      # @param n [Integer]  The zero-based item index.
+      # @return [Object]
+      def detach_client_object(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 [Boolean]
+      def has_client_data; end
+      alias_method :has_client_data?, :has_client_data
+      
+      # Returns true, if object data is associated with the items of the control.
+      # 
+      # Object data pointers have the type <code>wxClientData*</code> instead of <code>void*</code> and, importantly, are owned by the control, i.e. will be deleted by it, unlike their untyped counterparts.
+      # @return [Boolean]
+      def has_client_object_data; end
+      alias_method :has_client_object_data?, :has_client_object_data
+      
+    end # SimpleHtmlListBox
+    
+
+  end
+
+end