Expand the docs for GtkWindow::attached-to

This commit is contained in:
Matthias Clasen 2012-01-12 20:39:48 -05:00
parent 27f6441bb2
commit 46ee761c0d

View File

@ -972,7 +972,13 @@ gtk_window_class_init (GtkWindowClass *klass)
/**
* GtkWindow:attached-to:
*
* the widget attached to the window.
* The widget to which this window is attached.
* See gtk_window_set_attached_to().
*
* Examples of places where specifying this relation is useful are
* for instance a #GtkMenu created by a #GtkComboBox, a completion
* popup window created by #GtkEntry or a typeahead search entry
* created by #GtkTreeView.
*
* Since: 3.4
*/
@ -2618,7 +2624,7 @@ gtk_window_get_transient_for (GtkWindow *window)
* @attach_widget (allow-none): a #GtkWidget, or %NULL
*
* Marks @window as attached to @attach_widget. This creates a logical binding
* between the window and the widget it belongs to, which is used by GTK to
* between the window and the widget it belongs to, which is used by GTK+ to
* propagate information such as styling or accessibility to @window as if it
* was a children of @attach_widget.
*
@ -2627,7 +2633,7 @@ gtk_window_get_transient_for (GtkWindow *window)
* created by #GtkEntry or a typeahead search entry created by #GtkTreeView.
*
* Note that this function should not be confused with
* #gtk_window_set_transient_for, which specifies a window manager relation
* gtk_window_set_transient_for(), which specifies a window manager relation
* between two toplevels instead.
*
* Passing %NULL for @attach_widget detaches the window.