AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2025-01-04 17:50:18 +00:00
Code Issues Projects Releases Wiki Activity

Document GtkSizeGroup::ignore-hidden as broken

Browse Source 
...and deprecate it, recommending GtkStack as an alternative.
This commit is contained in:
Matthias Clasen 2016-05-31 16:19:52 -04:00
parent 69f8b4bb77
commit d76c07836b
2 changed files with 27 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
gtk/gtksizegroup.c
View File

@ -235,10 +235,17 @@ gtk_size_group_class_init (GtkSizeGroupClass *klass)
/**
* GtkSizeGroup:ignore-hidden:
*
* If %TRUE, unmapped widgets are ignored when determining
* If %TRUE, unmapped widgets are ignored when determining
* the size of the group.
*
* Since: 2.8
*
* Deprecated: 3.22: Measuring the size of hidden widgets has not worked
* reliably for a long time. In most cases, they will report a size
* of 0 nowadays, and thus, their size will not affect the other
* size group members. In effect, size groups will always operate
* as if this property was %TRUE. Use a #GtkStack instead to hide
* widgets while still having their size taken into account.
*/
g_object_class_install_property (gobject_class,
PROP_IGNORE_HIDDEN,
@ -247,7 +254,7 @@ gtk_size_group_class_init (GtkSizeGroupClass *klass)
P_("If TRUE, unmapped widgets are ignored "
"when determining the size of the group"),
FALSE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY|G_PARAM_DEPRECATED));
}
static void
@ -389,11 +396,18 @@ gtk_size_group_get_mode (GtkSizeGroup *size_group)
* @size_group: a #GtkSizeGroup
* @ignore_hidden: whether unmapped widgets should be ignored
* when calculating the size
*
*
* Sets whether unmapped widgets should be ignored when
* calculating the size.
*
* Since: 2.8
* Since: 2.8
*
* Deprecated: 3.22: Measuring the size of hidden widgets has not worked
* reliably for a long time. In most cases, they will report a size
* of 0 nowadays, and thus, their size will not affect the other
* size group members. In effect, size groups will always operate
* as if this property was %TRUE. Use a #GtkStack instead to hide
* widgets while still having their size taken into account.
*/
void
gtk_size_group_set_ignore_hidden (GtkSizeGroup *size_group,
@ -424,6 +438,13 @@ gtk_size_group_set_ignore_hidden (GtkSizeGroup *size_group,
* Returns: %TRUE if invisible widgets are ignored.
*
* Since: 2.8
*
* Deprecated: 3.22: Measuring the size of hidden widgets has not worked
* reliably for a long time. In most cases, they will report a size
* of 0 nowadays, and thus, their size will not affect the other
* size group members. In effect, size groups will always operate
* as if this property was %TRUE. Use a #GtkStack instead to hide
* widgets while still having their size taken into account.
*/
gboolean
gtk_size_group_get_ignore_hidden (GtkSizeGroup *size_group)

4
gtk/gtksizegroup.h
View File

@ -68,10 +68,10 @@ void gtk_size_group_set_mode (GtkSizeGroup *size_group,
GtkSizeGroupMode mode);
GDK_AVAILABLE_IN_ALL
GtkSizeGroupMode gtk_size_group_get_mode (GtkSizeGroup *size_group);
GDK_AVAILABLE_IN_ALL
GDK_DEPRECATED_IN_3_22
void gtk_size_group_set_ignore_hidden (GtkSizeGroup *size_group,
gboolean ignore_hidden);
GDK_AVAILABLE_IN_ALL
GDK_DEPRECATED_IN_3_22
gboolean gtk_size_group_get_ignore_hidden (GtkSizeGroup *size_group);
GDK_AVAILABLE_IN_ALL
void gtk_size_group_add_widget (GtkSizeGroup *size_group,