Class: Wx::Notebook
- Inherits:
-
BookCtrlBase
- Object
- Object
- EvtHandler
- Window
- Control
- BookCtrlBase
- Wx::Notebook
- Defined in:
- lib/wx/doc/gen/notebook.rb,
lib/wx/doc/notebook.rb
Overview
This class represents a notebook control, which manages multiple windows with associated tabs.
To use the class, create a Notebook object and call AddPage or #insert_page, passing a window to be used as the page. Do not explicitly delete the window for a page that is currently managed by Notebook. NotebookPage is a typedef for Window.
Styles
This class supports the following styles:
-
NB_TOP: Place tabs on the top side.
-
NB_LEFT: Place tabs on the left side.
-
NB_RIGHT: Place tabs on the right side.
-
NB_BOTTOM: Place tabs under instead of above the notebook pages.
-
NB_FIXEDWIDTH: (Windows only) All tabs will have same width.
-
NB_MULTILINE: (Windows only) There can be several rows of tabs.
-
NB_NOPAGETHEME: (Windows only) Display a solid colour on notebook pages, and not a gradient, which can reduce performance.
The styles NB_LEFT, RIGHT and BOTTOM are not supported under Microsoft Windows when using visual themes.
Events emitted by this class
The following event-handler methods redirect the events to member method or handler blocks for BookCtrlEvent events. Event handler methods for events emitted by this class:
-
EvtHandler#evt_notebook_page_changed(id, meth = nil, &block): The page selection was changed. Processes a EVT_NOTEBOOK_PAGE_CHANGED event.
-
EvtHandler#evt_notebook_page_changing(id, meth = nil, &block): The page selection is about to be changed. Processes a EVT_NOTEBOOK_PAGE_CHANGING event. This event can be vetoed.
Page backgrounds
On Windows, the default theme paints a background on the notebook’s pages. If you wish to suppress this theme, for aesthetic or performance reasons, there are three ways of doing it. You can use NB_NOPAGETHEME to disable themed drawing for a particular notebook, you can call SystemOptions.set_option to disable it for the whole application, or you can disable it for individual pages by using Window#set_background_colour. To disable themed pages globally:
Wx::SystemOptions.set_option("msw.notebook.themed-background", 0)
Set the value to 1 to enable it again. To give a single page a solid background that more or less fits in with the overall theme, use:
col = notebook.get_theme_background_colour
page.set_background_colour(col) if col.ok?
On platforms other than Windows, or if the application is not using Windows themes, #get_theme_background_colour will return an uninitialised colour object, and the above code will therefore work on all platforms.
Category: Book 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>
Constant Summary
Constants inherited from BookCtrlBase
Instance Method Summary collapse
-
#change_selection(page) ⇒ Integer
Changes the selection to the given page, returning the previous selection.
-
#create(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = 0, name = Wx::NOTEBOOK_NAME_STR) ⇒ Boolean
Creates a notebook control.
-
#each_page ⇒ Object
Iterate each notebook page.
-
#get_page_image(nPage) ⇒ Integer
(also: #page_image)
Returns the image index for the given page.
-
#get_page_text(nPage) ⇒ String
(also: #page_text)
Returns the string for the given page.
-
#get_row_count ⇒ Integer
(also: #row_count)
Returns the number of rows in the notebook control.
-
#get_selection ⇒ Integer
(also: #selection)
Returns the currently selected page, or NOT_FOUND if none was selected.
-
#get_tab_orientation ⇒ Wx::Direction
(also: #tab_orientation)
This is a convenience function mapping BK_TOP etc styles to one of the DataObject::Direction enum elements.
-
#get_tab_rect(page) ⇒ Wx::Rect
(also: #tab_rect)
Return the rectangle of the given page tab in window coordinates.
-
#get_theme_background_colour ⇒ Wx::Colour
(also: #theme_background_colour)
If running under Windows and themes are enabled for the application, this function returns a suitable colour for painting the background of a notebook page, and can be passed to Window#set_background_colour.
-
#initialize(*args) ⇒ Notebook
constructor
A new instance of Notebook.
-
#insert_page(index, page, text, select = false, imageId = Wx::Notebook::NO_IMAGE) ⇒ Boolean
Inserts a new page at the specified position.
-
#set_padding(padding) ⇒ void
(also: #padding=)
Sets the amount of space around each page’s icon and label, in pixels.
-
#set_page_image(page, image) ⇒ Boolean
Sets the image index for the given page.
-
#set_page_text(page, text) ⇒ Boolean
Sets the text for the given page.
-
#set_selection(page) ⇒ Integer
(also: #selection=)
Sets the selection to the given page, returning the previous selection.
Methods inherited from BookCtrlBase
#add_page, #advance_selection, #create_persistent_object, #delete_all_pages, #delete_page, #find_page, #get_control_sizer, #get_current_page, #get_page, #get_page_count, #hit_test, #remove_page, #set_page_size
Methods included from WithImages
#get_image_count, #get_image_list, #get_updated_image_list_for, #has_images, #set_image_list, #set_images
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_prepare_update_window_ui, #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_cursor_bundle, #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, #hit_test, #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, #msw_disable_composited, #navigate, #navigate_in, new_control_id, #on_internal_idle, #page_down, #page_up, #paint, #paint_buffered, #pop_event_handler, #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_cursor_bundle, #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_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_label_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_label_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_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_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, #try_after, #try_before, #unlink
Methods inherited from Object
#clone, #dup, #is_same_as, #un_share
Constructor Details
#initialize ⇒ Wx::Notebook #initialize(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = 0, name = Wx::NOTEBOOK_NAME_STR) ⇒ Wx::Notebook #initialize(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = 0, name = Wx::NOTEBOOK_NAME_STR) {|win| ... } ⇒ Wx::Notebook
Returns a new instance of Notebook.
148 |
# File 'lib/wx/doc/gen/notebook.rb', line 148 def initialize(*args) end |
Instance Method Details
#change_selection(page) ⇒ Integer
Changes the selection to the given page, returning the previous selection.
This function behaves as #set_selection but does not generate the page changing events. See User Generated Events vs Programmatically Generated Events for more information.
256 |
# File 'lib/wx/doc/gen/notebook.rb', line 256 def change_selection(page) end |
#create(parent, id, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = 0, name = Wx::NOTEBOOK_NAME_STR) ⇒ Boolean
Creates a notebook control.
See notebook for a description of the parameters.
160 |
# File 'lib/wx/doc/gen/notebook.rb', line 160 def create(parent, id, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=Wx::NOTEBOOK_NAME_STR) end |
#each_page {|page| ... } ⇒ Object #each_page ⇒ Enumerator
Iterate each notebook page. Passes each page to the given block. Returns an Enumerator if no block given.
20 |
# File 'lib/wx/doc/notebook.rb', line 20 def each_page(*) end |
#get_page_image(nPage) ⇒ Integer Also known as: page_image
Returns the image index for the given page.
209 |
# File 'lib/wx/doc/gen/notebook.rb', line 209 def get_page_image(nPage) end |
#get_page_text(nPage) ⇒ String Also known as: page_text
Returns the string for the given page.
223 |
# File 'lib/wx/doc/gen/notebook.rb', line 223 def get_page_text(nPage) end |
#get_row_count ⇒ Integer Also known as: row_count
Returns the number of rows in the notebook control.
164 |
# File 'lib/wx/doc/gen/notebook.rb', line 164 def get_row_count; end |
#get_selection ⇒ Integer Also known as: selection
Returns the currently selected page, or Wx::NOT_FOUND if none was selected.
Note that this method may return either the previously or newly selected page when called from the EVT_BOOKCTRL_PAGE_CHANGED handler depending on the platform and so BookCtrlEvent#get_selection should be used instead in this case.
238 |
# File 'lib/wx/doc/gen/notebook.rb', line 238 def get_selection; end |
#get_tab_orientation ⇒ Wx::Direction Also known as: tab_orientation
This is a convenience function mapping BK_TOP etc styles to one of the DataObject::Direction enum elements.
188 |
# File 'lib/wx/doc/gen/notebook.rb', line 188 def get_tab_orientation; end |
#get_tab_rect(page) ⇒ Wx::Rect Also known as: tab_rect
Return the rectangle of the given page tab in window coordinates.
This function always returns the rectangle for the specified tab, even if the tab is currently not visible. If page is invalid, an assert failure is triggered and an empty rectangle is returned.
Currently only available in Univ and MSW and always asserts in the other ports.
203 |
# File 'lib/wx/doc/gen/notebook.rb', line 203 def get_tab_rect(page) end |
#get_theme_background_colour ⇒ Wx::Colour Also known as: theme_background_colour
If running under Windows and themes are enabled for the application, this function returns a suitable colour for painting the background of a notebook page, and can be passed to Window#set_background_colour.
Otherwise, an uninitialised colour will be returned.
171 |
# File 'lib/wx/doc/gen/notebook.rb', line 171 def get_theme_background_colour; end |
#insert_page(index, page, text, select = false, imageId = Wx::Notebook::NO_IMAGE) ⇒ Boolean
Inserts a new page at the specified position.
true if successful, false otherwise.
Do not delete the page, it will be deleted by the book control.
274 |
# File 'lib/wx/doc/gen/notebook.rb', line 274 def insert_page(index, page, text, select=false, imageId=Wx::Notebook::NO_IMAGE) end |
#set_padding(padding) ⇒ void Also known as: padding=
This method returns an undefined value.
Sets the amount of space around each page’s icon and label, in pixels.
The vertical padding cannot be changed in WXGTK.
183 |
# File 'lib/wx/doc/gen/notebook.rb', line 183 def set_padding(padding) end |
#set_page_image(page, image) ⇒ Boolean
Sets the image index for the given page.
image is an index into the image list which was set with WithImages#set_image_list.
218 |
# File 'lib/wx/doc/gen/notebook.rb', line 218 def set_page_image(page, image) end |
#set_page_text(page, text) ⇒ Boolean
Sets the text for the given page.
The text may contain mnemonics, i.e. accelerator characters preceded by the ampersand (&
) character. If you need to include a literal ampersand in the text, you need to double it, i.e. use &&
.
232 |
# File 'lib/wx/doc/gen/notebook.rb', line 232 def set_page_text(page, text) end |
#set_selection(page) ⇒ Integer Also known as: selection=
Sets the selection to the given page, returning the previous selection.
Notice that the call to this function generates the page changing events, use the #change_selection function if you don’t want these events to be generated.
247 |
# File 'lib/wx/doc/gen/notebook.rb', line 247 def set_selection(page) end |