From 0f98b1509075b56d9742a3df4c32f8c453342da0 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 23 Nov 2010 23:16:22 -0500
Subject: [PATCH] Add illustration to gtk_render_handle docs

---
 docs/reference/gtk/Makefile.am        |   1 +
 docs/reference/gtk/images/handles.png | Bin 0 -> 660 bytes
 gtk/gtkstylecontext.c                 |   5 +++++
 tests/styleexamples.c                 |  27 ++++++++++++++++++++++++++
 4 files changed, 33 insertions(+)
 create mode 100644 docs/reference/gtk/images/handles.png

diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 23194b77aa..42d23fc1c1 100644
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -351,6 +351,7 @@ HTML_IMAGES = \
 	$(srcdir)/images/frame-gap.png					\
 	$(srcdir)/images/sliders.png					\
 	$(srcdir)/images/focus.png					\
+	$(srcdir)/images/handles.png					\
 	$(srcdir)/images/extensions.png
 
 # Extra options to supply to gtkdoc-fixref
diff --git a/docs/reference/gtk/images/handles.png b/docs/reference/gtk/images/handles.png
new file mode 100644
index 0000000000000000000000000000000000000000..24151b559b0cbe752b6802fdb8b04a5c8f8497c8
GIT binary patch
literal 660
zcmV;F0&D$=P)<h;3K|Lk000e1NJLTq002G!002h_0ssI2(2ipo00003b3#c}2nYz<
z;ZNWI000?uMObuGZ)S9NVRB^vXKrt8Wi4}Ka%E+1b7*gL?*qR+0006fNkl<ZXo2mR
zOH1oO6vt<30v+4LSL*{^iJKydUqBRGxDnj>Aq4$6Ze6%^C0s6dbA6yI7b2pFDCk1)
zQMKBtiA^)(B2Xl))2YpLMm@h(4jhJGhVxG*!KWvO7-RGeiK!O&I-srsP*;I=>Vrd>
z!J*8~_6B2&->IECLTF`qiTZxcHmuuo9b-%>4KDbdMpJz1fH5Yxl{yZLAlj)zOjQ6e
z)f?^9A*L#TnCgvo>JU>E{Nk8~22Nht2%pY+XyD|PA;j;k`mBcrPF`76ePwyc_x<sS
zDgNX@OrrzdrYeB9sR|&bdZV2>#8d?kQ@sIo6@a=5e!9Bry0SegF$|O6P+Q$~o&CMt
z$H!bmN<t8l=;%zDCeL1I*GX&Q_~@W%_JkxD!hhCQ^Z6%ETWxjAvS()JdV2etV;^{L
z{{QRyC4OgZb<gweZm%b&rkh}2_NJ6(hDQl$<unToOfGkyy^(Go@=m3?`Te3Xy}G)T
zY9I3M>l^6oN=Ft`dG?jw2*)ChsSNw7-Xbw=SzMUspN}b}Ua>elGIp1}y*NLM6B5I*
za%tIZ@i>XxJ18y7Zb%&=R4RGJx9IKp-tFxjd@&()8TJi&qq>e?j`I=>deX9wj}9Il
zvL8#wc@<yEG|fcP+FJh?h^EusNy{#mBHri=pVfw8K0g;2V}y{(vaWRsg*-y2yw1l`
u1nvF^i1X9W>v{s}DgbpAfVv7mT?Ox-QzE>+3j`qm0000<MNUMnLSTYkkS-bk

literal 0
HcmV?d00001

diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index 9c59552314..2c863fa422 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -3421,6 +3421,11 @@ gtk_render_extension (GtkStyleContext *context,
  * #GtkWindow<!-- -->'s resize grip), in the rectangle
  * determined by @x, @y, @width, @height.
  *
+ * <example>
+ * <title>Handles rendered for the paned and grip classes</title>
+ * <inlinegraphic fileref="handles.png" format="PNG"/>
+ * </example>
+ *
  * Since: 3.0
  **/
 void
diff --git a/tests/styleexamples.c b/tests/styleexamples.c
index b20c7e4eea..75350ddd2d 100644
--- a/tests/styleexamples.c
+++ b/tests/styleexamples.c
@@ -297,6 +297,31 @@ draw_cb_frame_gap (GtkWidget *widget, cairo_t *cr)
   return TRUE;
 }
 
+static gboolean
+draw_cb_handles (GtkWidget *widget, cairo_t *cr)
+{
+  GtkStyleContext *context;
+
+  context = gtk_widget_get_style_context (widget);
+  gtk_style_context_save (context);
+
+  gtk_style_context_add_class (context, "paned");
+  gtk_render_handle (context, cr, 12, 22, 20, 10);
+  gtk_render_handle (context, cr, 44, 12, 10, 20);
+  gtk_style_context_remove_class (context, "paned");
+
+  gtk_style_context_add_class (context, "grip");
+  gtk_style_context_set_junction_sides (context, GTK_JUNCTION_CORNER_BOTTOMLEFT);
+  gtk_render_handle (context, cr, 12, 48, 12, 12);
+
+  gtk_style_context_set_junction_sides (context, GTK_JUNCTION_CORNER_BOTTOMRIGHT);
+  gtk_render_handle (context, cr, 40, 48, 12, 12);
+
+  gtk_style_context_restore (context);
+
+  return TRUE;
+}
+
 static char *what;
 
 static gboolean
@@ -324,6 +349,8 @@ draw_cb (GtkWidget *widget, cairo_t *cr)
     return draw_cb_extension (widget, cr);
   else if (strcmp (what, "frame-gap") == 0)
     return draw_cb_frame_gap (widget, cr);
+  else if (strcmp (what, "handle") == 0)
+    return draw_cb_handles (widget, cr);
 
   return FALSE;
 }