From 6f1d9d471f2c79c00cf8023bf824b4480c92823c Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 10 Feb 2004 01:04:35 +0000 Subject: [PATCH] Document these functions. Tue Feb 10 01:58:55 2004 Matthias Clasen * gtk/gtkcontainer.c (gtk_container_set_focus_hadjustment): * gtk/gtkcontainer.c (gtk_container_set_focus_vadjustment): Document these functions. --- ChangeLog | 6 ++++++ ChangeLog.pre-2-10 | 6 ++++++ ChangeLog.pre-2-4 | 6 ++++++ ChangeLog.pre-2-6 | 6 ++++++ ChangeLog.pre-2-8 | 6 ++++++ gtk/gtkcontainer.c | 30 ++++++++++++++++++++++++++++++ 6 files changed, 60 insertions(+) diff --git a/ChangeLog b/ChangeLog index 5c01bd20a6..d57db3acb9 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Tue Feb 10 01:58:55 2004 Matthias Clasen + + * gtk/gtkcontainer.c (gtk_container_set_focus_hadjustment): + * gtk/gtkcontainer.c (gtk_container_set_focus_vadjustment): Document + these functions. + 2004-02-09 Federico Mena Quintero * gtk/gtkfilechooserdefault.c (set_list_model): Request diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 5c01bd20a6..d57db3acb9 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,9 @@ +Tue Feb 10 01:58:55 2004 Matthias Clasen + + * gtk/gtkcontainer.c (gtk_container_set_focus_hadjustment): + * gtk/gtkcontainer.c (gtk_container_set_focus_vadjustment): Document + these functions. + 2004-02-09 Federico Mena Quintero * gtk/gtkfilechooserdefault.c (set_list_model): Request diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 5c01bd20a6..d57db3acb9 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,9 @@ +Tue Feb 10 01:58:55 2004 Matthias Clasen + + * gtk/gtkcontainer.c (gtk_container_set_focus_hadjustment): + * gtk/gtkcontainer.c (gtk_container_set_focus_vadjustment): Document + these functions. + 2004-02-09 Federico Mena Quintero * gtk/gtkfilechooserdefault.c (set_list_model): Request diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 5c01bd20a6..d57db3acb9 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,9 @@ +Tue Feb 10 01:58:55 2004 Matthias Clasen + + * gtk/gtkcontainer.c (gtk_container_set_focus_hadjustment): + * gtk/gtkcontainer.c (gtk_container_set_focus_vadjustment): Document + these functions. + 2004-02-09 Federico Mena Quintero * gtk/gtkfilechooserdefault.c (set_list_model): Request diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 5c01bd20a6..d57db3acb9 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,9 @@ +Tue Feb 10 01:58:55 2004 Matthias Clasen + + * gtk/gtkcontainer.c (gtk_container_set_focus_hadjustment): + * gtk/gtkcontainer.c (gtk_container_set_focus_vadjustment): Document + these functions. + 2004-02-09 Federico Mena Quintero * gtk/gtkfilechooserdefault.c (set_list_model): Request diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c index 91f3e88abf..77f18568f4 100644 --- a/gtk/gtkcontainer.c +++ b/gtk/gtkcontainer.c @@ -2190,6 +2190,21 @@ gtk_container_unset_focus_chain (GtkContainer *container) } } +/** + * gtk_container_set_focus_vadjustment: + * @container: a #GtkContainer + * @adjustment: an adjustment which should be adjusted when the focus is moved among the + * descendents of @container + * + * Hooks up an adjustment to focus handling in a container, so when a child of the + * container is focused, the adjustment is scrolled to show that widget. This function + * sets the vertical alignment. See gtk_scrolled_window_get_vadjustment() for a typical + * way of obtaining the adjustment and gtk_container_set_focus_hadjustment() for setting + * the horizontal adjustment. + * + * The adjustments have to be in pixel units and in the same coordinate system as the + * allocation for immediate children of the container. + */ void gtk_container_set_focus_vadjustment (GtkContainer *container, GtkAdjustment *adjustment) @@ -2229,6 +2244,21 @@ gtk_container_get_focus_vadjustment (GtkContainer *container) return vadjustment; } +/** + * gtk_container_set_focus_hadjustment: + * @container: a #GtkContainer + * @adjustment: an adjustment which should be adjusted when the focus is moved among the + * descendents of @container + * + * Hooks up an adjustment to focus handling in a container, so when a child of the + * container is focused, the adjustment is scrolled to show that widget. This function + * sets the horizontal alignment. See gtk_scrolled_window_get_hadjustment() for a typical + * way of obtaining the adjustment and gtk_container_set_focus_vadjustment() for setting + * the vertical adjustment. + * + * The adjustments have to be in pixel units and in the same coordinate system as the + * allocation for immediate children of the container. + */ void gtk_container_set_focus_hadjustment (GtkContainer *container, GtkAdjustment *adjustment)