[gtk+/gtk-3-22] CellRendererPixbuf: Improve property docs
- From: Daniel Boles <dboles src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+/gtk-3-22] CellRendererPixbuf: Improve property docs
- Date: Wed, 22 Nov 2017 21:33:22 +0000 (UTC)
commit f1b812731dc187e84c587d89e319e1e081285401
Author: Daniel Boles <dboles src gnome org>
Date: Wed Nov 22 18:57:48 2017 +0000
CellRendererPixbuf: Improve property docs
Add Since annotations for the stock-* properties.
Add a doc comment for :stock-size in order to link to GtkIconSize.
Document :stock-detail as deprecated. It does nothing & is gone in GTK+4
gtk/gtkcellrendererpixbuf.c | 16 ++++++++++++++++
1 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkcellrendererpixbuf.c b/gtk/gtkcellrendererpixbuf.c
index 30dcc1b..85eab79 100644
--- a/gtk/gtkcellrendererpixbuf.c
+++ b/gtk/gtkcellrendererpixbuf.c
@@ -185,6 +185,8 @@ gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class)
/**
* GtkCellRendererPixbuf:stock-id:
*
+ * Since: 2.2
+ *
* Deprecated: 3.10: Use #GtkCellRendererPixbuf:icon-name instead.
*/
g_object_class_install_property (object_class,
@@ -195,6 +197,13 @@ gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class)
NULL,
GTK_PARAM_READWRITE | G_PARAM_DEPRECATED));
+ /**
+ * GtkCellRendererPixbuf:stock-size:
+ *
+ * The #GtkIconSize value that specifies the size of the rendered icon.
+ *
+ * Since: 2.2
+ */
g_object_class_install_property (object_class,
PROP_STOCK_SIZE,
g_param_spec_uint ("stock-size",
@@ -205,6 +214,13 @@ gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class)
GTK_ICON_SIZE_MENU,
GTK_PARAM_READWRITE));
+ /*
+ * GtkCellRendererPixbuf:stock-detail:
+ *
+ * Since: 2.2
+ *
+ * Deprecated: 3.22: This property does nothing. Use CSS to theme widgets.
+ */
g_object_class_install_property (object_class,
PROP_STOCK_DETAIL,
g_param_spec_string ("stock-detail",
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]