2.9.0

[~andy/gtk] / docs / reference / gtk / tmpl / gtknotebook.sgml

diff --git a/docs/reference/gtk/tmpl/gtknotebook.sgml b/docs/reference/gtk/tmpl/gtknotebook.sgml
index 69bb71491477f38c382bb9976f47df178e40fa25..8dc524e2f184a4ca87e4b87c5d0ce10b17de6f66 100644 (file)
--- a/docs/reference/gtk/tmpl/gtknotebook.sgml
+++ b/docs/reference/gtk/tmpl/gtknotebook.sgml
@@ -2,7 +2,7 @@
 GtkNotebook
 
 <!-- ##### SECTION Short_Description ##### -->
-A tabbed notebook container.
+A tabbed notebook container
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -30,12 +30,222 @@ will be a popup menu allowing the users to switch pages.
 </variablelist>
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### STRUCT GtkNotebook ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### SIGNAL GtkNotebook::change-current-page ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::focus-tab ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@Returns: 
+
+<!-- ##### SIGNAL GtkNotebook::move-focus-out ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::page-added ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@widget: 
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::page-removed ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@widget: 
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::page-reordered ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@widget: 
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::reorder-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: 
+@Returns: 
+
+<!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
+<para>
+Emitted when the user or a function changes the current page.
+</para>
+
+@notebook: the object which received the signal.
+@page: the new current page
+@page_num: the index of the page
+
+<!-- ##### ARG GtkNotebook:enable-popup ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:group-id ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:homogeneous ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:page ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:scrollable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:show-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:show-tabs ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-hborder ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-pos ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-vborder ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:detachable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:menu-label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:reorderable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-expand ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-fill ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-pack ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-backward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-forward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-secondary-backward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-secondary-forward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-curvature ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-overlap ##### -->
+<para>
+
+</para>
+
 <!-- ##### STRUCT GtkNotebookPage ##### -->
 <para>
 The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
@@ -56,6 +266,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
 @notebook: 
 @child: 
 @tab_label: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_notebook_append_page_menu ##### -->
@@ -66,6 +277,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
 @child: 
 @tab_label: 
 @menu_label: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_notebook_prepend_page ##### -->
@@ -75,6 +287,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
 @notebook: 
 @child: the
 @tab_label: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_notebook_prepend_page_menu ##### -->
@@ -85,6 +298,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
 @child: 
 @tab_label: 
 @menu_label: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_notebook_insert_page ##### -->
@@ -95,6 +309,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
 @child: 
 @tab_label: 
 @position: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_notebook_insert_page_menu ##### -->
@@ -106,6 +321,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
 @tab_label: 
 @menu_label: 
 @position: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_notebook_remove_page ##### -->
@@ -344,35 +560,37 @@ gtk_notebook_set_current_page() instead.
 @tab_vborder: 
 
 
-<!-- ##### FUNCTION gtk_notebook_get_menu_label_text ##### -->
+<!-- ##### FUNCTION gtk_notebook_set_tab_reorderable ##### -->
 <para>
 
 </para>
 
 @notebook: 
 @child: 
-@Returns: 
+@reorderable: 
 
 
-<!-- ##### FUNCTION gtk_notebook_get_scrollable ##### -->
+<!-- ##### FUNCTION gtk_notebook_set_tab_detachable ##### -->
 <para>
 
 </para>
 
 @notebook: 
-@Returns: 
+@child: 
+@detachable: 
 
 
-<!-- ##### FUNCTION gtk_notebook_get_show_border ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_menu_label_text ##### -->
 <para>
 
 </para>
 
 @notebook: 
+@child: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_notebook_get_show_tabs ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_scrollable ##### -->
 <para>
 
 </para>
@@ -381,17 +599,16 @@ gtk_notebook_set_current_page() instead.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_notebook_get_tab_label_text ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_show_border ##### -->
 <para>
 
 </para>
 
 @notebook: 
-@child: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_notebook_get_tab_pos ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_show_tabs ##### -->
 <para>
 
 </para>
@@ -400,157 +617,97 @@ gtk_notebook_set_current_page() instead.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_notebook_set_current_page ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_tab_label_text ##### -->
 <para>
 
 </para>
 
 @notebook: 
-@page_num: 
-
-
-<!-- ##### SIGNAL GtkNotebook::change-current-page ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1: 
-<!-- # Unused Parameters # -->
-@Returns: 
-
-<!-- ##### SIGNAL GtkNotebook::focus-tab ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1: 
+@child: 
 @Returns: 
 
-<!-- ##### SIGNAL GtkNotebook::move-focus-out ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1: 
 
-<!-- ##### SIGNAL GtkNotebook::select-page ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_tab_pos ##### -->
 <para>
 
 </para>
 
-@notebook: the object which received the signal.
-@arg1: 
+@notebook: 
 @Returns: 
 
-<!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
-<para>
-Emitted when the user or a function changes the current page.
-</para>
-
-@notebook: the object which received the signal.
-@page: the new current page
-@page_num: the index of the page
 
-<!-- ##### ARG GtkNotebook:enable-popup ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:homogeneous ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_tab_reorderable ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkNotebook:page ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:scrollable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:show-border ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:show-tabs ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-border ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-hborder ##### -->
-<para>
+@notebook: 
+@child: 
+@Returns: 
 
-</para>
 
-<!-- ##### ARG GtkNotebook:tab-pos ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_tab_detachable ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkNotebook:tab-vborder ##### -->
-<para>
+@notebook: 
+@child: 
+@Returns: 
 
-</para>
 
-<!-- ##### ARG GtkNotebook:menu-label ##### -->
+<!-- ##### FUNCTION gtk_notebook_set_current_page ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkNotebook:position ##### -->
-<para>
+@notebook: 
+@page_num: 
 
-</para>
 
-<!-- ##### ARG GtkNotebook:tab-expand ##### -->
+<!-- ##### FUNCTION gtk_notebook_set_group_id ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkNotebook:tab-fill ##### -->
-<para>
+@notebook: 
+@group_id: 
 
-</para>
 
-<!-- ##### ARG GtkNotebook:tab-label ##### -->
+<!-- ##### FUNCTION gtk_notebook_get_group_id ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkNotebook:tab-pack ##### -->
-<para>
+@notebook: 
+@Returns: 
 
-</para>
 
-<!-- ##### ARG GtkNotebook:has-backward-stepper ##### -->
+<!-- ##### USER_FUNCTION GtkNotebookWindowCreationFunc ##### -->
 <para>
+A function used by GtkNotebook when a detachable tab is dropped
+in the root window, it's used to create a window containing a notebook
+where the tab will be attached. This function will also be responsible
+of moving/resizing the window and adding the necessary properties to
+the notebook (i.e.: group-id).
 
+If the function returns %NULL, the drag will be cancelled.
 </para>
 
-<!-- ##### ARG GtkNotebook:has-forward-stepper ##### -->
-<para>
+@source: The source #GtkNotebook of the drag operation
+@page: the child #GtkWidget affected
+@x: the X coordinate where the drop happens
+@y: the Y coordinate where the drop happens
+@data: user data
+@Returns: The created #GtkNotebook where the tab will be attached, or NULL to cancel the drag
 
-</para>
 
-<!-- ##### ARG GtkNotebook:has-secondary-backward-stepper ##### -->
+<!-- ##### FUNCTION gtk_notebook_set_window_creation_hook ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkNotebook:has-secondary-forward-stepper ##### -->
-<para>
+@func: 
+@data: 
 
-</para>