wxruby3 0.9.2-x64-mingw-ucrt → 0.9.4-x64-mingw-ucrt

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

@@ -7,6 +7,7 @@
 module Wx
 
   # A combobox is like a combination of an edit control and a listbox.
+  # 
   # It can be displayed as static list with editable or read-only text field; or a drop-down list with text field; or a drop-down list without a text field depending on the platform and presence of {Wx::CB_READONLY} style.
   # A combobox permits a single selection only. Combobox items are numbered from zero.
   # If you need a customized combobox, have a look at {Wx::ComboCtrl}, {Wx::OwnerDrawnComboBox}, {Wx::ComboPopup} and the ready-to-use {Wx::BitmapComboBox}.
@@ -57,6 +58,7 @@ module Wx
   
     # @overload create(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=((CONST Wx::STRING *) nil), style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Creates the combobox for two-step construction.
+    #   
     #   Derived classes should call or replace this function. See {Wx::ComboBox#initialize} for further details.
     #   @param parent [Wx::Window] 
     #   @param id [Integer] 
@@ -70,6 +72,7 @@ module Wx
     #   @return [Boolean]
     # @overload create(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Creates the combobox for two-step construction.
+    #   
     #   Derived classes should call or replace this function. See {Wx::ComboBox#initialize} for further details.
     #   @param parent [Wx::Window] 
     #   @param id [Integer] 
@@ -89,6 +92,7 @@ module Wx
     # @overload initialize(parent, id, value=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, choices=nil, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Constructor, creating and showing a combobox.
     #   
+    #   
     #   @see Wx::ComboBox#create
     #   @see  Wx::Validator 
     #   @param parent [Wx::Window]  Parent window. Must not be NULL.
@@ -104,6 +108,7 @@ module Wx
     # @overload initialize(parent, id, value, pos, size, choices, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::COMBO_BOX_NAME_STR)
     #   Constructor, creating and showing a combobox.
     #   
+    #   
     #   @see Wx::ComboBox#create
     #   @see  Wx::Validator 
     #   @param parent [Wx::Window]  Parent window. Must not be NULL.
@@ -119,12 +124,14 @@ module Wx
     def initialize(*args) end
     
     # Returns the item being selected right now.
+    # 
     # This function does the same things as {Wx::Choice#get_current_selection} and returns the item currently selected in the dropdown list if it's open or the same thing as {Wx::ControlWithItems#get_selection} otherwise.
     # @return [Integer]
     def get_current_selection; end
     alias_method :current_selection, :get_current_selection
     
     # Same as {Wx::TextEntry#get_insertion_point}.
+    # 
     # <div class="wxrb-note">
     # <b>Note:</b>
     # <p>Under WXMSW, this function always returns 0 if the combobox doesn't have the focus. 
@@ -135,12 +142,14 @@ module Wx
     alias_method :insertion_point, :get_insertion_point
     
     # Returns true if the list of combobox choices is empty.
+    # 
     # Use this method instead of (not available in this class) {Wx::ComboBox#is_empty} to test if the list of items is empty.
     # @return [Boolean]
     def is_list_empty; end
     alias_method :list_empty?, :is_list_empty
     
     # Returns true if the text of the combobox is empty.
+    # 
     # Use this method instead of (not available in this class) {Wx::ComboBox#is_empty} to test if the text currently entered into the combobox is empty.
     # @return [Boolean]
     def is_text_empty; end
@@ -151,9 +160,9 @@ module Wx
     # @param to [Integer] 
     # @return [void]
     def set_text_selection_range(from, to) end
-    alias_method :text_selection_range=, :set_text_selection_range
     
     # Sets the selection to the given item n or removes the selection entirely if n == {Wx::NOT_FOUND}.
+    # 
     # Note that this does not cause any command events to be emitted nor does it deselect any other items in the controls which support multiple selections.
     # @see Wx::ComboBox#set_string
     # @see  Wx::ComboBox#set_string_selection 
@@ -163,6 +172,7 @@ module Wx
     alias_method :selection=, :set_selection
     
     # Sets the text for the combobox text field.
+    # 
     # For normal, editable comboboxes with a text entry field calling this method will generate a {Wx::EVT_TEXT} event, consistently with {Wx::TextEntry#set_value} behaviour, use {Wx::TextEntry#change_value} if this is undesirable.
     # For controls with {Wx::CB_READONLY} style the method behaves somewhat differently: the string must be in the combobox choices list (the check for this is case-insensitive) and {Wx::EVT_TEXT} is not generated in this case.
     # @param text [String]  The text to set.
@@ -171,18 +181,21 @@ module Wx
     alias_method :value=, :set_value
     
     # Shows the list box portion of the combo box.
+    # 
     # Currently this method is implemented in WXMSW, WXGTK and WXOSX/Cocoa.
     # Notice that calling this function will generate a {Wx::EVT_COMBOBOX_DROPDOWN} event except under WXOSX where generation of this event is not supported at all.
     # @return [void]
     def popup; end
     
     # Hides the list box portion of the combo box.
+    # 
     # Currently this method is implemented in WXMSW, WXGTK and WXOSX/Cocoa.
     # Notice that calling this function will generate a {Wx::EVT_COMBOBOX_CLOSEUP} event except under WXOSX where generation of this event is not supported at all.
     # @return [void]
     def dismiss; end
     
     # Returns the index of the selected item or {Wx::NOT_FOUND} if no item is selected.
+    # 
     # The position of the current selection.
     # @see Wx::ComboBox#set_selection
     # @see  Wx::ComboBox#get_string_selection 
@@ -191,12 +204,14 @@ module Wx
     alias_method :selection, :get_selection
     
     # Gets the current selection span.
+    # 
     # If the returned values are equal, there was no selection. Please note that the indices returned may be used with the other {Wx::TextCtrl} methods but don't necessarily represent the correct indices into the string returned by {Wx::ComboBox#get_value} for multiline controls under Windows (at least,) you should use {Wx::ComboBox#get_string_selection} to get the selected text.
     # @return [Array(Integer,Integer)]
     def get_text_selection_range; end
     alias_method :text_selection_range, :get_text_selection_range
     
     # Finds an item whose label matches the given string.
+    # 
     # The zero-based position of the item, or {Wx::NOT_FOUND} if the string was not found.
     # @param string [String]  String to find.
     # @param caseSensitive [Boolean]  Whether search is case sensitive (default is not).
@@ -204,6 +219,7 @@ module Wx
     def find_string(string, caseSensitive=false) end
     
     # Returns the label of the item with the given index.
+    # 
     # The index must be valid, i.e. less than the value returned by {Wx::ComboBox#get_count}, otherwise an assert is triggered. Notably, this function can't be called if the control is empty.
     # 
     # The label of the item.
@@ -213,12 +229,14 @@ module Wx
     alias_method :string, :get_string
     
     # Gets the text currently selected in the control.
+    # 
     # If there is no selection, the returned string is empty.
     # @return [String]
     def get_string_selection; end
     alias_method :string_selection, :get_string_selection
     
     # Changes the text of the specified combobox item.
+    # 
     # Notice that if the item is the currently selected one, i.e. if its text is displayed in the text part of the combobox, then the text is also replaced with the new text.
     # @param n [Integer] 
     # @param text [String] 
@@ -227,6 +245,7 @@ module Wx
     
     # Returns the number of items in the control.
     # 
+    # 
     # @see Wx::ComboBox#is_empty 
     # @return [Integer]
     def get_count; end