← 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/gtk/html/GtkRadioMenuItem.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:
docs/reference/gtk/html/GtkRadioMenuItem.html
 
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>GtkRadioMenuItem</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="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
 
9
<link rel="prev" href="GtkImageMenuItem.html" title="GtkImageMenuItem">
 
10
<link rel="next" href="GtkCheckMenuItem.html" title="GtkCheckMenuItem">
 
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="GtkImageMenuItem.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
62
<td><a accesskey="u" href="MenusAndCombos.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="GtkCheckMenuItem.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="#id3362400" class="shortcut">Top</a>
 
68
                  &#160;|&#160;
 
69
                  <a href="#id3362834" class="shortcut">Description</a>
 
70
                  &#160;|&#160;
 
71
                  <a href="#id3362664" class="shortcut">Object Hierarchy</a>
 
72
                  &#160;|&#160;
 
73
                  <a href="#id3362749" class="shortcut">Implemented Interfaces</a>
 
74
                  &#160;|&#160;
 
75
                  <a href="#id3362772" class="shortcut">Properties</a>
 
76
                  &#160;|&#160;
 
77
                  <a href="#id3362806" class="shortcut">Signals</a></nobr></td></tr>
 
78
</table>
 
79
<div class="refentry" lang="en">
 
80
<a name="GtkRadioMenuItem"></a><div class="titlepage"></div>
 
81
<div class="refnamediv"><table width="100%"><tr>
 
82
<td valign="top">
 
83
<h2>
 
84
<a name="id3362400"></a><span class="refentrytitle">GtkRadioMenuItem</span>
 
85
</h2>
 
86
<p>GtkRadioMenuItem &#8212; A choice from multiple check menu items</p>
 
87
</td>
 
88
<td valign="top" align="right"></td>
 
89
</tr></table></div>
 
90
<div class="refsynopsisdiv">
 
91
<h2>Synopsis</h2>
 
92
<pre class="synopsis">
 
93
 
 
94
#include &lt;gtk/gtk.h&gt;
 
95
 
 
96
 
 
97
                    <a href="GtkRadioMenuItem.html#GtkRadioMenuItem-struct">GtkRadioMenuItem</a>;
 
98
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new">gtk_radio_menu_item_new</a>             (GSList *group);
 
99
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-label">gtk_radio_menu_item_new_with_label</a>  (GSList *group,
 
100
                                                         const gchar *label);
 
101
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-mnemonic">gtk_radio_menu_item_new_with_mnemonic</a>
 
102
                                                        (GSList *group,
 
103
                                                         const gchar *label);
 
104
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-from-widget">gtk_radio_menu_item_new_from_widget</a> (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *group);
 
105
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-label-from-widget">gtk_radio_menu_item_new_with_label_from_widget</a>
 
106
                                                        (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *group,
 
107
                                                         const gchar *label);
 
108
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-mnemonic-from-widget">gtk_radio_menu_item_new_with_mnemonic_from_widget</a>
 
109
                                                        (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *group,
 
110
                                                         const gchar *label);
 
111
#define             <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-group">gtk_radio_menu_item_group</a>
 
112
void                <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-set-group">gtk_radio_menu_item_set_group</a>       (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *radio_menu_item,
 
113
                                                         GSList *group);
 
114
GSList*             <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-get-group">gtk_radio_menu_item_get_group</a>       (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *radio_menu_item);
 
115
 
 
116
 
 
117
</pre>
 
118
</div>
 
119
<div class="refsect1" lang="en">
 
120
<a name="id3362664"></a><h2>Object Hierarchy</h2>
 
121
<pre class="synopsis">
 
122
 
 
123
  GObject
 
124
   +----GInitiallyUnowned
 
125
         +----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
 
126
               +----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
 
127
                     +----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
 
128
                           +----<a href="GtkBin.html" title="GtkBin">GtkBin</a>
 
129
                                 +----<a href="GtkItem.html" title="GtkItem">GtkItem</a>
 
130
                                       +----<a href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>
 
131
                                             +----<a href="GtkCheckMenuItem.html" title="GtkCheckMenuItem">GtkCheckMenuItem</a>
 
132
                                                   +----GtkRadioMenuItem
 
133
</pre>
 
134
</div>
 
135
<div class="refsect1" lang="en">
 
136
<a name="id3362749"></a><h2>Implemented Interfaces</h2>
 
137
<p>
 
138
GtkRadioMenuItem implements
 
139
 AtkImplementorIface.</p>
 
140
</div>
 
141
<div class="refsect1" lang="en">
 
142
<a name="id3362772"></a><h2>Properties</h2>
 
143
<pre class="synopsis">
 
144
 
 
145
  "<a href="GtkRadioMenuItem.html#GtkRadioMenuItem--group">group</a>"                    <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>      : Write
 
146
</pre>
 
147
</div>
 
148
<div class="refsect1" lang="en">
 
149
<a name="id3362806"></a><h2>Signals</h2>
 
150
<pre class="synopsis">
 
151
 
 
152
  "<a href="GtkRadioMenuItem.html#GtkRadioMenuItem-group-changed">group-changed</a>"                                  : Run First
 
153
</pre>
 
154
</div>
 
155
<div class="refsect1" lang="en">
 
156
<a name="id3362834"></a><h2>Description</h2>
 
157
<p>
 
158
A radio menu item is a check menu item that belongs to a group. At each
 
159
instant exactly one of the radio menu items from a group is selected.
 
160
</p>
 
161
<p>
 
162
The group list does not need to be freed, as each <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> will 
 
163
remove itself and its list item when it is destroyed.
 
164
</p>
 
165
<p>
 
166
The correct way to create a group of radio menu items is approximatively
 
167
this:
 
168
</p>
 
169
<div class="example">
 
170
<a name="id3362868"></a><p class="title"><b>Example&#160;21.&#160;How to create a group of radio menu items.</b></p>
 
171
<div class="example-contents"><pre class="programlisting">
 
172
GSList *group = NULL;
 
173
GtkWidget *item;
 
174
gint i;
 
175
 
 
176
for (i = 0; i &lt; 5; i++)
 
177
{
 
178
  item = gtk_radio_menu_item_new_with_label (group, "This is an example");
 
179
  group = gtk_radio_menu_item_get_group (GTK_RADIO_MENU_ITEM (item));
 
180
  if (i == 1)
 
181
    gtk_check_menu_item_set_active (GTK_CHECK_MENU_ITEM (item), TRUE);
 
182
}
 
183
</pre></div>
 
184
</div>
 
185
<br class="example-break">
 
186
</div>
 
187
<div class="refsect1" lang="en">
 
188
<a name="id3362895"></a><h2>Details</h2>
 
189
<div class="refsect2" lang="en">
 
190
<a name="id3362905"></a><h3>
 
191
<a name="GtkRadioMenuItem-struct"></a>GtkRadioMenuItem</h3>
 
192
<a class="indexterm" name="id3362919"></a><pre class="programlisting">typedef struct _GtkRadioMenuItem GtkRadioMenuItem;</pre>
 
193
<p>
 
194
The structure contains only private data that must be accessed through
 
195
the interface functions.
 
196
</p>
 
197
</div>
 
198
<hr>
 
199
<div class="refsect2" lang="en">
 
200
<a name="id3362936"></a><h3>
 
201
<a name="gtk-radio-menu-item-new"></a>gtk_radio_menu_item_new ()</h3>
 
202
<a class="indexterm" name="id3362949"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_radio_menu_item_new             (GSList *group);</pre>
 
203
<p>
 
204
Creates a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>.
 
205
</p>
 
206
<div class="variablelist"><table border="0">
 
207
<col align="left" valign="top">
 
208
<tbody>
 
209
<tr>
 
210
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
211
<td>the group to which the radio menu item is to be attached
 
212
</td>
 
213
</tr>
 
214
<tr>
 
215
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
216
<td>a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
217
 
 
218
 
 
219
</td>
 
220
</tr>
 
221
</tbody>
 
222
</table></div>
 
223
</div>
 
224
<hr>
 
225
<div class="refsect2" lang="en">
 
226
<a name="id3363023"></a><h3>
 
227
<a name="gtk-radio-menu-item-new-with-label"></a>gtk_radio_menu_item_new_with_label ()</h3>
 
228
<a class="indexterm" name="id3363037"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_radio_menu_item_new_with_label  (GSList *group,
 
229
                                                         const gchar *label);</pre>
 
230
<p>
 
231
Creates a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> whose child is a simple <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>.
 
232
</p>
 
233
<div class="variablelist"><table border="0">
 
234
<col align="left" valign="top">
 
235
<tbody>
 
236
<tr>
 
237
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
238
<td>the group to which the radio menu item is to be attached
 
239
</td>
 
240
</tr>
 
241
<tr>
 
242
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
 
243
<td>the text for the label
 
244
</td>
 
245
</tr>
 
246
<tr>
 
247
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
248
<td>a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
249
 
 
250
 
 
251
</td>
 
252
</tr>
 
253
</tbody>
 
254
</table></div>
 
255
</div>
 
256
<hr>
 
257
<div class="refsect2" lang="en">
 
258
<a name="id3363141"></a><h3>
 
259
<a name="gtk-radio-menu-item-new-with-mnemonic"></a>gtk_radio_menu_item_new_with_mnemonic ()</h3>
 
260
<a class="indexterm" name="id3363155"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_radio_menu_item_new_with_mnemonic
 
261
                                                        (GSList *group,
 
262
                                                         const gchar *label);</pre>
 
263
<p>
 
264
Creates a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> containing a label. The label
 
265
will be created using <a href="GtkLabel.html#gtk-label-new-with-mnemonic"><code class="function">gtk_label_new_with_mnemonic()</code></a>, so underscores
 
266
in <em class="parameter"><code>label</code></em> indicate the mnemonic for the menu item.</p>
 
267
<p>
 
268
 
 
269
</p>
 
270
<div class="variablelist"><table border="0">
 
271
<col align="left" valign="top">
 
272
<tbody>
 
273
<tr>
 
274
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
275
<td> group the radio menu item is inside
 
276
</td>
 
277
</tr>
 
278
<tr>
 
279
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
 
280
<td> the text of the button, with an underscore in front of the
 
281
        mnemonic character
 
282
</td>
 
283
</tr>
 
284
<tr>
 
285
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
286
<td> a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
287
</td>
 
288
</tr>
 
289
</tbody>
 
290
</table></div>
 
291
</div>
 
292
<hr>
 
293
<div class="refsect2" lang="en">
 
294
<a name="id3363276"></a><h3>
 
295
<a name="gtk-radio-menu-item-new-from-widget"></a>gtk_radio_menu_item_new_from_widget ()</h3>
 
296
<a class="indexterm" name="id3363293"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_radio_menu_item_new_from_widget (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *group);</pre>
 
297
<p>
 
298
Creates a new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> adding it to the same group as <em class="parameter"><code>group</code></em>.</p>
 
299
<p>
 
300
 
 
301
</p>
 
302
<div class="variablelist"><table border="0">
 
303
<col align="left" valign="top">
 
304
<tbody>
 
305
<tr>
 
306
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
307
<td> An existing <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
308
</td>
 
309
</tr>
 
310
<tr>
 
311
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
312
<td> The new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
313
 
 
314
</td>
 
315
</tr>
 
316
</tbody>
 
317
</table></div>
 
318
<p class="since">Since  2.4
 
319
</p>
 
320
</div>
 
321
<hr>
 
322
<div class="refsect2" lang="en">
 
323
<a name="id3363390"></a><h3>
 
324
<a name="gtk-radio-menu-item-new-with-label-from-widget"></a>gtk_radio_menu_item_new_with_label_from_widget ()</h3>
 
325
<a class="indexterm" name="id3363407"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_radio_menu_item_new_with_label_from_widget
 
326
                                                        (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *group,
 
327
                                                         const gchar *label);</pre>
 
328
<p>
 
329
Creates a new GtkRadioMenuItem whose child is a simple GtkLabel.
 
330
The new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> is added to the same group as <em class="parameter"><code>group</code></em>.</p>
 
331
<p>
 
332
 
 
333
</p>
 
334
<div class="variablelist"><table border="0">
 
335
<col align="left" valign="top">
 
336
<tbody>
 
337
<tr>
 
338
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
339
<td> an existing <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> 
 
340
</td>
 
341
</tr>
 
342
<tr>
 
343
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
 
344
<td> the text for the label
 
345
</td>
 
346
</tr>
 
347
<tr>
 
348
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
349
<td> The new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
350
 
 
351
</td>
 
352
</tr>
 
353
</tbody>
 
354
</table></div>
 
355
<p class="since">Since  2.4
 
356
</p>
 
357
</div>
 
358
<hr>
 
359
<div class="refsect2" lang="en">
 
360
<a name="id3363530"></a><h3>
 
361
<a name="gtk-radio-menu-item-new-with-mnemonic-from-widget"></a>gtk_radio_menu_item_new_with_mnemonic_from_widget ()</h3>
 
362
<a class="indexterm" name="id3363546"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_radio_menu_item_new_with_mnemonic_from_widget
 
363
                                                        (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *group,
 
364
                                                         const gchar *label);</pre>
 
365
<p>
 
366
Creates a new GtkRadioMenuItem containing a label. The label will be
 
367
created using <a href="GtkLabel.html#gtk-label-new-with-mnemonic"><code class="function">gtk_label_new_with_mnemonic()</code></a>, so underscores in label
 
368
indicate the mnemonic for the menu item.
 
369
</p>
 
370
<p>
 
371
The new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> is added to the same group as <em class="parameter"><code>group</code></em>.</p>
 
372
<p>
 
373
 
 
374
</p>
 
375
<div class="variablelist"><table border="0">
 
376
<col align="left" valign="top">
 
377
<tbody>
 
378
<tr>
 
379
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
380
<td> An existing <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
381
</td>
 
382
</tr>
 
383
<tr>
 
384
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
 
385
<td> the text of the button, with an underscore in front of the
 
386
        mnemonic character
 
387
</td>
 
388
</tr>
 
389
<tr>
 
390
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
391
<td> The new <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>
 
392
 
 
393
</td>
 
394
</tr>
 
395
</tbody>
 
396
</table></div>
 
397
<p class="since">Since  2.4
 
398
</p>
 
399
</div>
 
400
<hr>
 
401
<div class="refsect2" lang="en">
 
402
<a name="id3363686"></a><h3>
 
403
<a name="gtk-radio-menu-item-group"></a>gtk_radio_menu_item_group</h3>
 
404
<a class="indexterm" name="id3363702"></a><pre class="programlisting">#define gtk_radio_menu_item_group gtk_radio_menu_item_get_group
 
405
</pre>
 
406
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
407
<h3 class="title">Warning</h3>
 
408
<p><code class="literal">gtk_radio_menu_item_group</code> is deprecated and should not be used in newly-written code.</p>
 
409
</div>
 
410
<p>
 
411
Deprecated compatibility macro. Use <a href="GtkRadioMenuItem.html#gtk-radio-menu-item-get-group"><code class="function">gtk_radio_menu_item_get_group()</code></a> instead.
 
412
</p>
 
413
</div>
 
414
<hr>
 
415
<div class="refsect2" lang="en">
 
416
<a name="id3363743"></a><h3>
 
417
<a name="gtk-radio-menu-item-set-group"></a>gtk_radio_menu_item_set_group ()</h3>
 
418
<a class="indexterm" name="id3363757"></a><pre class="programlisting">void                gtk_radio_menu_item_set_group       (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *radio_menu_item,
 
419
                                                         GSList *group);</pre>
 
420
<p>
 
421
Sets the group of a radio menu item, or changes it.
 
422
</p>
 
423
<div class="variablelist"><table border="0">
 
424
<col align="left" valign="top">
 
425
<tbody>
 
426
<tr>
 
427
<td><span class="term"><em class="parameter"><code>radio_menu_item</code></em>&#160;:</span></td>
 
428
<td>a <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>.
 
429
</td>
 
430
</tr>
 
431
<tr>
 
432
<td><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></td>
 
433
<td>the new group.
 
434
 
 
435
 
 
436
</td>
 
437
</tr>
 
438
</tbody>
 
439
</table></div>
 
440
</div>
 
441
<hr>
 
442
<div class="refsect2" lang="en">
 
443
<a name="id3363835"></a><h3>
 
444
<a name="gtk-radio-menu-item-get-group"></a>gtk_radio_menu_item_get_group ()</h3>
 
445
<a class="indexterm" name="id3363849"></a><pre class="programlisting">GSList*             gtk_radio_menu_item_get_group       (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *radio_menu_item);</pre>
 
446
<p>
 
447
Returns the group to which the radio menu item belongs, as a <span class="type">GList</span> of
 
448
<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>. The list belongs to GTK+ and should not be freed.
 
449
</p>
 
450
<div class="variablelist"><table border="0">
 
451
<col align="left" valign="top">
 
452
<tbody>
 
453
<tr>
 
454
<td><span class="term"><em class="parameter"><code>radio_menu_item</code></em>&#160;:</span></td>
 
455
<td>a <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>.
 
456
</td>
 
457
</tr>
 
458
<tr>
 
459
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
460
<td>the group of <em class="parameter"><code>radio_menu_item</code></em>.
 
461
 
 
462
 
 
463
</td>
 
464
</tr>
 
465
</tbody>
 
466
</table></div>
 
467
</div>
 
468
</div>
 
469
<div class="refsect1" lang="en">
 
470
<a name="id3363940"></a><h2>Property Details</h2>
 
471
<div class="refsect2" lang="en">
 
472
<a name="id3363950"></a><h3>
 
473
<a name="GtkRadioMenuItem--group"></a>The "<code class="literal">group</code>" property</h3>
 
474
<a class="indexterm" name="id3363967"></a><pre class="programlisting">  "group"                    <a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>      : Write</pre>
 
475
<p>
 
476
The radio menu item whose group this widget belongs to.</p>
 
477
<p>
 
478
 
 
479
</p>
 
480
<p>Since  2.8
 
481
</p>
 
482
</div>
 
483
</div>
 
484
<div class="refsect1" lang="en">
 
485
<a name="id3364001"></a><h2>Signal Details</h2>
 
486
<div class="refsect2" lang="en">
 
487
<a name="id3364012"></a><h3>
 
488
<a name="GtkRadioMenuItem-group-changed"></a>The "group-changed" signal</h3>
 
489
<a class="indexterm" name="id3364023"></a><pre class="programlisting">void                user_function                      (<a href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a> *radiomenuitem,
 
490
                                                        gpointer          user_data)          : Run First</pre>
 
491
<p>
 
492
 
 
493
</p>
 
494
<div class="variablelist"><table border="0">
 
495
<col align="left" valign="top">
 
496
<tbody>
 
497
<tr>
 
498
<td><span class="term"><em class="parameter"><code>radiomenuitem</code></em>&#160;:</span></td>
 
499
<td>the object which received the signal.
 
500
 
 
501
</td>
 
502
</tr>
 
503
<tr>
 
504
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
505
<td>user data set when the signal handler was connected.</td>
 
506
</tr>
 
507
</tbody>
 
508
</table></div>
 
509
</div>
 
510
</div>
 
511
<div class="refsect1" lang="en">
 
512
<a name="id3364094"></a><h2>See Also</h2>
 
513
<p>
 
514
</p>
 
515
<div class="variablelist"><table border="0">
 
516
<col align="left" valign="top">
 
517
<tbody>
 
518
<tr>
 
519
<td><span class="term"><a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a></span></td>
 
520
<td><p>because a radio menu item is a menu item.</p></td>
 
521
</tr>
 
522
<tr>
 
523
<td><span class="term"><a href="GtkCheckMenuItem.html" title="GtkCheckMenuItem"><span class="type">GtkCheckMenuItem</span></a></span></td>
 
524
<td><p>to know how to handle the check.</p></td>
 
525
</tr>
 
526
</tbody>
 
527
</table></div>
 
528
<p>
 
529
</p>
 
530
</div>
 
531
</div>
 
532
</body>
 
533
</html>