~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkRadioMenuItem.html

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-09-05 17:27:55 UTC
  • mfrom: (1.14.14)
  • Revision ID: package-import@ubuntu.com-20120905172755-14uyfpowr7elvr7m
Tags: 2.24.12-0ubuntu1
* New upstream bugfix release
* debian/patches/091_bugzilla_tooltip_refresh.patch:
  - Applied upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
9
9
<link rel="prev" href="GtkImageMenuItem.html" title="GtkImageMenuItem">
10
10
<link rel="next" href="gtk-gtkcheckmenuitem.html" title="GtkCheckMenuItem">
11
 
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.18.1 (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">
49
49
#include &lt;gtk/gtk.h&gt;
50
50
 
51
51
struct              <a class="link" href="GtkRadioMenuItem.html#GtkRadioMenuItem-struct" title="struct GtkRadioMenuItem">GtkRadioMenuItem</a>;
52
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new" title="gtk_radio_menu_item_new ()">gtk_radio_menu_item_new</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>);
53
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-label" title="gtk_radio_menu_item_new_with_label ()">gtk_radio_menu_item_new_with_label</a>  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>,
54
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
 
52
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new" title="gtk_radio_menu_item_new ()">gtk_radio_menu_item_new</a>             (<em class="parameter"><code><span class="type">GSList</span> *group</code></em>);
 
53
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-label" title="gtk_radio_menu_item_new_with_label ()">gtk_radio_menu_item_new_with_label</a>  (<em class="parameter"><code><span class="type">GSList</span> *group</code></em>,
 
54
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
55
55
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-mnemonic" title="gtk_radio_menu_item_new_with_mnemonic ()">gtk_radio_menu_item_new_with_mnemonic</a>
56
 
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>,
57
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
 
56
                                                        (<em class="parameter"><code><span class="type">GSList</span> *group</code></em>,
 
57
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
58
58
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-from-widget" title="gtk_radio_menu_item_new_from_widget ()">gtk_radio_menu_item_new_from_widget</a> (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *group</code></em>);
59
59
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-label-from-widget" title="gtk_radio_menu_item_new_with_label_from_widget ()">gtk_radio_menu_item_new_with_label_from_widget</a>
60
60
                                                        (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *group</code></em>,
61
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
 
61
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
62
62
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-mnemonic-from-widget" title="gtk_radio_menu_item_new_with_mnemonic_from_widget ()">gtk_radio_menu_item_new_with_mnemonic_from_widget</a>
63
63
                                                        (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *group</code></em>,
64
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
 
64
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
65
65
#define             <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-group" title="gtk_radio_menu_item_group">gtk_radio_menu_item_group</a>
66
66
<span class="returnvalue">void</span>                <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-set-group" title="gtk_radio_menu_item_set_group ()">gtk_radio_menu_item_set_group</a>       (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radio_menu_item</code></em>,
67
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>);
68
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-get-group" title="gtk_radio_menu_item_get_group ()">gtk_radio_menu_item_get_group</a>       (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radio_menu_item</code></em>);
 
67
                                                         <em class="parameter"><code><span class="type">GSList</span> *group</code></em>);
 
68
<span class="returnvalue">GSList</span> *            <a class="link" href="GtkRadioMenuItem.html#gtk-radio-menu-item-get-group" title="gtk_radio_menu_item_get_group ()">gtk_radio_menu_item_get_group</a>       (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radio_menu_item</code></em>);
69
69
</pre>
70
70
</div>
71
71
<div class="refsect1">
116
116
this:
117
117
</p>
118
118
<div class="example">
119
 
<a name="id888731"></a><p class="title"><b>Example 34. How to create a group of radio menu items.</b></p>
 
119
<a name="id1037659"></a><p class="title"><b>Example 34. How to create a group of radio menu items.</b></p>
120
120
<div class="example-contents">
121
121
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
122
122
    <tbody>
131
131
8
132
132
9
133
133
10</pre></td>
134
 
        <td class="listing_code"><pre class="programlisting"><span class="usertype">GSList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">group </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
134
        <td class="listing_code"><pre class="programlisting"><span class="usertype">GSList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">group </span><span class="symbol">=</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">;</span>
135
135
<span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">item</span><span class="symbol">;</span>
136
136
<span class="usertype">gint</span><span class="normal"> i</span><span class="symbol">;</span>
137
137
<span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">5</span><span class="symbol">;</span><span class="normal"> i</span><span class="symbol">++)</span>
139
139
<span class="normal">  item </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkRadioMenuItem.html#gtk-radio-menu-item-new-with-label">gtk_radio_menu_item_new_with_label</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">group</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"This is an example"</span><span class="symbol">);</span>
140
140
<span class="normal">  group </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkRadioMenuItem.html#gtk-radio-menu-item-get-group">gtk_radio_menu_item_get_group</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_RADIO_MENU_ITEM</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">item</span><span class="symbol">));</span>
141
141
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">==</span><span class="normal"> </span><span class="number">1</span><span class="symbol">)</span>
142
 
<span class="normal">    </span><span class="function"><a href="gtk-gtkcheckmenuitem.html#gtk-check-menu-item-set-active">gtk_check_menu_item_set_active</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CHECK_MENU_ITEM</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">item</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
 
142
<span class="normal">    </span><span class="function"><a href="gtk-gtkcheckmenuitem.html#gtk-check-menu-item-set-active">gtk_check_menu_item_set_active</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CHECK_MENU_ITEM</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">item</span><span class="symbol">),</span><span class="normal"> TRUE</span><span class="symbol">);</span>
143
143
<span class="cbracket">}</span></pre></td>
144
144
      </tr>
145
145
    </tbody>
162
162
<hr>
163
163
<div class="refsect2">
164
164
<a name="gtk-radio-menu-item-new"></a><h3>gtk_radio_menu_item_new ()</h3>
165
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>);</pre>
 
165
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new             (<em class="parameter"><code><span class="type">GSList</span> *group</code></em>);</pre>
166
166
<p>
167
167
Creates a new <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>.
168
168
</p>
187
187
<hr>
188
188
<div class="refsect2">
189
189
<a name="gtk-radio-menu-item-new-with-label"></a><h3>gtk_radio_menu_item_new_with_label ()</h3>
190
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new_with_label  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>,
191
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
190
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new_with_label  (<em class="parameter"><code><span class="type">GSList</span> *group</code></em>,
 
191
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
192
192
<p>
193
193
Creates a new <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> whose child is a simple <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>.
194
194
</p>
219
219
<div class="refsect2">
220
220
<a name="gtk-radio-menu-item-new-with-mnemonic"></a><h3>gtk_radio_menu_item_new_with_mnemonic ()</h3>
221
221
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new_with_mnemonic
222
 
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>,
223
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
222
                                                        (<em class="parameter"><code><span class="type">GSList</span> *group</code></em>,
 
223
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
224
224
<p>
225
225
Creates a new <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> containing a label. The label
226
226
will be created using <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()"><code class="function">gtk_label_new_with_mnemonic()</code></a>, so underscores
281
281
<a name="gtk-radio-menu-item-new-with-label-from-widget"></a><h3>gtk_radio_menu_item_new_with_label_from_widget ()</h3>
282
282
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new_with_label_from_widget
283
283
                                                        (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *group</code></em>,
284
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
284
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
285
285
<p>
286
286
Creates a new GtkRadioMenuItem whose child is a simple GtkLabel.
287
287
The new <a class="link" 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>.
315
315
<a name="gtk-radio-menu-item-new-with-mnemonic-from-widget"></a><h3>gtk_radio_menu_item_new_with_mnemonic_from_widget ()</h3>
316
316
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_radio_menu_item_new_with_mnemonic_from_widget
317
317
                                                        (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *group</code></em>,
318
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
318
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
319
319
<p>
320
320
Creates a new GtkRadioMenuItem containing a label. The label will be
321
321
created using <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()"><code class="function">gtk_label_new_with_mnemonic()</code></a>, so underscores in label
366
366
<div class="refsect2">
367
367
<a name="gtk-radio-menu-item-set-group"></a><h3>gtk_radio_menu_item_set_group ()</h3>
368
368
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_radio_menu_item_set_group       (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radio_menu_item</code></em>,
369
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *group</code></em>);</pre>
 
369
                                                         <em class="parameter"><code><span class="type">GSList</span> *group</code></em>);</pre>
370
370
<p>
371
371
Sets the group of a radio menu item, or changes it.
372
372
</p>
390
390
<hr>
391
391
<div class="refsect2">
392
392
<a name="gtk-radio-menu-item-get-group"></a><h3>gtk_radio_menu_item_get_group ()</h3>
393
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            gtk_radio_menu_item_get_group       (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radio_menu_item</code></em>);</pre>
 
393
<pre class="programlisting"><span class="returnvalue">GSList</span> *            gtk_radio_menu_item_get_group       (<em class="parameter"><code><a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radio_menu_item</code></em>);</pre>
394
394
<p>
395
 
Returns the group to which the radio menu item belongs, as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
 
395
Returns the group to which the radio menu item belongs, as a <span class="type">GList</span> of
396
396
<a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>. The list belongs to GTK+ and should not be freed.
397
397
</p>
398
398
<p>
399
 
Returns the group to which the radio menu item belongs, as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
 
399
Returns the group to which the radio menu item belongs, as a <span class="type">GList</span> of
400
400
<a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a>. The list belongs to GTK+ and should not be freed.
401
401
</p>
402
402
<div class="variablelist"><table border="0" class="variablelist">
435
435
<div class="refsect2">
436
436
<a name="GtkRadioMenuItem-group-changed"></a><h3>The <code class="literal">"group-changed"</code> signal</h3>
437
437
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem"><span class="type">GtkRadioMenuItem</span></a> *radiomenuitem,
438
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
438
                                                        <span class="type">gpointer</span>          user_data)          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
439
439
<p>
440
440
</p>
441
441
<div class="variablelist"><table border="0" class="variablelist">
482
482
</div>
483
483
<div class="footer">
484
484
<hr>
485
 
          Generated by GTK-Doc V1.18</div>
 
485
          Generated by GTK-Doc V1.18.1</div>
486
486
</body>
487
487
</html>
 
 
b'\\ No newline at end of file'