docs: gtk_menu_attach_to_widget()

Add a few more clues about why this is useful,
based on
https://mail.gnome.org/archives/gtk-devel-list/2007-November/msg00176.html
and the reference to it from gtk_menu_new_from_model().
This commit is contained in:
Murray Cumming 2013-07-22 14:08:11 +02:00
parent 8488ae6d78
commit 9ea08fae04

View File

@ -1206,6 +1206,11 @@ attach_widget_screen_changed (GtkWidget *attach_widget,
* Attaches the menu to the widget and provides a callback function
* that will be invoked when the menu calls gtk_menu_detach() during
* its destruction.
*
* If the menu is attached to the widget then it will be destroyed
* when the widget is destroyed, as if it was a child widget.
* An attached menu will also move between screens correctly if the
* widgets moves between screens.
*/
void
gtk_menu_attach_to_widget (GtkMenu *menu,