Class: Wx::ListBox

Inherits:
ControlWithItems show all
Defined in:
lib/wx/doc/gen/list_box.rb

Overview

A listbox is used to select one or more of a list of strings.

The strings are displayed in a scrolling box, with the selected string(s) marked in reverse video. A listbox can be single selection (if an item is selected, the previous selection is removed) or multiple selection (clicking an item toggles the item on or off independently of other selections). List box elements are numbered from zero and while the maximal number of elements is unlimited, it is usually better to use a virtual control, not requiring to add all the items to it at once, such as DataViewCtrl or ListCtrl with LC_VIRTUAL style, once more than a few hundreds items need to be displayed because this control is not optimized, neither from performance nor from user interface point of view, for large number of items. Notice that the list box doesn’t support control characters other than TAB.

Styles

This class supports the following styles:

  • LB_SINGLE: Single-selection list.

  • LB_MULTIPLE: Multiple-selection list: the user can toggle multiple items on and off. This is the same as LB_EXTENDED in WXGTK2 port.

  • LB_EXTENDED: Extended-selection list: the user can extend the selection by using SHIFT or CTRL keys together with the cursor movement keys or the mouse.

  • LB_HSCROLL: Create horizontal scrollbar if contents are too wide (Windows only).

  • LB_ALWAYS_SB: Always show a vertical scrollbar.

  • LB_NEEDED_SB: Only create a vertical scrollbar if needed.

  • LB_NO_SB: Don't create vertical scrollbar (WXMSW and WXGTK only).

  • LB_SORT: The listbox contents are sorted in alphabetical order.

Note that LB_SINGLE, LB_MULTIPLE and LB_EXTENDED styles are mutually exclusive and you can specify at most one of them (single selection is the default). See also Window Styles.

Events emitted by this class

The following event-handler methods redirect the events to member method or handler blocks for CommandEvent events. Event handler methods for events emitted by this class:

Category: 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 Also:

Requires:

  • USE_LISTBOX

Direct Known Subclasses

CheckListBox

Instance Method Summary collapse

Methods inherited from ControlWithItems

#append, #clear, #delete, #detach_client_object, #each_string, #get_client_data, #get_client_object, #get_list_selection, #get_list_string_selection, #get_string_selection, #get_strings, #has_client_data, #has_client_object_data, #insert, #is_empty, #is_sorted, #select, #set, #set_client_data, #set_client_object, #set_list_selection, #set_list_string_selection

Methods inherited from Control

#command, ellipsize, escape_mnemonics, #get_label, #get_label_text, #get_size_from_text, #get_size_from_text_size, remove_mnemonics, #set_label, #set_label_markup, #set_label_text

Methods inherited from Window

#accepts_focus, #accepts_focus_from_keyboard, #accepts_focus_recursively, #add_child, #adjust_for_layout_direction, #always_show_scrollbars, #begin_repositioning_children, #cache_best_size, #can_accept_focus, #can_accept_focus_from_keyboard, #can_scroll, #can_set_transparent, #capture_mouse, #center, #center_on_parent, #centre, #centre_on_parent, #clear_background, #client_to_screen, #client_to_window_size, #close, #convert_dialog_to_pixels, #convert_pixels_to_dialog, #destroy, #destroy_children, #disable, #disable_focus_from_keyboard, #do_update_window_ui, #drag_accept_files, #each_child, #enable, #enable_touch_events, #enable_visible_focus, #end_repositioning_children, find_focus, #find_window_by_id, find_window_by_id, #find_window_by_label, find_window_by_label, #find_window_by_name, find_window_by_name, #fit, #fit_inside, #freeze, #from_dip, from_dip, #from_phys, from_phys, #get_accelerator_table, #get_auto_layout, #get_background_colour, #get_background_style, #get_best_height, #get_best_size, #get_best_virtual_size, #get_best_width, #get_border, get_capture, #get_caret, #get_char_height, #get_char_width, #get_children, get_class_default_attributes, #get_client_area_origin, #get_client_rect, #get_client_size, #get_containing_sizer, #get_content_scale_factor, #get_cursor, #get_default_attributes, #get_dpi, #get_dpi_scale_factor, #get_drop_target, #get_effective_min_size, #get_event_handler, #get_extra_style, #get_font, #get_foreground_colour, #get_grand_parent, #get_help_text, #get_help_text_at_point, #get_id, #get_label, #get_layout_direction, #get_max_client_size, #get_max_height, #get_max_size, #get_max_width, #get_min_client_size, #get_min_height, #get_min_size, #get_min_width, #get_name, #get_next_sibling, #get_parent, #get_popup_menu_selection_from_user, #get_position, #get_prev_sibling, #get_rect, #get_screen_position, #get_screen_rect, #get_scroll_pos, #get_scroll_range, #get_scroll_thumb, #get_size, #get_sizer, #get_text_extent, #get_theme_enabled, #get_tool_tip, #get_tool_tip_text, #get_update_client_rect, #get_update_region, #get_validator, #get_virtual_size, #get_window_border_size, #get_window_style, #get_window_style_flag, #get_window_variant, #handle_as_navigation_key, #handle_window_event, #has_capture, #has_extra_style, #has_flag, #has_focus, #has_multiple_pages, #has_scrollbar, #has_transparent_background, #hide, #hide_with_effect, #inform_first_direction, #inherit_attributes, #inherits_background_colour, #inherits_foreground_colour, #init_dialog, #invalidate_best_size, #is_being_deleted, #is_descendant, #is_double_buffered, #is_enabled, #is_exposed, #is_focusable, #is_frozen, #is_retained, #is_scrollbar_always_shown, #is_shown, #is_shown_on_screen, #is_this_enabled, #is_top_level, #is_transparent_background_supported, #layout, #line_down, #line_up, #locked, #lower_window, #move, #move_after_in_tab_order, #move_before_in_tab_order, #navigate, #navigate_in, new_control_id, #on_internal_idle, #page_down, #page_up, #paint, #paint_buffered, #popup_menu, #post_size_event, #post_size_event_to_parent, #process_window_event, #process_window_event_locally, #push_event_handler, #raise_window, #refresh, #refresh_rect, #register_hot_key, #release_mouse, #remove_child, #remove_event_handler, #reparent, #screen_to_client, #scroll_lines, #scroll_pages, #scroll_window, #send_size_event, #send_size_event_to_parent, #set_accelerator_table, #set_auto_layout, #set_background_colour, #set_background_style, #set_can_focus, #set_caret, #set_client_size, #set_containing_sizer, #set_cursor, #set_double_buffered, #set_drop_target, #set_event_handler, #set_extra_style, #set_focus, #set_focus_from_kbd, #set_font, #set_foreground_colour, #set_help_text, #set_id, #set_initial_size, #set_label, #set_layout_direction, #set_max_client_size, #set_max_size, #set_min_client_size, #set_min_size, #set_name, #set_next_handler, #set_own_background_colour, #set_own_font, #set_own_foreground_colour, #set_position, #set_previous_handler, #set_scroll_pos, #set_scrollbar, #set_size, #set_size_hints, #set_sizer, #set_sizer_and_fit, #set_theme_enabled, #set_tool_tip, #set_transparent, #set_validator, #set_virtual_size, #set_window_style, #set_window_style_flag, #set_window_variant, #should_inherit_colours, #show, #show_with_effect, #switch_sizer, #thaw, #to_dip, to_dip, #to_phys, to_phys, #toggle_window_style, #transfer_data_from_window, #transfer_data_to_window, #unregister_hot_key, unreserve_control_id, #unset_tool_tip, #update, #update_window_ui, #use_background_colour, #use_bg_col, #use_foreground_colour, #validate, #warp_pointer, #window_to_client_size

Methods inherited from EvtHandler

add_filter, #add_pending_event, #call_after, clear_filters, #connect, #delete_pending_events, #disconnect, #evt_activate, #evt_activate_app, #evt_aui_pane_activated, #evt_aui_pane_button, #evt_aui_pane_close, #evt_aui_pane_maximize, #evt_aui_pane_restore, #evt_aui_render, #evt_auinotebook_allow_dnd, #evt_auinotebook_begin_drag, #evt_auinotebook_bg_dclick, #evt_auinotebook_button, #evt_auinotebook_drag_done, #evt_auinotebook_drag_motion, #evt_auinotebook_end_drag, #evt_auinotebook_page_changed, #evt_auinotebook_page_changing, #evt_auinotebook_page_close, #evt_auinotebook_page_closed, #evt_auinotebook_tab_middle_down, #evt_auinotebook_tab_middle_up, #evt_auinotebook_tab_right_down, #evt_auinotebook_tab_right_up, #evt_auitoolbar_begin_drag, #evt_auitoolbar_middle_click, #evt_auitoolbar_overflow_click, #evt_auitoolbar_right_click, #evt_auitoolbar_tool_dropdown, #evt_button, #evt_calculate_layout, #evt_calendar, #evt_calendar_page_changed, #evt_calendar_sel_changed, #evt_calendar_week_clicked, #evt_calendar_weekday_clicked, #evt_char, #evt_char_hook, #evt_checkbox, #evt_checklistbox, #evt_child_focus, #evt_choice, #evt_choicebook_page_changed, #evt_choicebook_page_changing, #evt_close, #evt_collapsiblepane_changed, #evt_colourpicker_changed, #evt_colourpicker_current_changed, #evt_colourpicker_dialog_cancelled, #evt_combobox, #evt_combobox_closeup, #evt_combobox_dropdown, #evt_command, #evt_command_enter, #evt_command_kill_focus, #evt_command_left_click, #evt_command_left_dclick, #evt_command_range, #evt_command_right_click, #evt_command_scroll, #evt_command_scroll_bottom, #evt_command_scroll_changed, #evt_command_scroll_linedown, #evt_command_scroll_lineup, #evt_command_scroll_pagedown, #evt_command_scroll_pageup, #evt_command_scroll_thumbrelease, #evt_command_scroll_thumbtrack, #evt_command_scroll_top, #evt_command_set_focus, #evt_context_menu, #evt_date_changed, #evt_dialup_connected, #evt_dialup_disconnected, #evt_dirctrl_fileactivated, #evt_dirctrl_selectionchanged, #evt_dirpicker_changed, #evt_display_changed, #evt_dpi_changed, #evt_drop_files, #evt_end_session, #evt_enter_window, #evt_erase_background, #evt_filectrl_fileactivated, #evt_filectrl_filterchanged, #evt_filectrl_folderchanged, #evt_filectrl_selectionchanged, #evt_filepicker_changed, #evt_find, #evt_find_close, #evt_find_next, #evt_find_replace, #evt_find_replace_all, #evt_fontpicker_changed, #evt_fullscreen, #evt_gesture_pan, #evt_gesture_rotate, #evt_gesture_zoom, #evt_grid_cell_changed, #evt_grid_cell_changing, #evt_grid_cell_left_click, #evt_grid_cell_left_dclick, #evt_grid_cell_right_click, #evt_grid_cell_right_dclick, #evt_grid_cmd_col_size, #evt_grid_cmd_editor_created, #evt_grid_cmd_range_selected, #evt_grid_cmd_range_selecting, #evt_grid_cmd_row_size, #evt_grid_col_auto_size, #evt_grid_col_move, #evt_grid_col_size, #evt_grid_col_sort, #evt_grid_editor_created, #evt_grid_editor_hidden, #evt_grid_editor_shown, #evt_grid_label_left_click, #evt_grid_label_left_dclick, #evt_grid_label_right_click, #evt_grid_label_right_dclick, #evt_grid_range_selected, #evt_grid_range_selecting, #evt_grid_row_auto_size, #evt_grid_row_move, #evt_grid_row_size, #evt_grid_select_cell, #evt_grid_tabbing, #evt_header_begin_reorder, #evt_header_begin_resize, #evt_header_click, #evt_header_dclick, #evt_header_dragging_cancelled, #evt_header_end_reorder, #evt_header_end_resize, #evt_header_middle_click, #evt_header_middle_dclick, #evt_header_resizing, #evt_header_right_click, #evt_header_right_dclick, #evt_header_separator_dclick, #evt_help, #evt_help_range, #evt_hibernate, #evt_hotkey, #evt_html_cell_clicked, #evt_html_cell_hover, #evt_html_link_clicked, #evt_hyperlink, #evt_iconize, #evt_idle, #evt_init_dialog, #evt_joy_button_down, #evt_joy_button_up, #evt_joy_move, #evt_joy_zmove, #evt_joystick_events, #evt_key_down, #evt_key_up, #evt_kill_focus, #evt_leave_window, #evt_left_dclick, #evt_left_down, #evt_left_up, #evt_list_begin_drag, #evt_list_begin_label_edit, #evt_list_begin_rdrag, #evt_list_cache_hint, #evt_list_col_begin_drag, #evt_list_col_click, #evt_list_col_dragging, #evt_list_col_end_drag, #evt_list_col_right_click, #evt_list_delete_all_items, #evt_list_delete_item, #evt_list_end_label_edit, #evt_list_insert_item, #evt_list_item_activated, #evt_list_item_checked, #evt_list_item_deselected, #evt_list_item_focused, #evt_list_item_middle_click, #evt_list_item_right_click, #evt_list_item_selected, #evt_list_item_unchecked, #evt_list_key_down, #evt_listbook_page_changed, #evt_listbook_page_changing, #evt_listbox, #evt_listbox_dclick, #evt_long_press, #evt_magnify, #evt_maximize, #evt_media_finished, #evt_media_loaded, #evt_media_pause, #evt_media_play, #evt_media_statechanged, #evt_media_stop, #evt_menu, #evt_menu_close, #evt_menu_highlight, #evt_menu_highlight_all, #evt_menu_open, #evt_menu_range, #evt_middle_dclick, #evt_middle_down, #evt_middle_up, #evt_motion, #evt_mouse_aux1_dclick, #evt_mouse_aux1_down, #evt_mouse_aux1_up, #evt_mouse_aux2_dclick, #evt_mouse_aux2_down, #evt_mouse_aux2_up, #evt_mouse_capture_changed, #evt_mouse_capture_lost, #evt_mouse_events, #evt_mousewheel, #evt_move, #evt_move_end, #evt_move_start, #evt_moving, #evt_navigation_key, #evt_notebook_page_changed, #evt_notebook_page_changing, #evt_paint, #evt_pg_changed, #evt_pg_changing, #evt_pg_col_begin_drag, #evt_pg_col_dragging, #evt_pg_col_end_drag, #evt_pg_double_click, #evt_pg_highlighted, #evt_pg_item_collapsed, #evt_pg_item_expanded, #evt_pg_label_edit_begin, #evt_pg_label_edit_ending, #evt_pg_page_changed, #evt_pg_right_click, #evt_pg_selected, #evt_press_and_tap, #evt_query_end_session, #evt_query_layout_info, #evt_radiobox, #evt_radiobutton, #evt_ribbonbar_help_click, #evt_ribbonbar_page_changed, #evt_ribbonbar_page_changing, #evt_ribbonbar_tab_left_dclick, #evt_ribbonbar_tab_middle_down, #evt_ribbonbar_tab_middle_up, #evt_ribbonbar_tab_right_down, #evt_ribbonbar_tab_right_up, #evt_ribbonbar_toggled, #evt_ribbonbuttonbar_clicked, #evt_ribbonbuttonbar_dropdown_clicked, #evt_ribbongallery_clicked, #evt_ribbongallery_hover_changed, #evt_ribbongallery_selected, #evt_ribbonpanel_extbutton_activated, #evt_ribbontoolbar_clicked, #evt_ribbontoolbar_dropdown_clicked, #evt_richtext_buffer_reset, #evt_richtext_character, #evt_richtext_consuming_character, #evt_richtext_content_deleted, #evt_richtext_content_inserted, #evt_richtext_delete, #evt_richtext_focus_object_changed, #evt_richtext_left_click, #evt_richtext_left_dclick, #evt_richtext_middle_click, #evt_richtext_properties_changed, #evt_richtext_return, #evt_richtext_right_click, #evt_richtext_selection_changed, #evt_richtext_style_changed, #evt_richtext_stylesheet_changed, #evt_richtext_stylesheet_replaced, #evt_richtext_stylesheet_replacing, #evt_right_dclick, #evt_right_down, #evt_right_up, #evt_sash_dragged, #evt_sash_dragged_range, #evt_scroll, #evt_scroll_bottom, #evt_scroll_changed, #evt_scroll_command, #evt_scroll_linedown, #evt_scroll_lineup, #evt_scroll_pagedown, #evt_scroll_pageup, #evt_scroll_thumbrelease, #evt_scroll_thumbtrack, #evt_scroll_top, #evt_scrollbar, #evt_scrollwin, #evt_scrollwin_bottom, #evt_scrollwin_linedown, #evt_scrollwin_lineup, #evt_scrollwin_pagedown, #evt_scrollwin_pageup, #evt_scrollwin_thumbrelease, #evt_scrollwin_thumbtrack, #evt_scrollwin_top, #evt_search, #evt_search_cancel, #evt_set_cursor, #evt_set_focus, #evt_show, #evt_size, #evt_slider, #evt_spin, #evt_spin_down, #evt_spin_up, #evt_spinctrl, #evt_spinctrldouble, #evt_splitter_dclick, #evt_splitter_sash_pos_changed, #evt_splitter_sash_pos_changing, #evt_splitter_sash_pos_resize, #evt_splitter_unsplit, #evt_stc_autocomp_cancelled, #evt_stc_autocomp_char_deleted, #evt_stc_autocomp_completed, #evt_stc_autocomp_selection, #evt_stc_autocomp_selection_change, #evt_stc_calltip_click, #evt_stc_change, #evt_stc_charadded, #evt_stc_clipboard_copy, #evt_stc_clipboard_paste, #evt_stc_do_drop, #evt_stc_doubleclick, #evt_stc_drag_over, #evt_stc_dwellend, #evt_stc_dwellstart, #evt_stc_hotspot_click, #evt_stc_hotspot_dclick, #evt_stc_hotspot_release_click, #evt_stc_indicator_click, #evt_stc_indicator_release, #evt_stc_macrorecord, #evt_stc_margin_right_click, #evt_stc_marginclick, #evt_stc_modified, #evt_stc_needshown, #evt_stc_painted, #evt_stc_romodifyattempt, #evt_stc_savepointleft, #evt_stc_savepointreached, #evt_stc_start_drag, #evt_stc_styleneeded, #evt_stc_updateui, #evt_stc_userlistselection, #evt_stc_zoom, #evt_sys_colour_changed, #evt_taskbar_click, #evt_taskbar_left_dclick, #evt_taskbar_left_down, #evt_taskbar_left_up, #evt_taskbar_move, #evt_taskbar_right_dclick, #evt_taskbar_right_down, #evt_taskbar_right_up, #evt_text, #evt_text_copy, #evt_text_cut, #evt_text_enter, #evt_text_maxlen, #evt_text_paste, #evt_text_url, #evt_time_changed, #evt_timer, #evt_togglebutton, #evt_tool, #evt_tool_dropdown, #evt_tool_enter, #evt_tool_range, #evt_tool_rclicked, #evt_tool_rclicked_range, #evt_toolbook_page_changed, #evt_toolbook_page_changing, #evt_tree_begin_drag, #evt_tree_begin_label_edit, #evt_tree_begin_rdrag, #evt_tree_delete_item, #evt_tree_end_drag, #evt_tree_end_label_edit, #evt_tree_get_info, #evt_tree_item_activated, #evt_tree_item_collapsed, #evt_tree_item_collapsing, #evt_tree_item_expanded, #evt_tree_item_expanding, #evt_tree_item_gettooltip, #evt_tree_item_menu, #evt_tree_item_middle_click, #evt_tree_item_right_click, #evt_tree_key_down, #evt_tree_sel_changed, #evt_tree_sel_changing, #evt_tree_set_info, #evt_tree_state_image_click, #evt_treebook_node_collapsed, #evt_treebook_node_expanded, #evt_treebook_page_changed, #evt_treebook_page_changing, #evt_two_finger_tap, #evt_update_ui, #evt_update_ui_range, #evt_window_create, #evt_window_destroy, #evt_wizard_before_page_changed, #evt_wizard_cancel, #evt_wizard_finished, #evt_wizard_help, #evt_wizard_page_changed, #evt_wizard_page_changing, #evt_wizard_page_shown, #get_client_object, #get_evt_handler_enabled, #get_next_handler, #get_previous_handler, #is_unlinked, #process_event, #process_event_locally, #process_pending_events, #queue_event, register_class, remove_filter, #safely_process_event, #set_client_object, #set_evt_handler_enabled, #set_next_handler, #set_previous_handler, #try_after, #try_before, #unlink

Methods inherited from Object

#clone, #dup, #is_same_as, #un_share

Constructor Details

#initializeWx::ListBox #initialize(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, choices = nil, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Wx::ListBox #initialize(parent, id, pos, size, choices, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Wx::ListBox

Returns a new instance of ListBox.

Overloads:

  • #initializeWx::ListBox

    Default constructor.

  • #initialize(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, choices = nil, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Wx::ListBox

    Constructor, creating and showing a list box.

    Parameters:

    • parent (Wx::Window)

      The parent window.

    • id (Integer)

      The ID of this control. A value of StandardID::ID_ANY indicates a default value.

    • pos (Array(Integer, Integer), Wx::Point) (defaults to: Wx::DEFAULT_POSITION)

      The initial position. If DEFAULT_POSITION is specified then a default position is chosen.

    • size (Array(Integer, Integer), Wx::Size) (defaults to: Wx::DEFAULT_SIZE)

      The initial size. If DEFAULT_SIZE is specified then the window is sized appropriately.

    • choices (Array<String>) (defaults to: nil)

      The strings to use to initialize the control.

    • style (Integer) (defaults to: 0)

      Window style. See Wx::ListBox.

    • validator (Wx::Validator) (defaults to: Wx::DEFAULT_VALIDATOR)

      The validator for this control.

    • name (String) (defaults to: Wx::LIST_BOX_NAME_STR)

      The name of this class.

  • #initialize(parent, id, pos, size, choices, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Wx::ListBox

    Constructor, creating and showing a list box.

    See the other list_box constructor; the only difference is that this overload takes a ArrayString instead of a pointer to an array of String.

    Parameters:

    • parent (Wx::Window)
    • id (Integer)
    • pos (Array(Integer, Integer), Wx::Point)
    • size (Array(Integer, Integer), Wx::Size)
    • choices (Array<String>)
    • style (Integer) (defaults to: 0)
    • validator (Wx::Validator) (defaults to: Wx::DEFAULT_VALIDATOR)
    • name (String) (defaults to: Wx::LIST_BOX_NAME_STR)


113
# File 'lib/wx/doc/gen/list_box.rb', line 113

def initialize(*args) end

Instance Method Details

#create(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, choices = nil, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Boolean #create(parent, id, pos, size, choices, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Boolean

Overloads:

  • #create(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, choices = nil, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Boolean

    Creates the listbox for two-step construction.

    See list_box for further details.

    Parameters:

    • parent (Wx::Window)
    • id (Integer)
    • pos (Array(Integer, Integer), Wx::Point) (defaults to: Wx::DEFAULT_POSITION)
    • size (Array(Integer, Integer), Wx::Size) (defaults to: Wx::DEFAULT_SIZE)
    • choices (Array<String>) (defaults to: nil)
    • style (Integer) (defaults to: 0)
    • validator (Wx::Validator) (defaults to: Wx::DEFAULT_VALIDATOR)
    • name (String) (defaults to: Wx::LIST_BOX_NAME_STR)

    Returns:

    • (Boolean)
  • #create(parent, id, pos, size, choices, style = 0, validator = Wx::DEFAULT_VALIDATOR, name = Wx::LIST_BOX_NAME_STR) ⇒ Boolean

    Creates the listbox for two-step construction.

    See list_box for further details.

    Parameters:

    • parent (Wx::Window)
    • id (Integer)
    • pos (Array(Integer, Integer), Wx::Point)
    • size (Array(Integer, Integer), Wx::Size)
    • choices (Array<String>)
    • style (Integer) (defaults to: 0)
    • validator (Wx::Validator) (defaults to: Wx::DEFAULT_VALIDATOR)
    • name (String) (defaults to: Wx::LIST_BOX_NAME_STR)

    Returns:

    • (Boolean)


84
# File 'lib/wx/doc/gen/list_box.rb', line 84

def create(*args) end

#deselect(n) ⇒ void

This method returns an undefined value.

Deselects an item in the list box.

Remark:

This applies to multiple selection listboxes only.

Parameters:

  • n (Integer)

    The zero-based item to deselect.



124
# File 'lib/wx/doc/gen/list_box.rb', line 124

def deselect(n) end

#ensure_visible(n) ⇒ void

This method returns an undefined value.

Ensure that the item with the given index is currently shown.

This method scrolls the listbox only if necessary and doesn’t do anything if this item is already shown, unlike #set_first_item.

Parameters:

  • n (Integer)


222
# File 'lib/wx/doc/gen/list_box.rb', line 222

def ensure_visible(n) end

#find_string(string, caseSensitive = false) ⇒ Integer

Finds an item whose label matches the given string.

The zero-based position of the item, or NOT_FOUND if the string was not found.

Parameters:

  • string (String)

    String to find.

  • caseSensitive (Boolean) (defaults to: false)

    Whether search is case sensitive (default is not).

Returns:

  • (Integer)


280
# File 'lib/wx/doc/gen/list_box.rb', line 280

def find_string(string, caseSensitive=false) end

#get_countInteger Also known as: count

Returns the number of items in the control.

Returns:

  • (Integer)

See Also:



255
# File 'lib/wx/doc/gen/list_box.rb', line 255

def get_count; end

#get_count_per_pageInteger Also known as: count_per_page

Return the number of items that can fit vertically in the visible area of the listbox.

Returns -1 if the number of items per page couldn’t be determined. On WXGTK this method can only determine the number of items per page if there is at least one item in the listbox.

Returns:

  • (Integer)


228
# File 'lib/wx/doc/gen/list_box.rb', line 228

def get_count_per_page; end

#get_selectionInteger Also known as: selection

Returns the index of the selected item or NOT_FOUND if no item is selected.

The position of the current selection.

Remark:

This method can be used with single selection list boxes only, you must use #get_selections for the list boxes with Wx::LB_MULTIPLE style.



148
# File 'lib/wx/doc/gen/list_box.rb', line 148

def get_selection; end

#get_selectionsArray<Integer> Also known as: selections

Fill an array of ints with the positions of the currently selected items.

The number of selections.

Remark:

Use this with a multiple selection listbox.

Returns:

  • (Array<Integer>)

See Also:

  • ControlWithItems::GetSelection
  • ControlWithItems::GetStringSelection
  • ControlWithItems::SetSelection


174
# File 'lib/wx/doc/gen/list_box.rb', line 174

def get_selections; end

#get_string(n) ⇒ String Also known as: string

Returns the label of the item with the given index.

The index must be valid, i.e. less than the value returned by #get_count, otherwise an assert is triggered. Notably, this function can’t be called if the control is empty.

The label of the item.

Parameters:

  • n (Integer)

    The zero-based index.

Returns:

  • (String)


265
# File 'lib/wx/doc/gen/list_box.rb', line 265

def get_string(n) end

#get_top_itemInteger Also known as: top_item

Return the index of the topmost visible item.

Returns NOT_FOUND if the method is not implemented for the current platform.

Returns:

  • (Integer)


235
# File 'lib/wx/doc/gen/list_box.rb', line 235

def get_top_item; end

#hit_test(point) ⇒ Integer #hit_test(x, y) ⇒ Integer

Overloads:

  • #hit_test(point) ⇒ Integer

    Returns the item located at point, or NOT_FOUND if there is no item located at point.

    It is currently implemented for WXMSW, WXOSX and WXGTK2 ports.

    Item located at point, or NOT_FOUND if unimplemented or the item does not exist.

    Parameters:

    • point (Array(Integer, Integer), Wx::Point)

      Point of item (in client coordinates) to obtain

    Returns:

    • (Integer)
  • #hit_test(x, y) ⇒ Integer

    This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

    Parameters:

    • x (Integer)
    • y (Integer)

    Returns:

    • (Integer)


190
# File 'lib/wx/doc/gen/list_box.rb', line 190

def hit_test(*args) end

#insert_items(items, pos) ⇒ void

This method returns an undefined value.

Insert the given number of strings before the specified position.

Parameters:

  • items (Array<String>)

    Labels of items to be inserted

  • pos (Integer)

    Position before which to insert the items: if pos is 0 the items will be inserted in the beginning of the listbox



196
# File 'lib/wx/doc/gen/list_box.rb', line 196

def insert_items(items, pos) end

#is_selected(n) ⇒ Boolean Also known as: selected?

Determines whether an item is selected.

true if the given item is selected, false otherwise.

Parameters:

  • n (Integer)

    The zero-based item index.

Returns:

  • (Boolean)


203
# File 'lib/wx/doc/gen/list_box.rb', line 203

def is_selected(n) end

#msw_set_tab_stops(tabStops) ⇒ Boolean

MSW-specific function for setting custom tab stop distances.

Tab stops are expressed in dialog unit widths, i.e. “quarters of the average character width for the font that is selected into the list box”.

true if all specified tabs are set, false otherwise

Availability: only available for the WXMSW port.

Parameters:

  • tabStops (Array<Integer>)

    If this argument is empty, tab stops are reset to their default value (every 32 dialog units). If it contains a single element, tab stops are set at each multiple of the given value. Otherwise tab stops are set at every element of the array, which must be in ascending order.

Returns:

  • (Boolean)

Requires:

  • WXMSW


248
# File 'lib/wx/doc/gen/list_box.rb', line 248

def msw_set_tab_stops(tabStops) end

#set_first_item(n) ⇒ void #set_first_item(string) ⇒ void Also known as: first_item=

Overloads:

  • #set_first_item(n) ⇒ void

    This method returns an undefined value.

    Set the specified item to be the first visible item.

    Parameters:

    • n (Integer)

      The zero-based item index that should be visible.

  • #set_first_item(string) ⇒ void

    This method returns an undefined value.

    Set the specified item to be the first visible item.

    Parameters:

    • string (String)

      The string that should be visible.



214
# File 'lib/wx/doc/gen/list_box.rb', line 214

def set_first_item(*args) end

#set_selection(n) ⇒ void Also known as: selection=

This method returns an undefined value.

Sets the selection to the given item n or removes the selection entirely if n == 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.

Parameters:

  • n (Integer)

    The string position to select, starting from zero.

See Also:



133
# File 'lib/wx/doc/gen/list_box.rb', line 133

def set_selection(n) end

#set_string(n, string) ⇒ void

This method returns an undefined value.

Sets the label for the given item.

Parameters:

  • n (Integer)

    The zero-based item index.

  • string (String)

    The label to set.



272
# File 'lib/wx/doc/gen/list_box.rb', line 272

def set_string(n, string) end

#set_string_selection(s, select) ⇒ Boolean #set_string_selection(s) ⇒ Boolean Also known as: string_selection=

Overloads:

  • #set_string_selection(s, select) ⇒ Boolean

    Parameters:

    • s (String)
    • select (Boolean)

    Returns:

    • (Boolean)
  • #set_string_selection(s) ⇒ Boolean

    Parameters:

    • s (String)

    Returns:

    • (Boolean)


158
# File 'lib/wx/doc/gen/list_box.rb', line 158

def set_string_selection(*args) end