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

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/gtk-Graphics-Contexts.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
5
<title>Graphics Contexts</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
 
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
 
8
<link rel="up" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
9
<link rel="prev" href="gtk-Standard-Enumerations.html" title="Standard Enumerations">
 
10
<link rel="next" href="GtkStyle.html" title="Styles">
 
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
<link rel="part" href="gtk.html" title="Part&#160;I.&#160;GTK+ Overview">
 
14
<link rel="part" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
15
<link rel="part" href="gtkobjects.html" title="Part&#160;III.&#160;GTK+ Widgets and Objects">
 
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
 
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
 
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
 
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
 
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
 
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
 
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
 
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
 
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
 
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
 
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
 
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
 
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
 
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
 
30
<link rel="chapter" href="Printing.html" title="Printing">
 
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
 
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
 
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
 
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
 
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
 
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
 
37
<link rel="part" href="migrating.html" title="Part&#160;IV.&#160;Migrating from Previous Versions of GTK+">
 
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
 
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
 
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
 
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
 
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
 
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
 
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
 
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
 
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
 
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
 
48
<link rel="part" href="pt05.html" title="Part&#160;V.&#160;GTK+ Tools">
 
49
<link rel="glossary" href="glossary.html" title="Glossary">
 
50
<link rel="index" href="ix01.html" title="Index">
 
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
 
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
 
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
 
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
 
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
 
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
 
57
</head>
 
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
60
<tr valign="middle">
 
61
<td><a accesskey="p" href="gtk-Standard-Enumerations.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
62
<td><a accesskey="u" href="gtkbase.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
64
<th width="100%" align="center">GTK+ Reference Manual</th>
 
65
<td><a accesskey="n" href="GtkStyle.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
66
</tr>
 
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2755802" class="shortcut">Top</a>
 
68
                  &#160;|&#160;
 
69
                  <a href="#id2755887" class="shortcut">Description</a></nobr></td></tr>
 
70
</table>
 
71
<div class="refentry" lang="en">
 
72
<a name="gtk-Graphics-Contexts"></a><div class="titlepage"></div>
 
73
<div class="refnamediv"><table width="100%"><tr>
 
74
<td valign="top">
 
75
<h2>
 
76
<a name="id2755802"></a><span class="refentrytitle">Graphics Contexts</span>
 
77
</h2>
 
78
<p>Graphics Contexts &#8212; A shared pool of GdkGC objects</p>
 
79
</td>
 
80
<td valign="top" align="right"></td>
 
81
</tr></table></div>
 
82
<div class="refsynopsisdiv">
 
83
<h2>Synopsis</h2>
 
84
<pre class="synopsis">
 
85
 
 
86
#include &lt;gtk/gtk.h&gt;
 
87
 
 
88
 
 
89
<a
 
90
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
91
>GdkGC</a>*              <a href="gtk-Graphics-Contexts.html#gtk-gc-get">gtk_gc_get</a>                          (gint depth,
 
92
                                                         <a
 
93
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
94
>GdkColormap</a> *colormap,
 
95
                                                         <a
 
96
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValues"
 
97
>GdkGCValues</a> *values,
 
98
                                                         <a
 
99
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValuesMask"
 
100
>GdkGCValuesMask</a> values_mask);
 
101
void                <a href="gtk-Graphics-Contexts.html#gtk-gc-release">gtk_gc_release</a>                      (<a
 
102
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
103
>GdkGC</a> *gc);
 
104
</pre>
 
105
</div>
 
106
<div class="refsect1" lang="en">
 
107
<a name="id2755887"></a><h2>Description</h2>
 
108
<p>
 
109
These functions provide access to a shared pool of <a
 
110
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
111
><span class="type">GdkGC</span></a> objects.
 
112
When a new <a
 
113
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
114
><span class="type">GdkGC</span></a> is needed, <a href="gtk-Graphics-Contexts.html#gtk-gc-get"><code class="function">gtk_gc_get()</code></a> is called with the required depth,
 
115
colormap and <a
 
116
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValues"
 
117
><span class="type">GdkGCValues</span></a>. If a <a
 
118
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
119
><span class="type">GdkGC</span></a> with the required properties already
 
120
exists then that is returned. If not, a new <a
 
121
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
122
><span class="type">GdkGC</span></a> is created.
 
123
When the <a
 
124
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
125
><span class="type">GdkGC</span></a> is no longer needed, <a href="gtk-Graphics-Contexts.html#gtk-gc-release"><code class="function">gtk_gc_release()</code></a> should be called.
 
126
</p>
 
127
</div>
 
128
<div class="refsect1" lang="en">
 
129
<a name="id2755974"></a><h2>Details</h2>
 
130
<div class="refsect2" lang="en">
 
131
<a name="id2755984"></a><h3>
 
132
<a name="gtk-gc-get"></a>gtk_gc_get ()</h3>
 
133
<a class="indexterm" name="id2755997"></a><pre class="programlisting"><a
 
134
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
135
>GdkGC</a>*              gtk_gc_get                          (gint depth,
 
136
                                                         <a
 
137
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
138
>GdkColormap</a> *colormap,
 
139
                                                         <a
 
140
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValues"
 
141
>GdkGCValues</a> *values,
 
142
                                                         <a
 
143
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValuesMask"
 
144
>GdkGCValuesMask</a> values_mask);</pre>
 
145
<p>
 
146
Gets a <a
 
147
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
148
><span class="type">GdkGC</span></a> with the given depth, colormap and <a
 
149
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValues"
 
150
><span class="type">GdkGCValues</span></a>.
 
151
If a <a
 
152
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
153
><span class="type">GdkGC</span></a> with the given properties already exists then it is returned,
 
154
otherwise a new <a
 
155
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
156
><span class="type">GdkGC</span></a> is created.
 
157
The returned <a
 
158
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
159
><span class="type">GdkGC</span></a> should be released with <a href="gtk-Graphics-Contexts.html#gtk-gc-release"><code class="function">gtk_gc_release()</code></a> when it is no
 
160
longer needed.
 
161
</p>
 
162
<div class="variablelist"><table border="0">
 
163
<col align="left" valign="top">
 
164
<tbody>
 
165
<tr>
 
166
<td><span class="term"><em class="parameter"><code>depth</code></em>&#160;:</span></td>
 
167
<td>the depth of the <a
 
168
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
169
><span class="type">GdkGC</span></a> to create.
 
170
</td>
 
171
</tr>
 
172
<tr>
 
173
<td><span class="term"><em class="parameter"><code>colormap</code></em>&#160;:</span></td>
 
174
<td>the <a
 
175
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
176
><span class="type">GdkColormap</span></a> (FIXME: I don't know why this is needed).
 
177
</td>
 
178
</tr>
 
179
<tr>
 
180
<td><span class="term"><em class="parameter"><code>values</code></em>&#160;:</span></td>
 
181
<td>a <a
 
182
href="../gdk/gdk-Graphics-Contexts.html#GdkGCValues"
 
183
><span class="type">GdkGCValues</span></a> struct containing settings for the <a
 
184
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
185
><span class="type">GdkGC</span></a>.
 
186
</td>
 
187
</tr>
 
188
<tr>
 
189
<td><span class="term"><em class="parameter"><code>values_mask</code></em>&#160;:</span></td>
 
190
<td>a set of flags indicating which of the fields in <em class="parameter"><code>values</code></em> has
 
191
been set.
 
192
</td>
 
193
</tr>
 
194
<tr>
 
195
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
196
<td>a <a
 
197
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
198
><span class="type">GdkGC</span></a>.
 
199
 
 
200
 
 
201
</td>
 
202
</tr>
 
203
</tbody>
 
204
</table></div>
 
205
</div>
 
206
<hr>
 
207
<div class="refsect2" lang="en">
 
208
<a name="id2756220"></a><h3>
 
209
<a name="gtk-gc-release"></a>gtk_gc_release ()</h3>
 
210
<a class="indexterm" name="id2756233"></a><pre class="programlisting">void                gtk_gc_release                      (<a
 
211
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
212
>GdkGC</a> *gc);</pre>
 
213
<p>
 
214
Releases a <a
 
215
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
216
><span class="type">GdkGC</span></a> allocated using <a href="gtk-Graphics-Contexts.html#gtk-gc-get"><code class="function">gtk_gc_get()</code></a>.
 
217
</p>
 
218
<div class="variablelist"><table border="0">
 
219
<col align="left" valign="top">
 
220
<tbody><tr>
 
221
<td><span class="term"><em class="parameter"><code>gc</code></em>&#160;:</span></td>
 
222
<td>a <a
 
223
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
224
><span class="type">GdkGC</span></a>.
 
225
 
 
226
 
 
227
</td>
 
228
</tr></tbody>
 
229
</table></div>
 
230
</div>
 
231
</div>
 
232
</div>
 
233
</body>
 
234
</html>