Ardour  9.0-pre0-582-g084a23a80d
Gtk::Notebook Class Reference

#include <notebook.h>

Inheritance diagram for Gtk::Notebook:
[legend]

Public Types

typedef Notebook_Helpers::PageList PageList
 
typedef sigc::slot< Notebook *, Widget *, int, int > SlotWindowCreation
 
- Public Types inherited from Gtk::Container
typedef sigc::slot< void, Widget & > ForeachSlot
 

Public Member Functions

virtual ~Notebook ()
 
GtkNotebookgobj ()
 Provides access to the underlying C GtkObject. More...
 
const GtkNotebookgobj () const
 Provides access to the underlying C GtkObject. More...
 
 Notebook ()
 
int prepend_page (Widget &child, Widget &tab_label)
 
int prepend_page (Widget &child)
 
int prepend_page (Widget &child, const Glib::ustring &tab_label, bool use_mnemonic=false)
 
int prepend_page (Widget &child, Widget &tab_label, Widget &menu_label)
 
int prepend_page (Widget &child, const Glib::ustring &tab_label, const Glib::ustring &menu_label, bool use_mnemonic)
 
int append_page (Widget &child, Widget &tab_label)
 
int append_page (Widget &child)
 
int append_page (Widget &child, const Glib::ustring &tab_label, bool use_mnemonic=false)
 
int append_page (Widget &child, Widget &tab_label, Widget &menu_label)
 
int append_page (Widget &child, const Glib::ustring &tab_label, const Glib::ustring &menu_label, bool use_mnemonic=false)
 
int insert_page (Widget &child, Widget &tab_label, int position)
 
int insert_page (Widget &child, int position)
 
int insert_page (Widget &child, const Glib::ustring &tab_label, int position, bool use_mnemonic=false)
 
int insert_page (Widget &child, Widget &tab_label, Widget &menu_label, int position)
 
int insert_page (Widget &child, const Glib::ustring &tab_label, const Glib::ustring &menu_label, int position, bool use_mnemonic=false)
 
void remove_page (int page_num=0)
 
void remove_page (Widget &child)
 
void set_group_id (int group_id)
 
int get_group_id () const
 
void set_group (void *group)
 
void * get_group ()
 
const void * get_group () const
 
void set_group_name (const Glib::ustring &group_name)
 
Glib::ustring get_group_name () const
 
int get_current_page () const
 
Widgetget_nth_page (int page_num)
 
const Widgetget_nth_page (int page_num) const
 
int get_n_pages ()
 
int get_n_pages () const
 
int page_num (const Widget &child)
 
int page_num (const Widget &child) const
 
void set_current_page (int page_num)
 
void next_page ()
 
void prev_page ()
 
void set_show_border (bool show_border=true)
 
bool get_show_border () const
 
void set_show_tabs (bool show_tabs=true)
 
bool get_show_tabs () const
 
void set_tab_pos (PositionType pos)
 
PositionType get_tab_pos () const
 
void set_scrollable (bool scrollable=true)
 
bool get_scrollable () const
 
guint16 get_tab_hborder () const
 
guint16 get_tab_vborder () const
 
void popup_enable ()
 
void popup_disable ()
 
Widgetget_tab_label (Widget &child)
 
const Widgetget_tab_label (Widget &child) const
 
void set_tab_label (Widget &child, Widget &tab_label)
 
void set_tab_label_text (Widget &child, const Glib::ustring &tab_text)
 
Glib::ustring get_tab_label_text (Widget &child) const
 
Widgetget_menu_label (Widget &child)
 
const Widgetget_menu_label (Widget &child) const
 
void set_menu_label (Widget &child, Widget &menu_label)
 
void set_menu_label_text (Widget &child, const Glib::ustring &menu_text)
 
Glib::ustring get_menu_label_text (Widget &child) const
 
void query_tab_label_packing (Widget &child, bool &expand, bool &fill, PackType &pack_type)
 
void set_tab_label_packing (Widget &child, bool expand, bool fill, PackType pack_type)
 
void reorder_child (Widget &child, int position)
 
bool get_tab_reorderable (Widget &child) const
 
void set_tab_reorderable (Widget &child, bool reorderable=true)
 
bool get_tab_detachable (Widget &child) const
 
void set_tab_detachable (Widget &child, bool detachable=true)
 
Widgetget_action_widget (PackType pack_type=PACK_START)
 
void set_action_widget (Widget *widget, PackType pack_type=PACK_START)
 
PageList::iterator get_current ()
 
PageListpages ()
 
const PageListpages () const
 
Glib::SignalProxy2< void, GtkNotebookPage *, guint > signal_switch_page ()
 
Glib::SignalProxy2< void, Widget *, guint > signal_page_reordered ()
 
Glib::SignalProxy2< void, Widget *, guint > signal_page_removed ()
 
Glib::SignalProxy2< void, Widget *, guint > signal_page_added ()
 
Glib::PropertyProxy< PositionTypeproperty_tab_pos ()
 
Glib::PropertyProxy_ReadOnly< PositionTypeproperty_tab_pos () const
 
Glib::PropertyProxy< bool > property_show_tabs ()
 
Glib::PropertyProxy_ReadOnly< bool > property_show_tabs () const
 
Glib::PropertyProxy< bool > property_show_border ()
 
Glib::PropertyProxy_ReadOnly< bool > property_show_border () const
 
Glib::PropertyProxy< bool > property_scrollable ()
 
Glib::PropertyProxy_ReadOnly< bool > property_scrollable () const
 
Glib::PropertyProxy_WriteOnly< guint > property_tab_border ()
 
Glib::PropertyProxy< guint > property_tab_hborder ()
 
Glib::PropertyProxy_ReadOnly< guint > property_tab_hborder () const
 
Glib::PropertyProxy< guint > property_tab_vborder ()
 
Glib::PropertyProxy_ReadOnly< guint > property_tab_vborder () const
 
Glib::PropertyProxy< int > property_page ()
 
Glib::PropertyProxy_ReadOnly< int > property_page () const
 
Glib::PropertyProxy< bool > property_enable_popup ()
 
Glib::PropertyProxy_ReadOnly< bool > property_enable_popup () const
 
Glib::PropertyProxy< bool > property_homogeneous ()
 
Glib::PropertyProxy_ReadOnly< bool > property_homogeneous () const
 
Glib::PropertyProxy< int > property_group_id ()
 
Glib::PropertyProxy_ReadOnly< int > property_group_id () const
 
Glib::PropertyProxy< void * > property_group ()
 
Glib::PropertyProxy_ReadOnly< void * > property_group () const
 
- Public Member Functions inherited from Gtk::Container
virtual ~Container ()
 
GtkContainergobj ()
 Provides access to the underlying C GtkObject. More...
 
const GtkContainergobj () const
 Provides access to the underlying C GtkObject. More...
 
void set_border_width (guint border_width)
 
guint get_border_width () const
 
virtual void add (Widget &widget)
 
void remove (Widget &widget)
 
void set_resize_mode (ResizeMode resize_mode)
 
ResizeMode get_resize_mode () const
 
void check_resize ()
 
void foreach (const ForeachSlot &slot)
 
Glib::ListHandle< Widget * > get_children ()
 (internal) Operate on contained items (see foreach()) More...
 
Glib::ListHandle< const Widget * > get_children () const
 
void propagate_expose (Widget &child, GdkEventExpose *event)
 
void set_focus_chain (const Glib::ListHandle< Widget * > &focusable_widgets)
 
bool has_focus_chain () const
 
Glib::ListHandle< Widget * > get_focus_chain ()
 
Glib::ListHandle< const Widget * > get_focus_chain () const
 
void unset_focus_chain ()
 
void set_reallocate_redraws (bool needs_redraws=true)
 
void set_focus_child (Widget &widget)
 
void set_focus_vadjustment (Adjustment &adjustment)
 
Adjustmentget_focus_vadjustment ()
 
const Adjustmentget_focus_vadjustment () const
 
void set_focus_hadjustment (Adjustment &adjustment)
 
Adjustmentget_focus_hadjustment ()
 
const Adjustmentget_focus_hadjustment () const
 
void resize_children ()
 
GType child_type () const
 
Glib::SignalProxy1< void, Widget * > signal_add ()
 
Glib::SignalProxy1< void, Widget * > signal_remove ()
 
Glib::SignalProxy0< void > signal_check_resize ()
 
Glib::SignalProxy1< void, Widget * > signal_set_focus_child ()
 
void show_all_children (bool recursive=true)
 
- Public Member Functions inherited from Gtk::Widget
virtual ~Widget ()
 
GtkWidgetgobj ()
 Provides access to the underlying C GtkObject. More...
 
const GtkWidgetgobj () const
 Provides access to the underlying C GtkObject. More...
 
bool set_scroll_adjustments (Adjustment &hadjustment, Adjustment &vadjustment)
 
void show ()
 
void show_now ()
 
void hide ()
 
void show_all ()
 
void hide_all ()
 
void queue_draw ()
 
void queue_draw_area (int x, int y, int width, int height)
 
void queue_resize ()
 
Requisition size_request () const
 
void size_request (const Requisition &requisition)
 
void size_allocate (const Allocation &allocation)
 
void add_accelerator (const Glib::ustring &accel_signal, const Glib::RefPtr< AccelGroup > &accel_group, guint accel_key, Gdk::ModifierType accel_mods, AccelFlags accel_flags)
 
bool remove_accelerator (const Glib::RefPtr< AccelGroup > &accel_group, guint accel_key, Gdk::ModifierType accel_mods)
 
void set_accel_path (const Glib::ustring &accel_path, const Glib::RefPtr< AccelGroup > &accel_group)
 
bool mnemonic_activate (bool group_cycling)
 
bool event (GdkEvent *event)
 
int send_expose (GdkEvent *event)
 
bool send_focus_change (GdkEvent *event)
 
bool activate ()
 
void reparent (Widget &new_parent)
 
bool intersect (const Gdk::Rectangle &area) const
 
bool intersect (const Gdk::Rectangle &area, Gdk::Rectangle &intersection) const
 
Gdk::Region region_intersect (const Gdk::Region &region) const
 
void freeze_child_notify ()
 
void child_notify (const Glib::ustring &child_property)
 
void thaw_child_notify ()
 
void set_can_focus (bool can_focus=true)
 
bool get_can_focus () const
 
bool can_focus () const
 
bool has_focus () const
 
bool is_focus () const
 
void grab_focus ()
 
void set_can_default (bool can_default=true)
 
bool get_can_default () const
 
bool can_default () const
 
bool has_default () const
 
void grab_default ()
 
void set_receives_default (bool receives_default=true)
 
bool get_receives_default () const
 
bool has_grab () const
 
void add_modal_grab ()
 
void remove_modal_grab ()
 
void set_name (const Glib::ustring &name)
 
void unset_name ()
 
Glib::ustring get_name () const
 
void set_state (StateType state)
 
StateType get_state () const
 
void set_sensitive (bool sensitive=true)
 
bool get_sensitive () const
 
bool is_sensitive () const
 
void set_visible (bool visible=true)
 
bool get_visible () const
 
void set_has_window (bool has_window=true)
 
bool get_has_window () const
 
bool get_is_toplevel () const
 
bool get_is_drawable () const
 
bool get_realized () const
 
bool get_mapped () const
 
void set_app_paintable (bool app_paintable=true)
 
bool get_app_paintable () const
 
void set_double_buffered (bool double_buffered=true)
 
bool get_double_buffered () const
 
void set_redraw_on_allocate (bool redraw_on_allocate=true)
 
void set_child_visible (bool is_visible=true)
 
bool get_child_visible () const
 
void set_window (const Glib::RefPtr< Gdk::Window > &window)
 
Glib::RefPtr< Gdk::Windowget_window ()
 
Glib::RefPtr< const Gdk::Windowget_window () const
 
Allocation get_allocation () const
 
void set_allocation (const Allocation &allocation)
 
Containerget_parent ()
 
const Containerget_parent () const
 
Glib::RefPtr< Gdk::Windowget_parent_window ()
 
Glib::RefPtr< const Gdk::Windowget_parent_window () const
 
void set_parent_window (const Glib::RefPtr< const Gdk::Window > &parent_window)
 
bool child_focus (DirectionType direction)
 
bool keynav_failed (DirectionType direction)
 
void error_bell ()
 
void set_size_request (int width=-1, int height=-1)
 
void get_size_request (int &width, int &height) const
 
void set_events (Gdk::EventMask events)
 
void add_events (Gdk::EventMask events)
 
void set_extension_events (Gdk::ExtensionMode mode)
 
Gdk::ExtensionMode get_extension_events () const
 
Containerget_toplevel ()
 
const Containerget_toplevel () const
 
Widgetget_ancestor (GType widget_type)
 
const Widgetget_ancestor (GType widget_type) const
 
Glib::RefPtr< Gdk::Colormapget_colormap ()
 
Glib::RefPtr< Gdk::Visualget_visual ()
 
Glib::RefPtr< Gdk::Screenget_screen ()
 
Glib::RefPtr< const Gdk::Screenget_screen () const
 
bool has_screen () const
 
Glib::RefPtr< Gdk::Displayget_display ()
 
Glib::RefPtr< const Gdk::Displayget_display () const
 
Glib::RefPtr< Gdk::Windowget_root_window ()
 
Glib::RefPtr< const Gdk::Windowget_root_window () const
 
Glib::RefPtr< Settingsget_settings ()
 
Glib::RefPtr< Clipboardget_clipboard (const Glib::ustring &selection)
 
Glib::RefPtr< const Clipboardget_clipboard (const Glib::ustring &selection) const
 
Glib::RefPtr< Gdk::Pixmapget_snapshot (Gdk::Rectangle &clip_rect) const
 
Glib::RefPtr< Gdk::Pixmapget_snapshot () const
 
void set_colormap (const Glib::RefPtr< const Gdk::Colormap > &colormap)
 
Gdk::EventMask get_events () const
 
void get_pointer (int &x, int &y) const
 
bool is_ancestor (Widget &ancestor) const
 
bool translate_coordinates (Widget &dest_widget, int src_x, int src_y, int &dest_x, int &dest_y)
 
bool has_rc_style () const
 
void set_style (const Glib::RefPtr< Style > &style)
 
void unset_style ()
 
void ensure_style ()
 
Glib::RefPtr< Styleget_style ()
 
Glib::RefPtr< const Styleget_style () const
 
void modify_style (const Glib::RefPtr< RcStyle > &style)
 
Glib::RefPtr< RcStyleget_modifier_style ()
 
Glib::RefPtr< const RcStyleget_modifier_style () const
 
void modify_fg (StateType state, const Gdk::Color &color)
 
void modify_bg (StateType state, const Gdk::Color &color)
 
void modify_bg_pixmap (StateType state, const Glib::ustring &pixmap_name)
 
void modify_text (StateType state, const Gdk::Color &color)
 
void modify_base (StateType state, const Gdk::Color &color)
 
void modify_cursor (const Gdk::Color &primary, const Gdk::Color &secondary)
 
void unset_cursor ()
 See modify_cursor(). More...
 
void modify_font (const Pango::FontDescription &font_desc)
 
void unset_fg (StateType state)
 
void unset_bg (StateType state)
 
void unset_text (StateType state)
 
void unset_base (StateType state)
 
void unset_font ()
 
template<class PropertyType >
void get_style_property (const Glib::ustring &the_property_name, PropertyType &value) const
 
Glib::RefPtr< Pango::Context > create_pango_context ()
 
Glib::RefPtr< Pango::Context > get_pango_context ()
 
Glib::RefPtr< Pango::Layout > create_pango_layout (const Glib::ustring &text)
 
Glib::RefPtr< Gdk::Pixbufrender_icon (const StockID &stock_id, IconSize size, const Glib::ustring &detail=Glib::ustring())
 
void set_composite_name (const Glib::ustring &name)
 
void unset_composite_name ()
 
Glib::ustring get_composite_name () const
 
void reset_rc_styles ()
 
void set_direction (TextDirection dir)
 
TextDirection get_direction ()
 
TextDirection get_direction () const
 
void shape_combine_mask (const Glib::RefPtr< const Gdk::Bitmap > &shape_mask, int offset_x, int offset_y)
 
void unset_shape_combine_mask ()
 
void input_shape_combine_mask (const Glib::RefPtr< const Gdk::Bitmap > &shape_mask, int offset_x, int offset_y)
 
void unset_input_shape_combine_mask ()
 
void reset_shapes ()
 
void path (Glib::ustring &path, Glib::ustring &path_reversed)
 Compute a widget's path of the form "GtkWindow.MyLabel". More...
 
void class_path (Glib::ustring &path, Glib::ustring &path_reversed)
 
Glib::ListHandle< Widget * > list_mnemonic_labels ()
 
Glib::ListHandle< const Widget * > list_mnemonic_labels () const
 
void add_mnemonic_label (Widget &label)
 
void remove_mnemonic_label (Widget &label)
 
void drag_get_data (const Glib::RefPtr< Gdk::DragContext > &context, Glib::ustring &target, guint32 time)
 
void drag_get_data (const Glib::RefPtr< Gdk::DragContext > &context, const Glib::ustring &target, guint32 time)
 
void drag_highlight ()
 
void drag_unhighlight ()
 
void drag_dest_set (DestDefaults flags=DestDefaults(0), Gdk::DragAction actions=Gdk::DragAction(0))
 
void drag_dest_set (const ArrayHandle_TargetEntry &targets, DestDefaults flags=DEST_DEFAULT_ALL, Gdk::DragAction actions=Gdk::ACTION_COPY)
 
void drag_dest_set_proxy (const Glib::RefPtr< Gdk::Window > &proxy_window, Gdk::DragProtocol protocol, bool use_coordinates)
 
void drag_dest_unset ()
 
Glib::ustring drag_dest_find_target (const Glib::RefPtr< Gdk::DragContext > &context, const Glib::RefPtr< TargetList > &target_list) const
 
Glib::ustring drag_dest_find_target (const Glib::RefPtr< Gdk::DragContext > &context) const
 
Glib::RefPtr< TargetListdrag_dest_get_target_list ()
 
Glib::RefPtr< const TargetListdrag_dest_get_target_list () const
 
void drag_dest_set_target_list (const Glib::RefPtr< TargetList > &target_list)
 
void drag_dest_add_text_targets ()
 
void drag_dest_add_image_targets ()
 
void drag_dest_add_uri_targets ()
 
void drag_source_set (const ArrayHandle_TargetEntry &targets, Gdk::ModifierType start_button_mask=Gdk::MODIFIER_MASK, Gdk::DragAction actions=Gdk::ACTION_COPY)
 
void drag_source_unset ()
 
void drag_source_set_icon (const Glib::RefPtr< Gdk::Colormap > &colormap, const Glib::RefPtr< Gdk::Pixmap > &pixmap, const Glib::RefPtr< Gdk::Bitmap > &mask)
 
void drag_source_set_icon (const Glib::RefPtr< Gdk::Pixbuf > &pixbuf)
 
void drag_source_set_icon (const StockID &stock_id)
 
void drag_source_set_icon (const Glib::ustring &icon_name)
 
void drag_source_add_text_targets ()
 
void drag_source_add_uri_targets ()
 
void drag_source_add_image_targets ()
 
Glib::RefPtr< Gdk::DragContextdrag_begin (const Glib::RefPtr< TargetList > &targets, Gdk::DragAction actions, int button, GdkEvent *event)
 
bool drag_check_threshold (int start_x, int start_y, int current_x, int current_y)
 
void drag_set_as_icon (const Glib::RefPtr< Gdk::DragContext > &context, int hot_x, int hot_y)
 
void queue_resize_no_redraw ()
 
bool get_no_show_all () const
 
void set_no_show_all (bool no_show_all=true)
 
void set_parent (Widget &parent)
 
void unparent ()
 
void map ()
 
void unmap ()
 
void draw_insertion_cursor (Glib::RefPtr< Gdk::Drawable > drawable, const Gdk::Rectangle &area, const Gdk::Rectangle &location, bool is_primary, TextDirection direction, bool draw_arrow=true)
 
void set_tooltip_window (Window &window)
 
Windowget_tooltip_window ()
 
void trigger_tooltip_query ()
 
void set_tooltip_text (const Glib::ustring &text)
 
Glib::ustring get_tooltip_text () const
 
void set_tooltip_markup (const Glib::ustring &markup)
 
Glib::ustring get_tooltip_markup () const
 
void set_has_tooltip (bool has_tooltip=TRUE)
 
bool get_has_tooltip () const
 
bool has_no_window () const
 
bool is_realized () const
 
bool is_mapped () const
 
bool is_toplevel () const
 
bool is_drawable () const
 
bool is_visible () const
 
bool sensitive () const
 
bool app_paintable () const
 
bool receives_default () const
 
bool double_buffered () const
 
bool parent_sensitive () const
 
bool rc_style () const
 
bool is_composite_child () const
 
WidgetFlags get_flags () const
 
void set_flags (WidgetFlags flags)
 
void unset_flags (WidgetFlags flags)
 
Gtk::StateType get_saved_state () const
 
int get_width () const
 
int get_height () const
 
bool is_composited () const
 
Glib::RefPtr< Actionget_action ()
 
Glib::RefPtr< const Actionget_action () const
 
Requisition get_requisition () const
 
Glib::SignalProxy0< void > signal_show ()
 
Glib::SignalProxy0< void > signal_hide ()
 
Glib::SignalProxy0< void > signal_map ()
 Emitted on mapping of a widget to the screen. More...
 
Glib::SignalProxy0< void > signal_unmap ()
 
Glib::SignalProxy0< void > signal_realize ()
 Emitted on realization of a widget. More...
 
Glib::SignalProxy0< void > signal_unrealize ()
 
Glib::SignalProxy1< void, Requisition * > signal_size_request ()
 
Glib::SignalProxy1< void, Allocation & > signal_size_allocate ()
 
Glib::SignalProxy1< void, Gtk::StateTypesignal_state_changed ()
 
Glib::SignalProxy1< void, Widget * > signal_parent_changed ()
 Informs objects that their parent changed. More...
 
Glib::SignalProxy1< void, Widget * > signal_hierarchy_changed ()
 
Glib::SignalProxy1< void, const Glib::RefPtr< Gtk::Style > & > signal_style_changed ()
 
Glib::SignalProxy1< void, TextDirectionsignal_direction_changed ()
 
Glib::SignalProxy1< void, bool > signal_grab_notify ()
 
Glib::SignalProxy1< void, GParamSpec * > signal_child_notify ()
 
Glib::SignalProxy1< bool, bool > signal_mnemonic_activate ()
 
Glib::SignalProxy0< void > signal_grab_focus ()
 
Glib::SignalProxy1< bool, DirectionTypesignal_focus ()
 
Glib::SignalProxy1< bool, GdkEvent * > signal_event ()
 
Glib::SignalProxy1< void, GdkEvent * > signal_event_after ()
 
Glib::SignalProxy1< bool, GdkEventButton * > signal_button_press_event ()
 
Glib::SignalProxy1< bool, GdkEventButton * > signal_button_release_event ()
 
Glib::SignalProxy1< bool, GdkEventScroll * > signal_scroll_event ()
 
Glib::SignalProxy1< bool, GdkEventMotion * > signal_motion_notify_event ()
 
Glib::SignalProxy1< bool, GdkEventAny * > signal_delete_event ()
 
Glib::SignalProxy1< bool, GdkEventExpose * > signal_expose_event ()
 Event triggered by window requiring a refresh. More...
 
Glib::SignalProxy1< bool, GdkEventKey * > signal_key_press_event ()
 
Glib::SignalProxy1< bool, GdkEventKey * > signal_key_release_event ()
 
Glib::SignalProxy1< bool, GdkEventCrossing * > signal_enter_notify_event ()
 
Glib::SignalProxy1< bool, GdkEventCrossing * > signal_leave_notify_event ()
 
Glib::SignalProxy1< bool, GdkEventConfigure * > signal_configure_event ()
 
Glib::SignalProxy1< bool, GdkEventFocus * > signal_focus_in_event ()
 
Glib::SignalProxy1< bool, GdkEventFocus * > signal_focus_out_event ()
 
Glib::SignalProxy1< bool, GdkEventAny * > signal_map_event ()
 
Glib::SignalProxy1< bool, GdkEventAny * > signal_unmap_event ()
 
Glib::SignalProxy1< bool, GdkEventProperty * > signal_property_notify_event ()
 
Glib::SignalProxy1< bool, GdkEventSelection * > signal_selection_clear_event ()
 
Glib::SignalProxy1< bool, GdkEventSelection * > signal_selection_request_event ()
 
Glib::SignalProxy1< bool, GdkEventSelection * > signal_selection_notify_event ()
 
Glib::SignalProxy1< bool, GdkEventProximity * > signal_proximity_in_event ()
 
Glib::SignalProxy1< bool, GdkEventProximity * > signal_proximity_out_event ()
 
Glib::SignalProxy1< bool, GdkEventVisibility * > signal_visibility_notify_event ()
 
Glib::SignalProxy1< bool, GdkEventClient * > signal_client_event ()
 
Glib::SignalProxy1< bool, GdkEventAny * > signal_no_expose_event ()
 
Glib::SignalProxy1< bool, GdkEventWindowState * > signal_window_state_event ()
 
Glib::SignalProxy3< void, SelectionData &, guint, guint > signal_selection_get ()
 
Glib::SignalProxy2< void, const SelectionData &, guint > signal_selection_received ()
 
Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::DragContext > & > signal_drag_begin ()
 
Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::DragContext > & > signal_drag_end ()
 
Glib::SignalProxy4< void, const Glib::RefPtr< Gdk::DragContext > &, SelectionData &, guint, guint > signal_drag_data_get ()
 
Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::DragContext > & > signal_drag_data_delete ()
 
Glib::SignalProxy2< bool, const Glib::RefPtr< Gdk::DragContext > &, DragResultsignal_drag_failed ()
 
Glib::SignalProxy2< void, const Glib::RefPtr< Gdk::DragContext > &, guint > signal_drag_leave ()
 
Glib::SignalProxy4< bool, const Glib::RefPtr< Gdk::DragContext > &, int, int, guint > signal_drag_motion ()
 
Glib::SignalProxy4< bool, const Glib::RefPtr< Gdk::DragContext > &, int, int, guint > signal_drag_drop ()
 
Glib::SignalProxy6< void, const Glib::RefPtr< Gdk::DragContext > &, int, int, const SelectionData &, guint, guint > signal_drag_data_received ()
 
Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::Screen > & > signal_screen_changed ()
 
Glib::SignalProxy0< void > signal_composited_changed ()
 
Glib::SignalProxy0< bool > signal_popup_menu ()
 
Glib::SignalProxy4< bool, int, int, bool, const Glib::RefPtr< Tooltip > & > signal_query_tooltip ()
 
Glib::SignalProxy1< bool, GdkEventGrabBroken * > signal_grab_broken_event ()
 
Glib::SignalProxy1< bool, GdkEventExpose * > signal_damage_event ()
 
Glib::PropertyProxy< Glib::ustring > property_name ()
 
Glib::PropertyProxy_ReadOnly< Glib::ustring > property_name () const
 
Glib::PropertyProxy< Container * > property_parent ()
 
Glib::PropertyProxy_ReadOnly< Container * > property_parent () const
 
Glib::PropertyProxy< int > property_width_request ()
 
Glib::PropertyProxy_ReadOnly< int > property_width_request () const
 
Glib::PropertyProxy< int > property_height_request ()
 
Glib::PropertyProxy_ReadOnly< int > property_height_request () const
 
Glib::PropertyProxy< bool > property_visible ()
 
Glib::PropertyProxy_ReadOnly< bool > property_visible () const
 
Glib::PropertyProxy< bool > property_sensitive ()
 
Glib::PropertyProxy_ReadOnly< bool > property_sensitive () const
 
Glib::PropertyProxy< bool > property_app_paintable ()
 
Glib::PropertyProxy_ReadOnly< bool > property_app_paintable () const
 
Glib::PropertyProxy< bool > property_can_focus ()
 
Glib::PropertyProxy_ReadOnly< bool > property_can_focus () const
 
Glib::PropertyProxy< bool > property_has_focus ()
 
Glib::PropertyProxy_ReadOnly< bool > property_has_focus () const
 
Glib::PropertyProxy< bool > property_is_focus ()
 
Glib::PropertyProxy_ReadOnly< bool > property_is_focus () const
 
Glib::PropertyProxy< bool > property_can_default ()
 
Glib::PropertyProxy_ReadOnly< bool > property_can_default () const
 
Glib::PropertyProxy< bool > property_has_default ()
 
Glib::PropertyProxy_ReadOnly< bool > property_has_default () const
 
Glib::PropertyProxy< bool > property_receives_default ()
 
Glib::PropertyProxy_ReadOnly< bool > property_receives_default () const
 
Glib::PropertyProxy_ReadOnly< bool > property_composite_child () const
 
Glib::PropertyProxy< Glib::RefPtr< Style > > property_style ()
 
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Style > > property_style () const
 
Glib::PropertyProxy< Gdk::EventMaskproperty_events ()
 
Glib::PropertyProxy_ReadOnly< Gdk::EventMaskproperty_events () const
 
Glib::PropertyProxy< Gdk::ExtensionModeproperty_extension_events ()
 
Glib::PropertyProxy_ReadOnly< Gdk::ExtensionModeproperty_extension_events () const
 
Glib::PropertyProxy< bool > property_has_tooltip ()
 
Glib::PropertyProxy_ReadOnly< bool > property_has_tooltip () const
 
Glib::PropertyProxy< Glib::ustring > property_tooltip_markup ()
 
Glib::PropertyProxy_ReadOnly< Glib::ustring > property_tooltip_markup () const
 
Glib::PropertyProxy< Glib::ustring > property_tooltip_text ()
 
Glib::PropertyProxy_ReadOnly< Glib::ustring > property_tooltip_text () const
 
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Window > > property_window () const
 
Glib::PropertyProxy< bool > property_no_show_all ()
 
Glib::PropertyProxy_ReadOnly< bool > property_no_show_all () const
 
Glib::PropertyProxy< bool > property_double_buffered ()
 
Glib::PropertyProxy_ReadOnly< bool > property_double_buffered () const
 
- Public Member Functions inherited from Gtk::Object
virtual ~Object ()
 
GtkObjectgobj ()
 Provides access to the underlying C GtkObject. More...
 
const GtkObjectgobj () const
 Provides access to the underlying C GtkObject. More...
 
Glib::PropertyProxy< void * > property_user_data ()
 
Glib::PropertyProxy_ReadOnly< void * > property_user_data () const
 

Static Public Member Functions

static void set_window_creation_hook (const SlotWindowCreation &slot)
 
- Static Public Member Functions inherited from Gtk::Widget
static Widgetget_current_modal_grab ()
 
static void push_colormap (const Glib::RefPtr< const Gdk::Colormap > &cmap)
 
static void pop_colormap ()
 
static void push_composite_child ()
 
static void pop_composite_child ()
 
static void set_default_colormap (const Glib::RefPtr< const Gdk::Colormap > &colormap)
 
static Glib::RefPtr< Styleget_default_style ()
 
static Glib::RefPtr< Gdk::Colormapget_default_colormap ()
 
static Glib::RefPtr< Gdk::Visualget_default_visual ()
 
static void set_default_direction (TextDirection dir)
 
static TextDirection get_default_direction ()
 
static Widgetdrag_get_source_widget (const Glib::RefPtr< Gdk::DragContext > &context)
 

Protected Member Functions

virtual void on_switch_page (GtkNotebookPage *page, guint page_num)
 This is a default handler for the signal signal_switch_page(). More...
 
- Protected Member Functions inherited from Gtk::Container
virtual void on_add (Widget *widget)
 This is a default handler for the signal signal_add(). More...
 
virtual void on_remove (Widget *widget)
 This is a default handler for the signal signal_remove(). More...
 
virtual void on_check_resize ()
 This is a default handler for the signal signal_check_resize(). More...
 
virtual void on_set_focus_child (Widget *widget)
 This is a default handler for the signal signal_set_focus_child(). More...
 
 Container ()
 
virtual GType child_type_vfunc () const
 
virtual void forall_vfunc (gboolean include_internals, GtkCallback callback, gpointer callback_data)
 
virtual char * composite_name_vfunc (GtkWidget *child)
 
virtual void set_child_property_vfunc (GtkWidget *child, guint property_id, const GValue *value, GParamSpec *pspec)
 
virtual void get_child_property_vfunc (GtkWidget *child, guint property_id, GValue *value, GParamSpec *pspec) const
 
Glib::PropertyProxy< guint > property_border_width ()
 
Glib::PropertyProxy_ReadOnly< guint > property_border_width () const
 
Glib::PropertyProxy< ResizeModeproperty_resize_mode ()
 
Glib::PropertyProxy_ReadOnly< ResizeModeproperty_resize_mode () const
 
Glib::PropertyProxy_WriteOnly< Widget * > property_child ()
 
- Protected Member Functions inherited from Gtk::Widget
virtual void on_show ()
 This is a default handler for the signal signal_show(). More...
 
virtual void on_hide ()
 This is a default handler for the signal signal_hide(). More...
 
virtual void on_map ()
 This is a default handler for the signal signal_map(). More...
 
virtual void on_unmap ()
 This is a default handler for the signal signal_unmap(). More...
 
virtual void on_realize ()
 This is a default handler for the signal signal_realize(). More...
 
virtual void on_unrealize ()
 This is a default handler for the signal signal_unrealize(). More...
 
virtual void on_size_request (Requisition *requisition)
 This is a default handler for the signal signal_size_request(). More...
 
virtual void on_size_allocate (Allocation &allocation)
 This is a default handler for the signal signal_size_allocate(). More...
 
virtual void on_state_changed (Gtk::StateType previous_state)
 This is a default handler for the signal signal_state_changed(). More...
 
virtual void on_parent_changed (Widget *previous_parent)
 This is a default handler for the signal signal_parent_changed(). More...
 
virtual void on_hierarchy_changed (Widget *previous_toplevel)
 This is a default handler for the signal signal_hierarchy_changed(). More...
 
virtual void on_style_changed (const Glib::RefPtr< Gtk::Style > &previous_style)
 This is a default handler for the signal signal_style_changed(). More...
 
virtual void on_direction_changed (TextDirection direction)
 This is a default handler for the signal signal_direction_changed(). More...
 
virtual void on_grab_notify (bool was_grabbed)
 This is a default handler for the signal signal_grab_notify(). More...
 
virtual void on_child_notify (GParamSpec *pspec)
 This is a default handler for the signal signal_child_notify(). More...
 
virtual bool on_mnemonic_activate (bool group_cycling)
 This is a default handler for the signal signal_mnemonic_activate(). More...
 
virtual void on_grab_focus ()
 This is a default handler for the signal signal_grab_focus(). More...
 
virtual bool on_focus (DirectionType direction)
 This is a default handler for the signal signal_focus(). More...
 
virtual bool on_event (GdkEvent *event)
 This is a default handler for the signal signal_event(). More...
 
virtual bool on_button_press_event (GdkEventButton *event)
 This is a default handler for the signal signal_button_press_event(). More...
 
virtual bool on_button_release_event (GdkEventButton *event)
 This is a default handler for the signal signal_button_release_event(). More...
 
virtual bool on_scroll_event (GdkEventScroll *event)
 This is a default handler for the signal signal_scroll_event(). More...
 
virtual bool on_motion_notify_event (GdkEventMotion *event)
 This is a default handler for the signal signal_motion_notify_event(). More...
 
virtual bool on_delete_event (GdkEventAny *event)
 This is a default handler for the signal signal_delete_event(). More...
 
virtual bool on_expose_event (GdkEventExpose *event)
 This is a default handler for the signal signal_expose_event(). More...
 
virtual bool on_key_press_event (GdkEventKey *event)
 This is a default handler for the signal signal_key_press_event(). More...
 
virtual bool on_key_release_event (GdkEventKey *event)
 This is a default handler for the signal signal_key_release_event(). More...
 
virtual bool on_enter_notify_event (GdkEventCrossing *event)
 This is a default handler for the signal signal_enter_notify_event(). More...
 
virtual bool on_leave_notify_event (GdkEventCrossing *event)
 This is a default handler for the signal signal_leave_notify_event(). More...
 
virtual bool on_configure_event (GdkEventConfigure *event)
 This is a default handler for the signal signal_configure_event(). More...
 
virtual bool on_focus_in_event (GdkEventFocus *event)
 This is a default handler for the signal signal_focus_in_event(). More...
 
virtual bool on_focus_out_event (GdkEventFocus *event)
 This is a default handler for the signal signal_focus_out_event(). More...
 
virtual bool on_map_event (GdkEventAny *event)
 This is a default handler for the signal signal_map_event(). More...
 
virtual bool on_unmap_event (GdkEventAny *event)
 This is a default handler for the signal signal_unmap_event(). More...
 
virtual bool on_property_notify_event (GdkEventProperty *event)
 This is a default handler for the signal signal_property_notify_event(). More...
 
virtual bool on_selection_clear_event (GdkEventSelection *event)
 This is a default handler for the signal signal_selection_clear_event(). More...
 
virtual bool on_selection_request_event (GdkEventSelection *event)
 This is a default handler for the signal signal_selection_request_event(). More...
 
virtual bool on_selection_notify_event (GdkEventSelection *event)
 This is a default handler for the signal signal_selection_notify_event(). More...
 
virtual bool on_proximity_in_event (GdkEventProximity *event)
 This is a default handler for the signal signal_proximity_in_event(). More...
 
virtual bool on_proximity_out_event (GdkEventProximity *event)
 This is a default handler for the signal signal_proximity_out_event(). More...
 
virtual bool on_visibility_notify_event (GdkEventVisibility *event)
 This is a default handler for the signal signal_visibility_notify_event(). More...
 
virtual bool on_client_event (GdkEventClient *event)
 This is a default handler for the signal signal_client_event(). More...
 
virtual bool on_no_expose_event (GdkEventAny *event)
 This is a default handler for the signal signal_no_expose_event(). More...
 
virtual bool on_window_state_event (GdkEventWindowState *event)
 This is a default handler for the signal signal_window_state_event(). More...
 
virtual void on_selection_get (SelectionData &selection_data, guint info, guint time)
 This is a default handler for the signal signal_selection_get(). More...
 
virtual void on_selection_received (const SelectionData &selection_data, guint time)
 This is a default handler for the signal signal_selection_received(). More...
 
virtual void on_drag_begin (const Glib::RefPtr< Gdk::DragContext > &context)
 This is a default handler for the signal signal_drag_begin(). More...
 
virtual void on_drag_end (const Glib::RefPtr< Gdk::DragContext > &context)
 This is a default handler for the signal signal_drag_end(). More...
 
virtual void on_drag_data_get (const Glib::RefPtr< Gdk::DragContext > &context, SelectionData &selection_data, guint info, guint time)
 This is a default handler for the signal signal_drag_data_get(). More...
 
virtual void on_drag_data_delete (const Glib::RefPtr< Gdk::DragContext > &context)
 This is a default handler for the signal signal_drag_data_delete(). More...
 
virtual void on_drag_leave (const Glib::RefPtr< Gdk::DragContext > &context, guint time)
 This is a default handler for the signal signal_drag_leave(). More...
 
virtual bool on_drag_motion (const Glib::RefPtr< Gdk::DragContext > &context, int x, int y, guint time)
 This is a default handler for the signal signal_drag_motion(). More...
 
virtual bool on_drag_drop (const Glib::RefPtr< Gdk::DragContext > &context, int x, int y, guint time)
 This is a default handler for the signal signal_drag_drop(). More...
 
virtual void on_drag_data_received (const Glib::RefPtr< Gdk::DragContext > &context, int x, int y, const SelectionData &selection_data, guint info, guint time)
 This is a default handler for the signal signal_drag_data_received(). More...
 
virtual bool on_touch_begin_event (GdkEventTouch *event)
 
virtual bool on_touch_update_event (GdkEventTouch *event)
 
virtual bool on_touch_end_event (GdkEventTouch *event)
 
virtual void on_screen_changed (const Glib::RefPtr< Gdk::Screen > &previous_screen)
 This is a default handler for the signal signal_screen_changed(). More...
 
virtual void dispatch_child_properties_changed_vfunc (guint p1, GParamSpec **p2)
 
virtual void show_all_vfunc ()
 
virtual void hide_all_vfunc ()
 
 Widget ()
 
void realize ()
 
void unrealize ()
 
void set_mapped (bool mapped=true)
 
void set_realized (bool realized=true)
 
void style_attach ()
 
void get_child_requisition (Requisition &requisition) const
 
void get_style_property_value (const Glib::ustring &the_property_name, Glib::ValueBase &value) const
 
void realize_if_needed ()
 

Related Functions

(Note that these are not member functions.)

Gtk::Notebookwrap (GtkNotebook *object, bool take_copy=false)
 

Detailed Description

Container which shows one of its children at a time, in tabbed windows.

The Gtk::Notebook widget is a Gtk::Container whose children are pages that can be switched between using tab labels along one edge.

Definition at line 361 of file notebook.h.

Member Typedef Documentation

◆ PageList

◆ SlotWindowCreation

typedef sigc::slot<Notebook*, Widget*, int, int> Gtk::Notebook::SlotWindowCreation

For instance, Notebook* on_window_creation(Widget* page, int x, int y);

Definition at line 520 of file notebook.h.

Constructor & Destructor Documentation

◆ ~Notebook()

virtual Gtk::Notebook::~Notebook ( )
virtual

◆ Notebook()

Gtk::Notebook::Notebook ( )

Member Function Documentation

◆ append_page() [1/5]

int Gtk::Notebook::append_page ( Widget child)

◆ append_page() [2/5]

int Gtk::Notebook::append_page ( Widget child,
const Glib::ustring &  tab_label,
bool  use_mnemonic = false 
)

◆ append_page() [3/5]

int Gtk::Notebook::append_page ( Widget child,
const Glib::ustring &  tab_label,
const Glib::ustring &  menu_label,
bool  use_mnemonic = false 
)

◆ append_page() [4/5]

int Gtk::Notebook::append_page ( Widget child,
Widget tab_label 
)

Appends a page to notebook.

Parameters
childThe Gtk::Widget to use as the contents of the page.
tab_labelThe Gtk::Widget to be used as the label for the page.

◆ append_page() [5/5]

int Gtk::Notebook::append_page ( Widget child,
Widget tab_label,
Widget menu_label 
)

Appends a page to notebook, specifying the widget to use as the label in the popup menu.

Parameters
childThe Gtk::Widget to use as the contents of the page.
tab_labelThe Gtk::Widget to be used as the label for the page.
menu_labelThe widget to use as a label for the page-switch menu.

◆ get_action_widget()

Widget* Gtk::Notebook::get_action_widget ( PackType  pack_type = PACK_START)

Gets one of the action widgets. See set_action_widget().

Parameters
pack_typePack type of the action widget to receive.
Returns
The action widget with the given pack_type or 0 when this action widget has not been set.

◆ get_current()

PageList::iterator Gtk::Notebook::get_current ( )

◆ get_current_page()

int Gtk::Notebook::get_current_page ( ) const

Returns the page number of the current page.

Returns
The index (starting from 0) of the current page in the notebook. If the notebook has no pages, then -1 will be returned.

◆ get_group() [1/2]

void* Gtk::Notebook::get_group ( )

Gets the current group identificator pointer for notebook.

Deprecated: 2.24: Use get_group_name() instead

Returns
The group identificator, or 0 if none is set.

◆ get_group() [2/2]

const void* Gtk::Notebook::get_group ( ) const

Gets the current group identificator pointer for notebook.

Deprecated: 2.24: Use get_group_name() instead

Returns
The group identificator, or 0 if none is set.

◆ get_group_id()

int Gtk::Notebook::get_group_id ( ) const

Gets the current group identificator for notebook. Deprecated: 2.12: use get_group_name() instead.

Returns
The group identificator, or -1 if none is set.

◆ get_group_name()

Glib::ustring Gtk::Notebook::get_group_name ( ) const

Gets the current group name for notebook.

Note that this funtion can emphasis not be used together with set_group() or set_group_id().

Return Value: (transfer none): the group name, or 0 if none is set.

◆ get_menu_label() [1/2]

Widget* Gtk::Notebook::get_menu_label ( Widget child)

Retrieves the menu label widget of the page containing child.

Parameters
childA widget contained in a page of notebook.
Returns
The menu label, or 0 if the notebook page does not have a menu label other than the default (the tab label).

◆ get_menu_label() [2/2]

const Widget* Gtk::Notebook::get_menu_label ( Widget child) const

Retrieves the menu label widget of the page containing child.

Parameters
childA widget contained in a page of notebook.
Returns
The menu label, or 0 if the notebook page does not have a menu label other than the default (the tab label).

◆ get_menu_label_text()

Glib::ustring Gtk::Notebook::get_menu_label_text ( Widget child) const

Retrieves the text of the menu label for the page containing child.

Parameters
childThe child widget of a page of the notebook.
Returns
Value: the text of the tab label.

◆ get_n_pages() [1/2]

int Gtk::Notebook::get_n_pages ( )

Gets the number of pages in a notebook.

Returns
The number of pages in the notebook.

◆ get_n_pages() [2/2]

int Gtk::Notebook::get_n_pages ( ) const

Gets the number of pages in a notebook.

Returns
The number of pages in the notebook.

◆ get_nth_page() [1/2]

Widget* Gtk::Notebook::get_nth_page ( int  page_num)

Returns the child widget contained in page number page_num.

Parameters
page_numThe index of a page in the notebook, or -1 to get the last page.
Returns
The child widget, or 0 if page_num is out of bounds.

◆ get_nth_page() [2/2]

const Widget* Gtk::Notebook::get_nth_page ( int  page_num) const

Returns the child widget contained in page number page_num.

Parameters
page_numThe index of a page in the notebook, or -1 to get the last page.
Returns
The child widget, or 0 if page_num is out of bounds.

◆ get_scrollable()

bool Gtk::Notebook::get_scrollable ( ) const

Returns whether the tab label area has arrows for scrolling. See set_scrollable().

Returns
true if arrows for scrolling are present.

◆ get_show_border()

bool Gtk::Notebook::get_show_border ( ) const

Returns whether a bevel will be drawn around the notebook pages. See set_show_border().

Returns
true if the bevel is drawn.

◆ get_show_tabs()

bool Gtk::Notebook::get_show_tabs ( ) const

Returns whether the tabs of the notebook are shown. See set_show_tabs().

Returns
true if the tabs are shown.

◆ get_tab_detachable()

bool Gtk::Notebook::get_tab_detachable ( Widget child) const

Returns whether the tab contents can be detached from notebook.

Parameters
childA child Gtk::Widget.
Returns
true if the tab is detachable.

◆ get_tab_hborder()

guint16 Gtk::Notebook::get_tab_hborder ( ) const

Returns the horizontal width of a tab border.

Returns
Horizontal width of a tab border.

◆ get_tab_label() [1/2]

Widget* Gtk::Notebook::get_tab_label ( Widget child)

Returns the tab label widget for the page child. 0 is returned if child is not in notebook or if no tab label has specifically been set for child.

Parameters
childThe page.
Returns
The tab label.

◆ get_tab_label() [2/2]

const Widget* Gtk::Notebook::get_tab_label ( Widget child) const

Returns the tab label widget for the page child. 0 is returned if child is not in notebook or if no tab label has specifically been set for child.

Parameters
childThe page.
Returns
The tab label.

◆ get_tab_label_text()

Glib::ustring Gtk::Notebook::get_tab_label_text ( Widget child) const

Retrieves the text of the tab label for the page containing child.

Parameters
childA widget contained in a page of notebook.
Returns
Value: the text of the tab label.

◆ get_tab_pos()

PositionType Gtk::Notebook::get_tab_pos ( ) const

Gets the edge at which the tabs for switching pages in the notebook are drawn.

Returns
The edge at which the tabs are drawn.

◆ get_tab_reorderable()

bool Gtk::Notebook::get_tab_reorderable ( Widget child) const

Gets whether the tab can be reordered via drag and drop or not.

Parameters
childA child Gtk::Widget.
Returns
true if the tab is reorderable.

◆ get_tab_vborder()

guint16 Gtk::Notebook::get_tab_vborder ( ) const

Returns the vertical width of a tab border.

Returns
Vertical width of a tab border.

◆ gobj() [1/2]

GtkNotebook* Gtk::Notebook::gobj ( )
inline

Provides access to the underlying C GtkObject.

Definition at line 398 of file notebook.h.

◆ gobj() [2/2]

const GtkNotebook* Gtk::Notebook::gobj ( ) const
inline

Provides access to the underlying C GtkObject.

Definition at line 401 of file notebook.h.

◆ insert_page() [1/5]

int Gtk::Notebook::insert_page ( Widget child,
const Glib::ustring &  tab_label,
const Glib::ustring &  menu_label,
int  position,
bool  use_mnemonic = false 
)

◆ insert_page() [2/5]

int Gtk::Notebook::insert_page ( Widget child,
const Glib::ustring &  tab_label,
int  position,
bool  use_mnemonic = false 
)

◆ insert_page() [3/5]

int Gtk::Notebook::insert_page ( Widget child,
int  position 
)

◆ insert_page() [4/5]

int Gtk::Notebook::insert_page ( Widget child,
Widget tab_label,
int  position 
)

Insert a page into notebook at the given position

Parameters
childThe Gtk::Widget to use as the contents of the page.
tab_labelThe Gtk::Widget to be used as the label for the page.
positionThe index (starting at 0) at which to insert the page, or -1 to append the page after all other pages.

◆ insert_page() [5/5]

int Gtk::Notebook::insert_page ( Widget child,
Widget tab_label,
Widget menu_label,
int  position 
)

Insert a page into notebook at the given position, specifying the widget to use as the label in the popup menu.

Parameters
childThe Gtk::Widget to use as the contents of the page.
tab_labelThe Gtk::Widget to be used as the label for the page..
menu_labelThe widget to use as a label for the page-switch menu.
positionThe index (starting at 0) at which to insert the page, or -1 to append the page after all other pages.

◆ next_page()

void Gtk::Notebook::next_page ( )

Switches to the next page. Nothing happens if the current page is the last page.

◆ on_switch_page()

virtual void Gtk::Notebook::on_switch_page ( GtkNotebookPage page,
guint  page_num 
)
protectedvirtual

This is a default handler for the signal signal_switch_page().

◆ page_num() [1/2]

int Gtk::Notebook::page_num ( const Widget child)

Finds the index of the page which contains the given child widget.

Parameters
childA Gtk::Widget.
Returns
The index of the page containing child, or -1 if child is not in the notebook.

◆ page_num() [2/2]

int Gtk::Notebook::page_num ( const Widget child) const

Finds the index of the page which contains the given child widget.

Parameters
childA Gtk::Widget.
Returns
The index of the page containing child, or -1 if child is not in the notebook.

◆ pages() [1/2]

PageList& Gtk::Notebook::pages ( )

◆ pages() [2/2]

const PageList& Gtk::Notebook::pages ( ) const

◆ popup_disable()

void Gtk::Notebook::popup_disable ( )

Disables the popup menu.

◆ popup_enable()

void Gtk::Notebook::popup_enable ( )

Enables the popup menu: if the user clicks with the right mouse button on the tab labels, a menu with all the pages will be popped up.

◆ prepend_page() [1/5]

int Gtk::Notebook::prepend_page ( Widget child)

◆ prepend_page() [2/5]

int Gtk::Notebook::prepend_page ( Widget child,
const Glib::ustring &  tab_label,
bool  use_mnemonic = false 
)

◆ prepend_page() [3/5]

int Gtk::Notebook::prepend_page ( Widget child,
const Glib::ustring &  tab_label,
const Glib::ustring &  menu_label,
bool  use_mnemonic 
)

◆ prepend_page() [4/5]

int Gtk::Notebook::prepend_page ( Widget child,
Widget tab_label 
)

Prepends a page to notebook.

Parameters
childThe Gtk::Widget to use as the contents of the page.
tab_labelThe Gtk::Widget to be used as the label for the page.

◆ prepend_page() [5/5]

int Gtk::Notebook::prepend_page ( Widget child,
Widget tab_label,
Widget menu_label 
)

Prepends a page to notebook, specifying the widget to use as the label in the popup menu.

Parameters
childThe Gtk::Widget to use as the contents of the page.
tab_labelThe Gtk::Widget to be used as the label for the page.
menu_labelThe widget to use as a label for the page-switch menu.

◆ prev_page()

void Gtk::Notebook::prev_page ( )

Switches to the previous page. Nothing happens if the current page is the first page.

◆ property_enable_popup() [1/2]

Glib::PropertyProxy< bool > Gtk::Notebook::property_enable_popup ( )

If TRUE, pressing the right mouse button on the notebook pops up a menu that you can use to go to a page.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_enable_popup() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::Notebook::property_enable_popup ( ) const

If TRUE, pressing the right mouse button on the notebook pops up a menu that you can use to go to a page.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_group() [1/2]

Glib::PropertyProxy< void* > Gtk::Notebook::property_group ( )

Group for tabs drag and drop.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_group() [2/2]

Glib::PropertyProxy_ReadOnly< void* > Gtk::Notebook::property_group ( ) const

Group for tabs drag and drop.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_group_id() [1/2]

Glib::PropertyProxy< int > Gtk::Notebook::property_group_id ( )

Group ID for tabs drag and drop.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_group_id() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::Notebook::property_group_id ( ) const

Group ID for tabs drag and drop.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_homogeneous() [1/2]

Glib::PropertyProxy< bool > Gtk::Notebook::property_homogeneous ( )

Whether tabs should have homogeneous sizes.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_homogeneous() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::Notebook::property_homogeneous ( ) const

Whether tabs should have homogeneous sizes.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_page() [1/2]

Glib::PropertyProxy< int > Gtk::Notebook::property_page ( )

The index of the current page.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_page() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::Notebook::property_page ( ) const

The index of the current page.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_scrollable() [1/2]

Glib::PropertyProxy< bool > Gtk::Notebook::property_scrollable ( )

If TRUE, scroll arrows are added if there are too many tabs to fit.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_scrollable() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::Notebook::property_scrollable ( ) const

If TRUE, scroll arrows are added if there are too many tabs to fit.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_show_border() [1/2]

Glib::PropertyProxy< bool > Gtk::Notebook::property_show_border ( )

Whether the border should be shown or not.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_show_border() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::Notebook::property_show_border ( ) const

Whether the border should be shown or not.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_show_tabs() [1/2]

Glib::PropertyProxy< bool > Gtk::Notebook::property_show_tabs ( )

Whether tabs should be shown or not.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_show_tabs() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::Notebook::property_show_tabs ( ) const

Whether tabs should be shown or not.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_tab_border()

Glib::PropertyProxy_WriteOnly< guint > Gtk::Notebook::property_tab_border ( )

Width of the border around the tab labels.

Returns
A PropertyProxy_WriteOnly that allows you to set the value of the property, or receive notification when the value of the property changes.

◆ property_tab_hborder() [1/2]

Glib::PropertyProxy< guint > Gtk::Notebook::property_tab_hborder ( )

Width of the horizontal border of tab labels.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_tab_hborder() [2/2]

Glib::PropertyProxy_ReadOnly< guint > Gtk::Notebook::property_tab_hborder ( ) const

Width of the horizontal border of tab labels.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_tab_pos() [1/2]

Glib::PropertyProxy< PositionType > Gtk::Notebook::property_tab_pos ( )

Which side of the notebook holds the tabs.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_tab_pos() [2/2]

Glib::PropertyProxy_ReadOnly< PositionType > Gtk::Notebook::property_tab_pos ( ) const

Which side of the notebook holds the tabs.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_tab_vborder() [1/2]

Glib::PropertyProxy< guint > Gtk::Notebook::property_tab_vborder ( )

Width of the vertical border of tab labels.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_tab_vborder() [2/2]

Glib::PropertyProxy_ReadOnly< guint > Gtk::Notebook::property_tab_vborder ( ) const

Width of the vertical border of tab labels.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ query_tab_label_packing()

void Gtk::Notebook::query_tab_label_packing ( Widget child,
bool &  expand,
bool &  fill,
PackType pack_type 
)

◆ remove_page() [1/2]

void Gtk::Notebook::remove_page ( int  page_num = 0)

Removes a page from the notebook given its index in the notebook.

Parameters
page_numThe index of a notebook page, starting from 0. If -1, the last page will be removed.

◆ remove_page() [2/2]

void Gtk::Notebook::remove_page ( Widget child)

◆ reorder_child()

void Gtk::Notebook::reorder_child ( Widget child,
int  position 
)

Reorders the page containing child, so that it appears in position position. If position is greater than or equal to the number of children in the list or negative, child will be moved to the end of the list.

Parameters
childThe child to move.
positionThe new position, or -1 to move to the end.

◆ set_action_widget()

void Gtk::Notebook::set_action_widget ( Widget widget,
PackType  pack_type = PACK_START 
)

Sets widget as one of the action widgets. Depending on the pack type the widget will be placed before or after the tabs. You can use a Gtk::Box if you need to pack more than one widget on the same side.

Note that action widgets are "internal" children of the notebook and thus not included in the list returned from Gtk::Container::foreach().

Parameters
widgetA Gtk::Widget.
pack_typePack type of the action widget.

◆ set_current_page()

void Gtk::Notebook::set_current_page ( int  page_num)

Switches to the page number page_num.

Note that due to historical reasons, GtkNotebook refuses to switch to a page unless the child widget is visible. Therefore, it is recommended to show child widgets before adding them to a notebook.

Parameters
page_numIndex of the page to switch to, starting from 0. If negative, the last page will be used. If greater than the number of pages in the notebook, nothing will be done.

◆ set_group()

void Gtk::Notebook::set_group ( void *  group)

Sets a group identificator pointer for notebook, notebooks sharing the same group identificator pointer will be able to exchange tabs via drag and drop. A notebook with a 0 group identificator will not be able to exchange tabs with any other notebook.

Deprecated: 2.24: Use set_group_name() instead

Parameters
groupA pointer to identify the notebook group, or 0 to unset it.

◆ set_group_id()

void Gtk::Notebook::set_group_id ( int  group_id)

Sets an group identificator for notebook, notebooks sharing the same group identificator will be able to exchange tabs via drag and drop. A notebook with group identificator -1 will not be able to exchange tabs with any other notebook. Deprecated: 2.12: use set_group_name() instead.

Parameters
group_idA group identificator, or -1 to unset it.

◆ set_group_name()

void Gtk::Notebook::set_group_name ( const Glib::ustring &  group_name)

Sets a group name for notebook.

Notebooks with the same name will be able to exchange tabs via drag and drop. A notebook with a 0 group name will not be able to exchange tabs with any other notebook.

Parameters
group_nameThe name of the notebook group, or 0 to unset it.

◆ set_menu_label()

void Gtk::Notebook::set_menu_label ( Widget child,
Widget menu_label 
)

Changes the menu label for the page containing child.

Parameters
childThe child widget.
menu_labelThe menu label, or 0 for default.

◆ set_menu_label_text()

void Gtk::Notebook::set_menu_label_text ( Widget child,
const Glib::ustring &  menu_text 
)

Creates a new label and sets it as the menu label of child.

Parameters
childThe child widget.
menu_textThe label text.

◆ set_scrollable()

void Gtk::Notebook::set_scrollable ( bool  scrollable = true)

Sets whether the tab label area will have arrows for scrolling if there are too many tabs to fit in the area.

Parameters
scrollabletrue if scroll arrows should be added.

◆ set_show_border()

void Gtk::Notebook::set_show_border ( bool  show_border = true)

Sets whether a bevel will be drawn around the notebook pages. This only has a visual effect when the tabs are not shown. See set_show_tabs().

Parameters
show_bordertrue if a bevel should be drawn around the notebook.

◆ set_show_tabs()

void Gtk::Notebook::set_show_tabs ( bool  show_tabs = true)

Sets whether to show the tabs for the notebook or not.

Parameters
show_tabstrue if the tabs should be shown.

◆ set_tab_detachable()

void Gtk::Notebook::set_tab_detachable ( Widget child,
bool  detachable = true 
)

Sets whether the tab can be detached from notebook to another notebook or widget.

Note that 2 notebooks must share a common group identificator (see set_group_id()) to allow automatic tabs interchange between them.

If you want a widget to interact with a notebook through DnD (i.e.: accept dragged tabs from it) it must be set as a drop destination and accept the target "GTK_NOTEBOOK_TAB". The notebook will fill the selection with a GtkWidget** pointing to the child widget that corresponds to the dropped tab.

[C example ellipted]

If you want a notebook to accept drags from other widgets, you will have to set your own DnD code to do it.

Parameters
childA child Gtk::Widget.
detachableWhether the tab is detachable or not.

◆ set_tab_label()

void Gtk::Notebook::set_tab_label ( Widget child,
Widget tab_label 
)

Changes the tab label for child. If 0 is specified for tab_label, then the page will have the label 'page N'.

Parameters
childThe page.
tab_labelThe tab label widget to use, or 0 for default tab label.

◆ set_tab_label_packing()

void Gtk::Notebook::set_tab_label_packing ( Widget child,
bool  expand,
bool  fill,
PackType  pack_type 
)

Sets the packing parameters for the tab label of the page containing child. See Gtk::Box::pack_start() for the exact meaning of the parameters.

Deprecated: 2.20: Modify the Gtk::Notebook::property_tab_expand() and Gtk::Notebook::property_tab_fill() child properties instead. Modifying the packing of the tab label is a deprecated feature and shouldn't be done anymore.

Parameters
childThe child widget.
expandWhether to expand the tab label or not.
fillWhether the tab label should fill the allocated area or not.
pack_typeThe position of the tab label.

◆ set_tab_label_text()

void Gtk::Notebook::set_tab_label_text ( Widget child,
const Glib::ustring &  tab_text 
)

Creates a new label and sets it as the tab label for the page containing child.

Parameters
childThe page.
tab_textThe label text.

◆ set_tab_pos()

void Gtk::Notebook::set_tab_pos ( PositionType  pos)

Sets the edge at which the tabs for switching pages in the notebook are drawn.

Parameters
posThe edge to draw the tabs at.

◆ set_tab_reorderable()

void Gtk::Notebook::set_tab_reorderable ( Widget child,
bool  reorderable = true 
)

Sets whether the notebook tab can be reordered via drag and drop or not.

Parameters
childA child Gtk::Widget.
reorderableWhether the tab is reorderable or not.

◆ set_window_creation_hook()

static void Gtk::Notebook::set_window_creation_hook ( const SlotWindowCreation slot)
static

◆ signal_page_added()

Glib::SignalProxy2< void,Widget*,guint > Gtk::Notebook::signal_page_added ( )
Slot Prototype:
void on_my_page_added(Widget* page, guint page_num)

◆ signal_page_removed()

Glib::SignalProxy2< void,Widget*,guint > Gtk::Notebook::signal_page_removed ( )
Slot Prototype:
void on_my_page_removed(Widget* page, guint page_num)

◆ signal_page_reordered()

Glib::SignalProxy2< void,Widget*,guint > Gtk::Notebook::signal_page_reordered ( )
Slot Prototype:
void on_my_page_reordered(Widget* page, guint page_num)

◆ signal_switch_page()

Glib::SignalProxy2< void,GtkNotebookPage*,guint > Gtk::Notebook::signal_switch_page ( )
Slot Prototype:
void on_my_switch_page(GtkNotebookPage* page, guint page_num)

Friends And Related Function Documentation

◆ wrap()

Gtk::Notebook * wrap ( GtkNotebook object,
bool  take_copy = false 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file: