1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GtkCellRendererAccel</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="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
9
<link rel="prev" href="GtkCellEditable.html" title="GtkCellEditable">
10
<link rel="next" href="GtkCellRendererCombo.html" title="GtkCellRendererCombo">
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 I. GTK+ Overview">
14
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
15
<link rel="part" href="gtkobjects.html" title="Part III. 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 IV. 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 V. 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">
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">
61
<td><a accesskey="p" href="GtkCellEditable.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
62
<td><a accesskey="u" href="TreeWidgetObjects.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="GtkCellRendererCombo.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3286372" class="shortcut">Top</a>
69
<a href="#id3286599" class="shortcut">Description</a>
71
<a href="#id3286420" class="shortcut">Object Hierarchy</a>
73
<a href="#id3286475" class="shortcut">Properties</a>
75
<a href="#id3286560" class="shortcut">Signals</a></nobr></td></tr>
77
<div class="refentry" lang="en">
78
<a name="GtkCellRendererAccel"></a><div class="titlepage"></div>
79
<div class="refnamediv"><table width="100%"><tr>
82
<a name="id3286372"></a><span class="refentrytitle">GtkCellRendererAccel</span>
84
<p>GtkCellRendererAccel — Renders a keyboard accelerator in a cell</p>
86
<td valign="top" align="right"></td>
88
<div class="refsynopsisdiv">
90
<pre class="synopsis">
92
#include <gtk/gtk.h>
95
<a href="GtkCellRendererAccel.html#GtkCellRendererAccel-struct">GtkCellRendererAccel</a>;
96
enum <a href="GtkCellRendererAccel.html#GtkCellRendererAccelMode">GtkCellRendererAccelMode</a>;
97
<a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>* <a href="GtkCellRendererAccel.html#gtk-cell-renderer-accel-new">gtk_cell_renderer_accel_new</a> (void);
102
<div class="refsect1" lang="en">
103
<a name="id3286420"></a><h2>Object Hierarchy</h2>
104
<pre class="synopsis">
107
+----GInitiallyUnowned
108
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
109
+----<a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>
110
+----<a href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a>
111
+----GtkCellRendererAccel
114
<div class="refsect1" lang="en">
115
<a name="id3286475"></a><h2>Properties</h2>
116
<pre class="synopsis">
118
"<a href="GtkCellRendererAccel.html#GtkCellRendererAccel--accel-key">accel-key</a>" guint : Read / Write
119
"<a href="GtkCellRendererAccel.html#GtkCellRendererAccel--accel-mode">accel-mode</a>" <a href="GtkCellRendererAccel.html#GtkCellRendererAccelMode">GtkCellRendererAccelMode</a> : Read / Write
120
"<a href="GtkCellRendererAccel.html#GtkCellRendererAccel--accel-mods">accel-mods</a>" <a
121
href="../gdk/gdk-Windows.html#GdkModifierType"
122
>GdkModifierType</a> : Read / Write
123
"<a href="GtkCellRendererAccel.html#GtkCellRendererAccel--keycode">keycode</a>" guint : Read / Write
126
<div class="refsect1" lang="en">
127
<a name="id3286560"></a><h2>Signals</h2>
128
<pre class="synopsis">
130
"<a href="GtkCellRendererAccel.html#GtkCellRendererAccel-accel-cleared">accel-cleared</a>" : Run Last
131
"<a href="GtkCellRendererAccel.html#GtkCellRendererAccel-accel-edited">accel-edited</a>" : Run Last
134
<div class="refsect1" lang="en">
135
<a name="id3286599"></a><h2>Description</h2>
137
<a href="GtkCellRendererAccel.html" title="GtkCellRendererAccel"><span class="type">GtkCellRendererAccel</span></a> displays a keyboard accelerator (i.e. a
138
key combination like <Control>-a). If the cell renderer is editable, the
139
accelerator can be changed by simply typing the new combination.
142
The <a href="GtkCellRendererAccel.html" title="GtkCellRendererAccel"><span class="type">GtkCellRendererAccel</span></a> cell renderer was added in GTK+ 2.10.
145
<div class="refsect1" lang="en">
146
<a name="id3286643"></a><h2>Details</h2>
147
<div class="refsect2" lang="en">
148
<a name="id3286654"></a><h3>
149
<a name="GtkCellRendererAccel-struct"></a>GtkCellRendererAccel</h3>
150
<a class="indexterm" name="id3286667"></a><pre class="programlisting">typedef struct _GtkCellRendererAccel GtkCellRendererAccel;</pre>
156
<div class="refsect2" lang="en">
157
<a name="id3286683"></a><h3>
158
<a name="GtkCellRendererAccelMode"></a>enum GtkCellRendererAccelMode</h3>
159
<a class="indexterm" name="id3286696"></a><pre class="programlisting">typedef enum
161
GTK_CELL_RENDERER_ACCEL_MODE_GTK,
162
GTK_CELL_RENDERER_ACCEL_MODE_OTHER
163
} GtkCellRendererAccelMode;
170
<div class="refsect2" lang="en">
171
<a name="id3286712"></a><h3>
172
<a name="gtk-cell-renderer-accel-new"></a>gtk_cell_renderer_accel_new ()</h3>
173
<a class="indexterm" name="id3286729"></a><pre class="programlisting"><a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>* gtk_cell_renderer_accel_new (void);</pre>
175
Creates a new <a href="GtkCellRendererAccel.html" title="GtkCellRendererAccel"><span class="type">GtkCellRendererAccel</span></a>.</p>
179
<div class="variablelist"><table border="0">
180
<col align="left" valign="top">
182
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
183
<td> the new cell renderer
188
<p class="since">Since 2.10
192
<div class="refsect1" lang="en">
193
<a name="id3286785"></a><h2>Property Details</h2>
194
<div class="refsect2" lang="en">
195
<a name="id3286796"></a><h3>
196
<a name="GtkCellRendererAccel--accel-key"></a>The "<code class="literal">accel-key</code>" property</h3>
197
<a class="indexterm" name="id3286812"></a><pre class="programlisting"> "accel-key" guint : Read / Write</pre>
199
The keyval of the accelerator.</p>
203
<p>Allowed values: <= G_MAXINT</p>
204
<p>Default value: 0</p>
209
<div class="refsect2" lang="en">
210
<a name="id3286852"></a><h3>
211
<a name="GtkCellRendererAccel--accel-mode"></a>The "<code class="literal">accel-mode</code>" property</h3>
212
<a class="indexterm" name="id3286869"></a><pre class="programlisting"> "accel-mode" <a href="GtkCellRendererAccel.html#GtkCellRendererAccelMode">GtkCellRendererAccelMode</a> : Read / Write</pre>
214
Determines if the edited accelerators are GTK+ accelerators. If
215
they are, consumed modifiers are suppressed, only accelerators
216
accepted by GTK+ are allowed, and the accelerators are rendered
217
in the same way as they are in menus.</p>
221
<p>Default value: GTK_CELL_RENDERER_ACCEL_MODE_GTK</p>
226
<div class="refsect2" lang="en">
227
<a name="id3286909"></a><h3>
228
<a name="GtkCellRendererAccel--accel-mods"></a>The "<code class="literal">accel-mods</code>" property</h3>
229
<a class="indexterm" name="id3286926"></a><pre class="programlisting"> "accel-mods" <a
230
href="../gdk/gdk-Windows.html#GdkModifierType"
231
>GdkModifierType</a> : Read / Write</pre>
233
The modifier mask of the accelerator.</p>
241
<div class="refsect2" lang="en">
242
<a name="id3286958"></a><h3>
243
<a name="GtkCellRendererAccel--keycode"></a>The "<code class="literal">keycode</code>" property</h3>
244
<a class="indexterm" name="id3286974"></a><pre class="programlisting"> "keycode" guint : Read / Write</pre>
246
The hardware keycode of the accelerator. Note that the hardware keycode is
247
only relevant if the key does not have a keyval. Normally, the keyboard
248
configuration should assign keyvals to all keys.</p>
252
<p>Allowed values: <= G_MAXINT</p>
253
<p>Default value: 0</p>
258
<div class="refsect1" lang="en">
259
<a name="id3287018"></a><h2>Signal Details</h2>
260
<div class="refsect2" lang="en">
261
<a name="id3287028"></a><h3>
262
<a name="GtkCellRendererAccel-accel-cleared"></a>The "accel-cleared" signal</h3>
263
<a class="indexterm" name="id3287040"></a><pre class="programlisting">void user_function (<a href="GtkCellRendererAccel.html" title="GtkCellRendererAccel">GtkCellRendererAccel</a> *accel,
265
gpointer user_data) : Run Last</pre>
267
Gets emitted when the user has removed the accelerator.</p>
271
<div class="variablelist"><table border="0">
272
<col align="left" valign="top">
275
<td><span class="term"><em class="parameter"><code>accel</code></em> :</span></td>
276
<td> the object reveiving the signal
280
<td><span class="term"><em class="parameter"><code>path_string</code></em> :</span></td>
281
<td> the path identifying the row of the edited cell
285
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
286
<td>user data set when the signal handler was connected.</td>
294
<div class="refsect2" lang="en">
295
<a name="id3287140"></a><h3>
296
<a name="GtkCellRendererAccel-accel-edited"></a>The "accel-edited" signal</h3>
297
<a class="indexterm" name="id3287151"></a><pre class="programlisting">void user_function (<a href="GtkCellRendererAccel.html" title="GtkCellRendererAccel">GtkCellRendererAccel</a> *accel,
301
href="../gdk/gdk-Windows.html#GdkModifierType"
302
>GdkModifierType</a> accel_mods,
303
guint hardware_keycode,
304
gpointer user_data) : Run Last</pre>
306
Gets emitted when the user has selected a new accelerator.</p>
310
<div class="variablelist"><table border="0">
311
<col align="left" valign="top">
314
<td><span class="term"><em class="parameter"><code>accel</code></em> :</span></td>
315
<td> the object reveiving the signal
319
<td><span class="term"><em class="parameter"><code>path_string</code></em> :</span></td>
320
<td> the path identifying the row of the edited cell
324
<td><span class="term"><em class="parameter"><code>accel_key</code></em> :</span></td>
325
<td> the new accelerator keyval
329
<td><span class="term"><em class="parameter"><code>accel_mods</code></em> :</span></td>
330
<td> the new acclerator modifier mask
334
<td><span class="term"><em class="parameter"><code>hardware_keycode</code></em> :</span></td>
335
<td> the keycode of the new accelerator
339
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
340
<td>user data set when the signal handler was connected.</td>