callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages 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: * GtkSizeGroup:ignore-hidden:
* *
* If %TRUE, unmapped widgets are ignored when determining * If %TRUE, unmapped widgets are ignored when determining
* the size of the group. * the size of the group.
* *
* 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.
*/ */
g_object_class_install_property (gobject_class, g_object_class_install_property (gobject_class,
PROP_IGNORE_HIDDEN, PROP_IGNORE_HIDDEN,
@ -247,7 +254,7 @@ gtk_size_group_class_init (GtkSizeGroupClass *klass)
P_("If TRUE, unmapped widgets are ignored " P_("If TRUE, unmapped widgets are ignored "
"when determining the size of the group"), "when determining the size of the group"),
FALSE, FALSE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY|G_PARAM_DEPRECATED));
} }
static void static void
@ -389,11 +396,18 @@ gtk_size_group_get_mode (GtkSizeGroup *size_group)
* @size_group: a #GtkSizeGroup * @size_group: a #GtkSizeGroup
* @ignore_hidden: whether unmapped widgets should be ignored * @ignore_hidden: whether unmapped widgets should be ignored
* when calculating the size * when calculating the size
* *
* Sets whether unmapped widgets should be ignored when * Sets whether unmapped widgets should be ignored when
* calculating the size. * 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 void
gtk_size_group_set_ignore_hidden (GtkSizeGroup *size_group, 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. * Returns: %TRUE if invisible widgets are ignored.
* *
* 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.
*/ */
gboolean gboolean
gtk_size_group_get_ignore_hidden (GtkSizeGroup *size_group) 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); GtkSizeGroupMode mode);
GDK_AVAILABLE_IN_ALL GDK_AVAILABLE_IN_ALL
GtkSizeGroupMode gtk_size_group_get_mode (GtkSizeGroup *size_group); 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, void gtk_size_group_set_ignore_hidden (GtkSizeGroup *size_group,
gboolean ignore_hidden); gboolean ignore_hidden);
GDK_AVAILABLE_IN_ALL GDK_DEPRECATED_IN_3_22
gboolean gtk_size_group_get_ignore_hidden (GtkSizeGroup *size_group); gboolean gtk_size_group_get_ignore_hidden (GtkSizeGroup *size_group);
GDK_AVAILABLE_IN_ALL GDK_AVAILABLE_IN_ALL
void gtk_size_group_add_widget (GtkSizeGroup *size_group, void gtk_size_group_add_widget (GtkSizeGroup *size_group,