AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-05 16:20:10 +00:00
Code Issues Projects Releases Wiki Activity

container: clarify the docs

Browse Source 
Hightlight more that focus_child is a container internal thing and suggest
what application developers most likely were looking for instead.
This commit is contained in:
Stefan Kost 2010-08-20 13:55:41 +03:00
parent d945a3cef4
commit 076ae4f5ad
1 changed files with 8 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
gtk/gtkcontainer.c
View File

@ -1600,6 +1600,9 @@ gtk_container_foreach_full (GtkContainer *container,
* This function emits the GtkContainer::set_focus_child signal of
* @container. Implementations of #GtkContainer can override the
* default behaviour by overriding the class closure of this signal.
*
* This is function is mostly meant to be used by widgets. Applications can use
* gtk_widget_grab_focus() to manualy set the focus to a specific widget.
*/
void
gtk_container_set_focus_child (GtkContainer *container,
@ -1616,10 +1619,12 @@ gtk_container_set_focus_child (GtkContainer *container,
* gtk_container_get_focus_child:
* @container: a #GtkContainer
*
* Returns the current focus child widget inside @container.
* Returns the current focus child widget inside @container. This is not the
* currently focused widget. That can be obtained by calling
* gtk_window_get_focus().
*
* Returns: The child widget which has the focus
* inside @container, or %NULL if none is set.
* Returns: The child widget which will recieve the focus inside @container when
* the @conatiner is focussed, or %NULL if none is set.
*
* Since: 2.14
**/