1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
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="AbstractObjects.html" title="Abstract Base Classes">
9
<link rel="prev" href="GtkContainer.html" title="GtkContainer">
10
<link rel="next" href="GtkMisc.html" title="GtkMisc">
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="GtkContainer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
62
<td><a accesskey="u" href="AbstractObjects.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="GtkMisc.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="#id3711708" class="shortcut">Top</a>
69
<a href="#id3711949" class="shortcut">Description</a>
71
<a href="#id3711795" class="shortcut">Object Hierarchy</a>
73
<a href="#id3711878" class="shortcut">Implemented Interfaces</a>
75
<a href="#id3711901" class="shortcut">Signals</a></nobr></td></tr>
77
<div class="refentry" lang="en">
78
<a name="GtkItem"></a><div class="titlepage"></div>
79
<div class="refnamediv"><table width="100%"><tr>
82
<a name="id3711708"></a><span class="refentrytitle">GtkItem</span>
84
<p>GtkItem — Abstract base class for GtkMenuItem, GtkListItem and GtkTreeItem</p>
86
<td valign="top" align="right"></td>
88
<div class="refsynopsisdiv">
90
<pre class="synopsis">
92
#include <gtk/gtk.h>
95
<a href="GtkItem.html#GtkItem-struct">GtkItem</a>;
96
void <a href="GtkItem.html#gtk-item-select">gtk_item_select</a> (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item);
97
void <a href="GtkItem.html#gtk-item-deselect">gtk_item_deselect</a> (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item);
98
void <a href="GtkItem.html#gtk-item-toggle">gtk_item_toggle</a> (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item);
103
<div class="refsect1" lang="en">
104
<a name="id3711795"></a><h2>Object Hierarchy</h2>
105
<pre class="synopsis">
108
+----GInitiallyUnowned
109
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
110
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
111
+----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
112
+----<a href="GtkBin.html" title="GtkBin">GtkBin</a>
114
+----<a href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>
115
+----<a href="GtkListItem.html" title="GtkListItem">GtkListItem</a>
116
+----<a href="GtkTreeItem.html" title="GtkTreeItem">GtkTreeItem</a>
119
<div class="refsect1" lang="en">
120
<a name="id3711878"></a><h2>Implemented Interfaces</h2>
123
AtkImplementorIface.</p>
125
<div class="refsect1" lang="en">
126
<a name="id3711901"></a><h2>Signals</h2>
127
<pre class="synopsis">
129
"<a href="GtkItem.html#GtkItem-deselect">deselect</a>" : Run First
130
"<a href="GtkItem.html#GtkItem-select">select</a>" : Run First
131
"<a href="GtkItem.html#GtkItem-toggle">toggle</a>" : Run First
134
<div class="refsect1" lang="en">
135
<a name="id3711949"></a><h2>Description</h2>
137
The <a href="GtkItem.html" title="GtkItem"><span class="type">GtkItem</span></a> widget is an abstract base class for <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>, <a href="GtkListItem.html" title="GtkListItem"><span class="type">GtkListItem</span></a>
138
and <a href="GtkTreeItem.html" title="GtkTreeItem"><span class="type">GtkTreeItem</span></a>.
141
<div class="refsect1" lang="en">
142
<a name="id3711995"></a><h2>Details</h2>
143
<div class="refsect2" lang="en">
144
<a name="id3712006"></a><h3>
145
<a name="GtkItem-struct"></a>GtkItem</h3>
146
<a class="indexterm" name="id3712019"></a><pre class="programlisting">typedef struct _GtkItem GtkItem;</pre>
148
The <a href="GtkItem.html#GtkItem-struct"><span class="type">GtkItem</span></a> struct contains private data only, and
149
should be accessed using the functions below.
153
<div class="refsect2" lang="en">
154
<a name="id3712044"></a><h3>
155
<a name="gtk-item-select"></a>gtk_item_select ()</h3>
156
<a class="indexterm" name="id3712056"></a><pre class="programlisting">void gtk_item_select (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item);</pre>
158
Emits the "select" signal on the given item.
160
<div class="variablelist"><table border="0">
161
<col align="left" valign="top">
163
<td><span class="term"><em class="parameter"><code>item</code></em> :</span></td>
164
<td>a <a href="GtkItem.html" title="GtkItem"><span class="type">GtkItem</span></a>.
172
<div class="refsect2" lang="en">
173
<a name="id3712111"></a><h3>
174
<a name="gtk-item-deselect"></a>gtk_item_deselect ()</h3>
175
<a class="indexterm" name="id3712125"></a><pre class="programlisting">void gtk_item_deselect (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item);</pre>
177
Emits the "deselect" signal on the given item.
179
<div class="variablelist"><table border="0">
180
<col align="left" valign="top">
182
<td><span class="term"><em class="parameter"><code>item</code></em> :</span></td>
183
<td>a <a href="GtkItem.html" title="GtkItem"><span class="type">GtkItem</span></a>.
191
<div class="refsect2" lang="en">
192
<a name="id3712180"></a><h3>
193
<a name="gtk-item-toggle"></a>gtk_item_toggle ()</h3>
194
<a class="indexterm" name="id3712192"></a><pre class="programlisting">void gtk_item_toggle (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item);</pre>
196
Emits the "toggle" signal on the given item.
198
<div class="variablelist"><table border="0">
199
<col align="left" valign="top">
201
<td><span class="term"><em class="parameter"><code>item</code></em> :</span></td>
202
<td>a <a href="GtkItem.html" title="GtkItem"><span class="type">GtkItem</span></a>.
210
<div class="refsect1" lang="en">
211
<a name="id3712249"></a><h2>Signal Details</h2>
212
<div class="refsect2" lang="en">
213
<a name="id3712259"></a><h3>
214
<a name="GtkItem-deselect"></a>The "deselect" signal</h3>
215
<a class="indexterm" name="id3712269"></a><pre class="programlisting">void user_function (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item,
216
gpointer user_data) : Run First</pre>
218
Emitted when the item is deselected.
220
<div class="variablelist"><table border="0">
221
<col align="left" valign="top">
224
<td><span class="term"><em class="parameter"><code>item</code></em> :</span></td>
225
<td>the object which received the signal.
230
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
231
<td>user data set when the signal handler was connected.</td>
237
<div class="refsect2" lang="en">
238
<a name="id3712338"></a><h3>
239
<a name="GtkItem-select"></a>The "select" signal</h3>
240
<a class="indexterm" name="id3712349"></a><pre class="programlisting">void user_function (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item,
241
gpointer user_data) : Run First</pre>
243
Emitted when the item is selected.
245
<div class="variablelist"><table border="0">
246
<col align="left" valign="top">
249
<td><span class="term"><em class="parameter"><code>item</code></em> :</span></td>
250
<td>the object which received the signal.
255
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
256
<td>user data set when the signal handler was connected.</td>
262
<div class="refsect2" lang="en">
263
<a name="id3712418"></a><h3>
264
<a name="GtkItem-toggle"></a>The "toggle" signal</h3>
265
<a class="indexterm" name="id3712427"></a><pre class="programlisting">void user_function (<a href="GtkItem.html" title="GtkItem">GtkItem</a> *item,
266
gpointer user_data) : Run First</pre>
268
Emitted when the item is toggled.
270
<div class="variablelist"><table border="0">
271
<col align="left" valign="top">
274
<td><span class="term"><em class="parameter"><code>item</code></em> :</span></td>
275
<td>the object which received the signal.
280
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
281
<td>user data set when the signal handler was connected.</td>