1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkNotebook
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2000-12-11 17:47:24 +00:00
|
|
|
A tabbed notebook container.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
The #GtkNotebook widget is a #GtkContainer whose children are pages that
|
2000-12-11 17:47:24 +00:00
|
|
|
can be switched between using tab labels along one edge.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
There are many configuration options for #GtkNotebook. Among other
|
|
|
|
things, you can choose on which edge the tabs appear
|
|
|
|
(see gtk_notebook_set_tab_pos()), whether, if there are too many
|
|
|
|
tabs to fit the noteobook should be made bigger or scrolling
|
|
|
|
arrows added (see gtk_notebook_set_scrollable), and whether there
|
|
|
|
will be a popup menu allowing the users to switch pages.
|
|
|
|
(see gtk_notebook_enable_popup(), gtk_noteobook_disable_popup())
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<term>#GtkContainer</term>
|
|
|
|
<listitem><para>For functions that apply to every #GtkContainer
|
|
|
|
(like #GtkList).</para></listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkNotebook ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkNotebookPage ##### -->
|
|
|
|
<para>
|
2000-12-11 17:47:24 +00:00
|
|
|
The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_notebook_new ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_append_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@tab_label:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_append_page_menu ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@tab_label:
|
|
|
|
@menu_label:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_prepend_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child: the
|
|
|
|
@tab_label:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_prepend_page_menu ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
2001-01-09 16:41:17 +00:00
|
|
|
@tab_label:
|
|
|
|
@menu_label:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_insert_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@tab_label:
|
|
|
|
@position:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_insert_page_menu ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@tab_label:
|
2000-12-11 17:47:24 +00:00
|
|
|
@menu_label:
|
2001-01-09 16:41:17 +00:00
|
|
|
@position:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_remove_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
2001-01-09 16:41:17 +00:00
|
|
|
@page_num:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO gtk_notebook_current_page ##### -->
|
|
|
|
<para>
|
2001-08-23 15:26:49 +00:00
|
|
|
Deprecated compatibility macro.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_page_num ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_next_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_prev_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_reorder_child ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook
|
2001-01-09 16:41:17 +00:00
|
|
|
|
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@position:
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_pos ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@notebook: the notebook widget
|
|
|
|
@pos: the position
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_show_tabs ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@show_tabs:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_show_border ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@show_border:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_scrollable ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@scrollable:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_border ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@border_width:
|
1999-11-16 00:33:10 +00:00
|
|
|
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_notebook_popup_enable ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_popup_disable ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_get_current_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@notebook: the notebook widget
|
|
|
|
@Returns: the page number
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_get_menu_label ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_get_nth_page ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@page_num:
|
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_get_tab_label ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_query_tab_label_packing ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@expand:
|
|
|
|
@fill:
|
|
|
|
@pack_type:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_homogeneous_tabs ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@homogeneous:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_menu_label ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@menu_label:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_menu_label_text ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@menu_text:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
2000-09-07 18:17:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_hborder ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@tab_hborder:
|
2000-09-07 18:17:06 +00:00
|
|
|
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_label ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
2001-01-09 16:41:17 +00:00
|
|
|
@child:
|
|
|
|
@tab_label:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_label_packing ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
2001-01-09 16:41:17 +00:00
|
|
|
@expand:
|
2000-12-11 17:47:24 +00:00
|
|
|
@fill:
|
2001-01-09 16:41:17 +00:00
|
|
|
@pack_type:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_label_text ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2000-12-11 17:47:24 +00:00
|
|
|
@notebook:
|
|
|
|
@child:
|
|
|
|
@tab_text:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
2000-09-07 18:17:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_notebook_set_tab_vborder ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
@notebook:
|
|
|
|
@tab_vborder:
|
2000-09-07 18:17:06 +00:00
|
|
|
|
|
|
|
|
voc Pennington <hp@redhat.com>
* gtk/gtktextlayout.c (gtk_text_layout_move_iter_to_previous_line):
(gtk_text_layout_move_iter_to_next_line): fix these two for
invisible text, lots of other stuff still hosed.
* gtk/gtkcolorsel.c (gtk_color_selection_set_change_palette_hook):
new function, replaces the get/set palette stuff. This function
is intended for use by libgnomeui which should set the hook to a
thing which sets the palette in GConf, and we need the
GConf-to-xsettings proxy which will result in the change being
propagated back to the GTK app.
* gtk/gtkaccelgroup.c (gtk_accel_group_add): add note to warning
about unusable signals that it may be because the signal has
parameters.
* gtk/gtkwidget.c (gtk_widget_modify_style): always copy the
style, otherwise gtkrc.c won't know to create a new GtkStyle for
it.
(gtk_widget_modify_color_component): call
gtk_widget_modify_style() so the rc style will get copied.
(gtk_widget_modify_font): ditto
* gtk/gtkrc.c: make a couple variables static
* gtk/gtkcolorseldialog.c (gtk_color_selection_dialog_init): hide
help button by default, since it does nothing
* gtk/gtkcolorsel.c: add tooltips, work on key navigation, fool
around with UI
* gtk/gtkentry.c (gtk_entry_realize): request enter/leave notify
so we can have tooltips
* gtk/gtkhsv.c (gtk_hsv_realize): request enter/leave notify so we
can have tooltips
* gdk/gdkimage.h: mark gdk_image_new_bitmap with
GDK_ENABLE_BROKEN, because its memory behavior is completely
hosed.
* gtk/gtknotebook.c: remove key press handler, replace with
binding set, add numeric keypad support
* gtk/gtktextview.c (gtk_text_view_class_init): accept KP_Delete
* gtk/gtktext.c (gtk_text_key_press): add a bunch of KP keysyms
* gtk/gtkentry.c (gtk_entry_class_init): accept GDK_KP_Delete in
addition to plain Delete
* gtk/gtktextview.c (gtk_text_view_key_press_event): accept
GDK_KP_Enter in addition to GDK_Return
* gtk/gtkfontsel.c (gtk_font_selection_size_key_press): connect to
activate on entry instead of key press
(gtk_font_selection_on_clist_key_press): get
rid of this signal handler, not needed with new font sel.
* gtk/gtkfilesel.c (gtk_file_selection_key_press): remove a
no-longer-needed emit_stop_by_name(), just return TRUE
* gtk/gtkhscrollbar.c, gtk/gtkvscrollbar.c: remove keybindings
cruft, this widget is no longer focusable.
* gtk/gtkrange.h, gtk/gtkrange.c, gtk/gtkvscale.c,
gtk/gtkhscale.c: Get rid of trough_keys virtual function, add
move_slider action signal, add binding set for vscale/hscale, in
the process support numeric keypad
* gtk/gtkentry.c (gtk_entry_class_init): Add keypad bindings;
make GDK_Return and GDK_KP_Enter activate the entry via
binding set, instead of hardcoded.
2001-04-28 20:18:29 +00:00
|
|
|
<!-- ##### SIGNAL GtkNotebook::focus-tab ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@notebook: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkNotebook::select-page ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@notebook: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Emitted when the user or a function changes the current page.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
@notebook: the object which received the signal.
|
1999-11-16 00:33:10 +00:00
|
|
|
@page: the new current page
|
|
|
|
@page_num: the index of the page
|
1999-08-16 18:51:52 +00:00
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:tab-pos ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
The edge at which the tabs for switching pages are drawn.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:show-tabs ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
Whether to show tabs for the notebook pages.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:show-border ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
Whether to draw a bevel around the noteobook.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:scrollable ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
Whether the tab label area will have arrows for scrolling if there
|
|
|
|
are too many tabs to fit in the area.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:tab-border ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
Whether the tab labels have a border on all sides.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:tab-hborder ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
Whether the tab labels have a horizontal border.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:tab-vborder ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
Whether the tab labels have a vertical border.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-06-21 17:44:27 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:page ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2001-06-21 17:44:27 +00:00
|
|
|
The current page
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:enable-popup ##### -->
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
2000-12-11 17:47:24 +00:00
|
|
|
Whether the popup menu for switching pages is enabled.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-07 18:17:06 +00:00
|
|
|
<!-- ##### ARG GtkNotebook:homogeneous ##### -->
|
|
|
|
<para>
|
2000-12-11 17:47:24 +00:00
|
|
|
whether the tabs must have all the same size.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|