← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-Pango-Interaction.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-06-02 15:59:27 UTC
  • mfrom: (72.1.15 experimental)
  • Revision ID: james.westby@ubuntu.com-20100602155927-uwh99v2582rw3r8z
Tags: 2.21.1-1ubuntu1
https://launchpad.net/bugs/558841
* debian/patches/070_mandatory-relibtoolize.patch:
  - refreshed
* debian/patches/072_indicator_menu_update.patch:
  - change by Cody Russell to send an update event on menu changes,
    should make the bluetooth indicator refresh correctly (lp: #558841)
* debian/patches/091_bugzilla_tooltip_refresh.patch:
  - refreshed

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gdk/html/gdk-Pango-Interaction.html
8
8
<link rel="up" href="reference.html" title="API Reference">
9
9
<link rel="prev" href="gdk-Input-Devices.html" title="Input Devices">
10
10
<link rel="next" href="gdk-Cairo-Interaction.html" title="Cairo Interaction">
11
 
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
46
46
 
47
47
                    <a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer-struct" title="GdkPangoRenderer">GdkPangoRenderer</a>;
48
48
                    <a class="link" href="gdk-Pango-Interaction.html#GdkPangoRendererClass" title="GdkPangoRendererClass">GdkPangoRendererClass</a>;
49
 
<a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="returnvalue">PangoRenderer</span></a> *     <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-new" title="gdk_pango_renderer_new ()">gdk_pango_renderer_new</a>              (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
50
 
<a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="returnvalue">PangoRenderer</span></a> *     <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()">gdk_pango_renderer_get_default</a>      (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
49
<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="returnvalue">PangoRenderer</span></a> *     <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-new" title="gdk_pango_renderer_new ()">gdk_pango_renderer_new</a>              (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
50
<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="returnvalue">PangoRenderer</span></a> *     <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()">gdk_pango_renderer_get_default</a>      (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
51
51
<span class="returnvalue">void</span>                <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-drawable" title="gdk_pango_renderer_set_drawable ()">gdk_pango_renderer_set_drawable</a>     (<em class="parameter"><code><a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> *gdk_renderer</code></em>,
52
52
                                                         <em class="parameter"><code><a class="link" href="gdk-Drawing-Primitives.html#GdkDrawable"><span class="type">GdkDrawable</span></a> *drawable</code></em>);
53
53
<span class="returnvalue">void</span>                <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-gc" title="gdk_pango_renderer_set_gc ()">gdk_pango_renderer_set_gc</a>           (<em class="parameter"><code><a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> *gdk_renderer</code></em>,
54
54
                                                         <em class="parameter"><code><a class="link" href="gdk-Graphics-Contexts.html#GdkGC"><span class="type">GdkGC</span></a> *gc</code></em>);
55
55
<span class="returnvalue">void</span>                <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-stipple" title="gdk_pango_renderer_set_stipple ()">gdk_pango_renderer_set_stipple</a>      (<em class="parameter"><code><a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> *gdk_renderer</code></em>,
56
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
 
56
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
57
57
                                                         <em class="parameter"><code><a class="link" href="gdk-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap"><span class="type">GdkBitmap</span></a> *stipple</code></em>);
58
58
<span class="returnvalue">void</span>                <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-override-color" title="gdk_pango_renderer_set_override_color ()">gdk_pango_renderer_set_override_color</a>
59
59
                                                        (<em class="parameter"><code><a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> *gdk_renderer</code></em>,
60
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
 
60
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
61
61
                                                         <em class="parameter"><code>const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);
62
62
<a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *      <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-context-get" title="gdk_pango_context_get ()">gdk_pango_context_get</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
63
63
<a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> *      <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-context-get-for-screen" title="gdk_pango_context_get_for_screen ()">gdk_pango_context_get_for_screen</a>    (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
86
86
<a name="gdk-Pango-Interaction.object-hierarchy"></a><h2>Object Hierarchy</h2>
87
87
<pre class="synopsis">
88
88
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
89
 
   +----<a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html">PangoRenderer</a>
 
89
   +----<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a>
90
90
         +----GdkPangoRenderer
91
91
</pre>
92
92
</div>
107
107
<p>
108
108
Creating a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> object is the first step in rendering text,
109
109
and requires getting a handle to a <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>. For GTK+ programs,
110
 
you'll usually want to use <a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>, or
111
 
<a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-create-pango-layout"><code class="function">gtk_widget_create_pango_layout()</code></a>, rather than using the lowlevel
 
110
you'll usually want to use <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>, or
 
111
<a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#gtk-widget-create-pango-layout"><code class="function">gtk_widget_create_pango_layout()</code></a>, rather than using the lowlevel
112
112
<a class="link" href="gdk-Pango-Interaction.html#gdk-pango-context-get-for-screen" title="gdk_pango_context_get_for_screen ()"><code class="function">gdk_pango_context_get_for_screen()</code></a>. Once you have a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>, you
113
113
can set the text and attributes of it with Pango functions like
114
114
<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-text"><code class="function">pango_layout_set_text()</code></a> and get its size with <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-size"><code class="function">pango_layout_get_size()</code></a>.
118
118
<p>
119
119
Rendering a Pango layout is done most simply with <a class="link" href="gdk-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a>;
120
120
you can also draw pieces of the layout with <a class="link" href="gdk-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a> or
121
 
<a class="link" href="gdk-Drawing-Primitives.html#gdk-draw-glyphs" title="gdk_draw_glyphs ()"><code class="function">gdk_draw_glyphs()</code></a>. <a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> is a subclass of <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="type">PangoRenderer</span></a>
 
121
<a class="link" href="gdk-Drawing-Primitives.html#gdk-draw-glyphs" title="gdk_draw_glyphs ()"><code class="function">gdk_draw_glyphs()</code></a>. <a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> is a subclass of <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a>
122
122
that is used internally to implement these functions. Using it
123
123
directly or subclassing it can be useful in some cases. See the
124
124
<a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> documentation for details.
197
197
<span class="preproc">#define</span><span class="normal"> N_WORDS </span><span class="number">10</span>
198
198
<span class="preproc">#define</span><span class="normal"> FONT </span><span class="string">"Sans Bold 18"</span>
199
199
<span class="normal"><a href="GdkScreen.html">GdkScreen</a> </span><span class="symbol">*</span><span class="normal">screen </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-Drawing-Primitives.html#gdk-drawable-get-screen">gdk_drawable_get_screen</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">drawable</span><span class="symbol">);</span>
200
 
<span class="normal"><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html">PangoRenderer</a> </span><span class="symbol">*</span><span class="normal">renderer</span><span class="symbol">;</span>
 
200
<span class="normal"><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> </span><span class="symbol">*</span><span class="normal">renderer</span><span class="symbol">;</span>
201
201
<span class="normal"><a href="gdk-Graphics-Contexts.html#GdkGC">GdkGC</a> </span><span class="symbol">*</span><span class="normal">gc</span><span class="symbol">;</span>
202
202
<span class="normal"><a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> matrix </span><span class="symbol">=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-MATRIX-INIT:CAPS">PANGO_MATRIX_INIT</a></span><span class="symbol">;</span>
203
203
<span class="normal"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">;</span>
239
239
<span class="normal">    color</span><span class="symbol">.</span><span class="normal">green </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
240
240
<span class="normal">    color</span><span class="symbol">.</span><span class="normal">blue  </span><span class="symbol">=</span><span class="normal"> </span><span class="number">65535</span><span class="normal">  </span><span class="symbol">-</span><span class="normal"> color</span><span class="symbol">.</span><span class="normal">red</span><span class="symbol">;</span>
241
241
<span class="normal">    </span><span class="function"><a href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-override-color">gdk_pango_renderer_set_override_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDK_PANGO_RENDERER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">renderer</span><span class="symbol">),</span>
242
 
<span class="normal">                                           <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#PANGO-RENDER-PART-FOREGROUND:CAPS">PANGO_RENDER_PART_FOREGROUND</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
 
242
<span class="normal">                                           <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PANGO-RENDER-PART-FOREGROUND:CAPS">PANGO_RENDER_PART_FOREGROUND</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
243
243
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#pango-matrix-rotate">pango_matrix_rotate</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">rotated_matrix</span><span class="symbol">,</span><span class="normal"> angle</span><span class="symbol">);</span>
244
244
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#pango-context-set-matrix">pango_context_set_matrix</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">rotated_matrix</span><span class="symbol">);</span>
245
245
<span class="normal">    </span><span class="comment">/* Inform Pango to re-layout the text with the new transformation matrix */</span>
246
246
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-context-changed">pango_layout_context_changed</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">);</span>
247
247
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-size">pango_layout_get_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">height</span><span class="symbol">);</span>
248
 
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#pango-renderer-draw-layout">pango_renderer_draw_layout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">renderer</span><span class="symbol">,</span><span class="normal"> layout</span><span class="symbol">,</span>
 
248
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-layout">pango_renderer_draw_layout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">renderer</span><span class="symbol">,</span><span class="normal"> layout</span><span class="symbol">,</span>
249
249
<span class="normal">                                </span><span class="symbol">-</span><span class="normal"> width </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="normal"> RADIUS </span><span class="symbol">*</span><span class="normal"> <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS">PANGO_SCALE</a></span><span class="symbol">);</span>
250
250
<span class="normal">  </span><span class="cbracket">}</span>
251
251
<span class="comment">/* Clean up default renderer, since it is shared */</span>
252
252
<span class="function"><a href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-override-color">gdk_pango_renderer_set_override_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDK_PANGO_RENDERER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">renderer</span><span class="symbol">),</span>
253
 
<span class="normal">                                       <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#PANGO-RENDER-PART-FOREGROUND:CAPS">PANGO_RENDER_PART_FOREGROUND</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
253
<span class="normal">                                       <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PANGO-RENDER-PART-FOREGROUND:CAPS">PANGO_RENDER_PART_FOREGROUND</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
254
254
<span class="function"><a href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-drawable">gdk_pango_renderer_set_drawable</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDK_PANGO_RENDERER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">renderer</span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
255
255
<span class="function"><a href="gdk-Pango-Interaction.html#gdk-pango-renderer-set-gc">gdk_pango_renderer_set_gc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDK_PANGO_RENDERER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">renderer</span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
256
256
<span class="comment">/* free the objects we created */</span>
264
264
 
265
265
</div>
266
266
<br class="example-break"><div class="figure">
267
 
<a name="id474138"></a><p class="title"><b>Figure 1. Output of <a class="xref" href="gdk-Pango-Interaction.html#rotated-example" title="Example 8. Using GdkPangoRenderer to draw transformed text">Example 8, “Using <span class="type">GdkPangoRenderer</span> to draw transformed text”</a></b></p>
 
267
<a name="id620285"></a><p class="title"><b>Figure 1. Output of <a class="xref" href="gdk-Pango-Interaction.html#rotated-example" title="Example 8. Using GdkPangoRenderer to draw transformed text">Example 8, “Using <span class="type">GdkPangoRenderer</span> to draw transformed text”</a></b></p>
268
268
<div class="figure-contents"><div><img src="rotated-text.png" alt="Output of"></div></div>
269
269
</div>
270
270
<br class="figure-break">
275
275
<a name="GdkPangoRenderer-struct"></a><h3>GdkPangoRenderer</h3>
276
276
<pre class="programlisting">typedef struct _GdkPangoRenderer GdkPangoRenderer;</pre>
277
277
<p>
278
 
<a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> is a subclass of <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="type">PangoRenderer</span></a> used for rendering
 
278
<a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> is a subclass of <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> used for rendering
279
279
Pango objects into GDK drawables. The default renderer for a particular
280
280
screen is obtained with <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()"><code class="function">gdk_pango_renderer_get_default()</code></a>; Pango
281
 
functions like <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#pango-renderer-draw-layout"><code class="function">pango_renderer_draw_layout()</code></a> and
282
 
<a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#pango-renderer-draw-layout-line"><code class="function">pango_renderer_draw_layout_line()</code></a> are then used to draw objects with
 
281
functions like <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-layout"><code class="function">pango_renderer_draw_layout()</code></a> and
 
282
<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-layout-line"><code class="function">pango_renderer_draw_layout_line()</code></a> are then used to draw objects with
283
283
the renderer.
284
284
</p>
285
285
<p>
312
312
<hr>
313
313
<div class="refsect2" title="gdk_pango_renderer_new ()">
314
314
<a name="gdk-pango-renderer-new"></a><h3>gdk_pango_renderer_new ()</h3>
315
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="returnvalue">PangoRenderer</span></a> *     gdk_pango_renderer_new              (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
315
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="returnvalue">PangoRenderer</span></a> *     gdk_pango_renderer_new              (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
316
316
<p>
317
 
Creates a new <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="type">PangoRenderer</span></a> for <em class="parameter"><code>screen</code></em>. Normally you can use the
 
317
Creates a new <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> for <em class="parameter"><code>screen</code></em>. Normally you can use the
318
318
results of <a class="link" href="gdk-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()"><code class="function">gdk_pango_renderer_get_default()</code></a> rather than creating a new
319
319
renderer.
320
320
</p>
328
328
</tr>
329
329
<tr>
330
330
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
331
 
<td> a newly created <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="type">PangoRenderer</span></a>. Free with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.
 
331
<td> a newly created <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a>. Free with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.
332
332
 
333
333
</td>
334
334
</tr>
339
339
<hr>
340
340
<div class="refsect2" title="gdk_pango_renderer_get_default ()">
341
341
<a name="gdk-pango-renderer-get-default"></a><h3>gdk_pango_renderer_get_default ()</h3>
342
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="returnvalue">PangoRenderer</span></a> *     gdk_pango_renderer_get_default      (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
342
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="returnvalue">PangoRenderer</span></a> *     gdk_pango_renderer_get_default      (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
343
343
<p>
344
 
Gets the default <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="type">PangoRenderer</span></a> for a screen. This default renderer
 
344
Gets the default <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> for a screen. This default renderer
345
345
is shared by all users of the display, so properties such as the color
346
346
or transformation matrix set for the renderer may be overwritten
347
347
by functions such as <a class="link" href="gdk-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a>.
361
361
</tr>
362
362
<tr>
363
363
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
364
 
<td> the default <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html"><span class="type">PangoRenderer</span></a> for <em class="parameter"><code>screen</code></em>. The
 
364
<td> the default <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> for <em class="parameter"><code>screen</code></em>. The
365
365
 renderer is owned by GTK+ and will be kept around until the
366
366
 screen is closed.
367
367
 
389
389
</tr>
390
390
<tr>
391
391
<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td>
392
 
<td> the new target drawable, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
 
392
<td> the new target drawable, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
393
</td>
393
394
</tr>
394
395
</tbody>
395
396
</table></div>
417
418
</tr>
418
419
<tr>
419
420
<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
420
 
<td> the new GC to use for drawing, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
 
421
<td> the new GC to use for drawing, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
422
</td>
421
423
</tr>
422
424
</tbody>
423
425
</table></div>
427
429
<div class="refsect2" title="gdk_pango_renderer_set_stipple ()">
428
430
<a name="gdk-pango-renderer-set-stipple"></a><h3>gdk_pango_renderer_set_stipple ()</h3>
429
431
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_pango_renderer_set_stipple      (<em class="parameter"><code><a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> *gdk_renderer</code></em>,
430
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
 
432
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
431
433
                                                         <em class="parameter"><code><a class="link" href="gdk-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap"><span class="type">GdkBitmap</span></a> *stipple</code></em>);</pre>
432
434
<p>
433
435
Sets the stipple for one render part (foreground, background, underline,
434
436
etc.) Note that this is overwritten when iterating through the individual
435
437
styled runs of a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> or <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>. This function is thus
436
 
only useful when you call low level functions like <a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#pango-renderer-draw-glyphs"><code class="function">pango_renderer_draw_glyphs()</code></a>
 
438
only useful when you call low level functions like <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-glyphs"><code class="function">pango_renderer_draw_glyphs()</code></a>
437
439
directly, or in the 'prepare_run' virtual function of a subclass of
438
440
<a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a>.
439
441
</p>
464
466
<a name="gdk-pango-renderer-set-override-color"></a><h3>gdk_pango_renderer_set_override_color ()</h3>
465
467
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_pango_renderer_set_override_color
466
468
                                                        (<em class="parameter"><code><a class="link" href="gdk-Pango-Interaction.html#GdkPangoRenderer"><span class="type">GdkPangoRenderer</span></a> *gdk_renderer</code></em>,
467
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/PangoRenderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
 
469
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
468
470
                                                         <em class="parameter"><code>const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
469
471
<p>
470
472
Sets the color for a particular render part (foreground,
487
489
<tr>
488
490
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
489
491
<td> the color to use, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset a previously
490
 
        set override color.. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
 
492
        set override color. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
493
</td>
491
494
</tr>
492
495
</tbody>
493
496
</table></div>
504
507
The context must be freed when you're finished with it.
505
508
</p>
506
509
<p>
507
 
When using GTK+, normally you should use <a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
 
510
When using GTK+, normally you should use <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
508
511
instead of this function, to get the appropriate context for
509
512
the widget you intend to render text onto.
510
513
</p>
511
514
<p>
512
515
The newly created context will have the default font options (see
513
516
<a href="/usr/share/gtk-doc/html/cairo/cairo-font-options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>) for the default screen; if these options
514
 
change it will not be updated. Using <a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
 
517
change it will not be updated. Using <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
515
518
is more convenient if you want to keep a context around and track
516
519
changes to the screen's font rendering settings.
517
520
</p>
535
538
The context must be freed when you're finished with it.
536
539
</p>
537
540
<p>
538
 
When using GTK+, normally you should use <a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
 
541
When using GTK+, normally you should use <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
539
542
instead of this function, to get the appropriate context for
540
543
the widget you intend to render text onto.
541
544
</p>
542
545
<p>
543
546
The newly created context will have the default font options
544
547
(see <a href="/usr/share/gtk-doc/html/cairo/cairo-font-options.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>) for the screen; if these options
545
 
change it will not be updated. Using <a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
 
548
change it will not be updated. Using <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>
546
549
is more convenient if you want to keep a context around and track
547
550
changes to the screen's font rendering settings.
548
551
</p>
880
883
</div>
881
884
<div class="footer">
882
885
<hr>
883
 
          Generated by GTK-Doc V1.14</div>
 
886
          Generated by GTK-Doc V1.15</div>
884
887
</body>
885
888
</html>
 
 
b'\\ No newline at end of file'