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

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-new" title="gtk_menu_item_new ()">gtk_menu_item_new</a> (<code>void</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-label" title="gtk_menu_item_new_with_label ()">gtk_menu_item_new_with_label</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *label</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-mnemonic" title="gtk_menu_item_new_with_mnemonic ()">gtk_menu_item_new_with_mnemonic</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *label</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-label" title="gtk_menu_item_new_with_label ()">gtk_menu_item_new_with_label</a> (<code>const gchar *label</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-mnemonic" title="gtk_menu_item_new_with_mnemonic ()">gtk_menu_item_new_with_mnemonic</a> (<code>const gchar *label</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-right-justified" title="gtk_menu_item_set_right_justified ()">gtk_menu_item_set_right_justified</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> right_justified</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-right-justified" title="gtk_menu_item_get_right_justified ()">gtk_menu_item_get_right_justified</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-label" title="gtk_menu_item_get_label ()">gtk_menu_item_get_label</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

<code>gboolean right_justified</code>);

gboolean <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-right-justified" title="gtk_menu_item_get_right_justified ()">gtk_menu_item_get_right_justified</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

const gchar * <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-label" title="gtk_menu_item_get_label ()">gtk_menu_item_get_label</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-label" title="gtk_menu_item_set_label ()">gtk_menu_item_set_label</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *label</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-use-underline" title="gtk_menu_item_get_use_underline ()">gtk_menu_item_get_use_underline</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

<code>const gchar *label</code>);

gboolean <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-use-underline" title="gtk_menu_item_get_use_underline ()">gtk_menu_item_get_use_underline</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-use-underline" title="gtk_menu_item_set_use_underline ()">gtk_menu_item_set_use_underline</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> setting</code>);

<code>gboolean setting</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-submenu" title="gtk_menu_item_set_submenu ()">gtk_menu_item_set_submenu</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *submenu</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-submenu" title="gtk_menu_item_get_submenu ()">gtk_menu_item_get_submenu</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-remove-submenu" title="gtk_menu_item_remove_submenu ()">gtk_menu_item_remove_submenu</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-accel-path" title="gtk_menu_item_set_accel_path ()">gtk_menu_item_set_accel_path</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *accel_path</code>);

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-accel-path" title="gtk_menu_item_get_accel_path ()">gtk_menu_item_get_accel_path</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

<code>const gchar *accel_path</code>);

const gchar * <a class="link" href="GtkMenuItem.html#gtk-menu-item-get-accel-path" title="gtk_menu_item_get_accel_path ()">gtk_menu_item_get_accel_path</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-select" title="gtk_menu_item_select ()">gtk_menu_item_select</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-deselect" title="gtk_menu_item_deselect ()">gtk_menu_item_deselect</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-activate" title="gtk_menu_item_activate ()">gtk_menu_item_activate</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-toggle-size-request" title="gtk_menu_item_toggle_size_request ()">gtk_menu_item_toggle_size_request</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *requisition</code>);

<code>gint *requisition</code>);

void <a class="link" href="GtkMenuItem.html#gtk-menu-item-toggle-size-allocate" title="gtk_menu_item_toggle_size_allocate ()">gtk_menu_item_toggle_size_allocate</a> (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> allocation</code>);

<code>gint allocation</code>);

#define <a class="link" href="GtkMenuItem.html#gtk-menu-item-right-justify" title="gtk_menu_item_right_justify()">gtk_menu_item_right_justify</a> (menu_item)

</pre>

</div>

106

107

<a name="GtkMenuItem.properties"></a><h2>Properties</h2>

108

109

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--accel-path" title='The "accel-path" property'>accel-path</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write

110

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--label" title='The "label" property'>label</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write

111

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--right-justified" title='The "right-justified" property'>right-justified</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write

109

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--accel-path" title='The "accel-path" property'>accel-path</a>" gchar* : Read / Write

110

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--label" title='The "label" property'>label</a>" gchar* : Read / Write

111

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--right-justified" title='The "right-justified" property'>right-justified</a>" gboolean : Read / Write

112

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--submenu" title='The "submenu" property'>submenu</a>" <a class="link" href="GtkMenu.html" title="GtkMenu">GtkMenu</a>* : Read / Write

113

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--use-underline" title='The "use-underline" property'>use-underline</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write

113

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--use-underline" title='The "use-underline" property'>use-underline</a>" gboolean : Read / Write

114

</pre>

115

</div>

116

117

<a name="GtkMenuItem.style-properties"></a><h2>Style Properties</h2>

118

119

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-arrow-scaling" title='The "arrow-scaling" style property'>arrow-scaling</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat">gfloat</a> : Read

120

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-arrow-spacing" title='The "arrow-spacing" style property'>arrow-spacing</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read

121

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-horizontal-padding" title='The "horizontal-padding" style property'>horizontal-padding</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read

119

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-arrow-scaling" title='The "arrow-scaling" style property'>arrow-scaling</a>" gfloat : Read

120

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-arrow-spacing" title='The "arrow-spacing" style property'>arrow-spacing</a>" gint : Read

121

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-horizontal-padding" title='The "horizontal-padding" style property'>horizontal-padding</a>" gint : Read

122

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-selected-shadow-type" title='The "selected-shadow-type" style property'>selected-shadow-type</a>" <a class="link" href="gtk-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType">GtkShadowType</a> : Read

123

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-toggle-spacing" title='The "toggle-spacing" style property'>toggle-spacing</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read

124

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-width-chars" title='The "width-chars" style property'>width-chars</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read

123

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-toggle-spacing" title='The "toggle-spacing" style property'>toggle-spacing</a>" gint : Read

124

"<a class="link" href="GtkMenuItem.html#GtkMenuItem--s-width-chars" title='The "width-chars" style property'>width-chars</a>" gint : Read

125

</pre>

126

</div>

127

152

attribute of a <child> element.

153

154

155

<a name="id877062"></a>Example 33. A UI definition fragment with submenus

155

<a name="id1030361"></a>Example 33. A UI definition fragment with submenus

156

157

158

<tbody>

206

<hr>

207

208

<a name="gtk-menu-item-new-with-label"></a><h3>gtk_menu_item_new_with_label ()</h3>

209

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_menu_item_new_with_label (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *label</code>);</pre>

209

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_menu_item_new_with_label (<code>const gchar *label</code>);</pre>

210

211

Creates a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> whose child is a <a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a>.

212

231

<hr>

232

233

<a name="gtk-menu-item-new-with-mnemonic"></a><h3>gtk_menu_item_new_with_mnemonic ()</h3>

234

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_menu_item_new_with_mnemonic (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *label</code>);</pre>

234

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_menu_item_new_with_mnemonic (<code>const gchar *label</code>);</pre>

235

236

Creates a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> containing a label. The label

237

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

260

261

<a name="gtk-menu-item-set-right-justified"></a><h3>gtk_menu_item_set_right_justified ()</h3>

262

<pre class="programlisting">void gtk_menu_item_set_right_justified (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

263

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> right_justified</code>);</pre>

263

<code>gboolean right_justified</code>);</pre>

264

265

Sets whether the menu item appears justified at the right

266

side of a menu bar. This was traditionally done for "Help" menu

280

</tr>

281

<tr>

282

<td><code>right_justified</code> :</td>

283

<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the menu item will appear at the

283

<td>if <code class="literal">TRUE</code> the menu item will appear at the

284

far right if added to a menu bar.</td>

285

</tr>

286

</tbody>

289

<hr>

290

291

<a name="gtk-menu-item-get-right-justified"></a><h3>gtk_menu_item_get_right_justified ()</h3>

292

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_menu_item_get_right_justified (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

292

<pre class="programlisting">gboolean gtk_menu_item_get_right_justified (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

293

294

Gets whether the menu item appears justified at the right

295

side of the menu bar.

308

<tr>

309

<td>Returns :</td>

310

<td>

311

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the menu item will appear at the

311

<code class="literal">TRUE</code> if the menu item will appear at the

312

far right if added to a menu bar.</td>

313

</tr>

314

</tbody>

317

<hr>

318

319

<a name="gtk-menu-item-get-label"></a><h3>gtk_menu_item_get_label ()</h3>

320

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gtk_menu_item_get_label (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

320

<pre class="programlisting">const gchar * gtk_menu_item_get_label (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

321

322

Sets <code>text</code> on the <code>menu_item</code> label

323

345

346

<a name="gtk-menu-item-set-label"></a><h3>gtk_menu_item_set_label ()</h3>

347

<pre class="programlisting">void gtk_menu_item_set_label (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

348

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *label</code>);</pre>

348

<code>const gchar *label</code>);</pre>

349

350

Sets <code>text</code> on the <code>menu_item</code> label

351

371

<hr>

372

373

<a name="gtk-menu-item-get-use-underline"></a><h3>gtk_menu_item_get_use_underline ()</h3>

374

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_menu_item_get_use_underline (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

374

<pre class="programlisting">gboolean gtk_menu_item_get_use_underline (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

375

376

Checks if an underline in the text indicates the next character should be

377

used for the mnemonic accelerator key.

390

<tr>

391

<td>Returns :</td>

392

<td>

393

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if an embedded underline in the label indicates

393

<code class="literal">TRUE</code> if an embedded underline in the label indicates

394

the mnemonic accelerator key.</td>

395

</tr>

396

</tbody>

401

402

<a name="gtk-menu-item-set-use-underline"></a><h3>gtk_menu_item_set_use_underline ()</h3>

403

<pre class="programlisting">void gtk_menu_item_set_use_underline (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

404

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> setting</code>);</pre>

404

<code>gboolean setting</code>);</pre>

405

406

If true, an underline in the text indicates the next character should be

407

used for the mnemonic accelerator key.

420

<tr>

421

<td><code>setting</code> :</td>

422

<td>

423

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics</td>

423

<code class="literal">TRUE</code> if underlines in the text indicate mnemonics</td>

424

</tr>

425

</tbody>

426

</table></div>

432

<pre class="programlisting">void gtk_menu_item_set_submenu (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

433

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *submenu</code>);</pre>

434

435

Sets or replaces the menu item's submenu, or removes it when a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

435

Sets or replaces the menu item's submenu, or removes it when a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>

436

submenu is passed.

437

438

448

</tr>

449

<tr>

450

<td><code>submenu</code> :</td>

451

<td>the submenu, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

451

<td>the submenu, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

452

</td>

453

</tr>

454

</tbody>

475

</tr>

476

<tr>

477

<td>Returns :</td>

478

<td>submenu for this menu item, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

478

<td>submenu for this menu item, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

479

</td>

480

</tr>

481

</tbody>

510

511

<a name="gtk-menu-item-set-accel-path"></a><h3>gtk_menu_item_set_accel_path ()</h3>

512

<pre class="programlisting">void gtk_menu_item_set_accel_path (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

513

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *accel_path</code>);</pre>

513

<code>const gchar *accel_path</code>);</pre>

514

515

Set the accelerator path on <code>menu_item</code>, through which runtime changes of the

516

menu item's accelerator caused by the user can be identified and saved to

530

<a class="link" href="GtkMenu.html#gtk-menu-set-accel-group" title="gtk_menu_set_accel_group ()"><code class="function">gtk_menu_set_accel_group()</code></a> for this to work.

531

532

533

Note that <code>accel_path</code> string will be stored in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>. Therefore, if you

533

Note that <code>accel_path</code> string will be stored in a GQuark. Therefore, if you

534

pass a static string, you can save some memory by interning it first with

535

<a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-intern-static-string"><code class="function">g_intern_static_string()</code></a>.

535

<code class="function">g_intern_static_string()</code>.

536

537

538

548

<tr>

549

<td><code>accel_path</code> :</td>

550

<td>accelerator path, corresponding to this menu item's

551

functionality, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the current path. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

551

functionality, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to unset the current path. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

552

</td>

553

</tr>

554

</tbody>

557

<hr>

558

559

<a name="gtk-menu-item-get-accel-path"></a><h3>gtk_menu_item_get_accel_path ()</h3>

560

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gtk_menu_item_get_accel_path (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

560

<pre class="programlisting">const gchar * gtk_menu_item_get_accel_path (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>);</pre>

561

562

Retrieve the accelerator path that was previously set on <code>menu_item</code>.

563

578

<tr>

579

<td>Returns :</td>

580

<td>the accelerator path corresponding to this menu item's

581

functionality, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set</td>

581

functionality, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if not set</td>

582

</tr>

583

</tbody>

584

</table></div>

644

645

<a name="gtk-menu-item-toggle-size-request"></a><h3>gtk_menu_item_toggle_size_request ()</h3>

646

<pre class="programlisting">void gtk_menu_item_toggle_size_request (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

647

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *requisition</code>);</pre>

647

<code>gint *requisition</code>);</pre>

648

649

Emits the "toggle_size_request" signal on the given item.

650

669

670

<a name="gtk-menu-item-toggle-size-allocate"></a><h3>gtk_menu_item_toggle_size_allocate ()</h3>

671

<pre class="programlisting">void gtk_menu_item_toggle_size_allocate (<code><a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menu_item</code>,

672

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> allocation</code>);</pre>

672

<code>gint allocation</code>);</pre>

673

674

Emits the "toggle_size_allocate" signal on the given item.

675

718

<a name="GtkMenuItem.property-details"></a><h2>Property Details</h2>

719

720

<a name="GtkMenuItem--accel-path"></a><h3>The <code class="literal">"accel-path"</code> property</h3>

721

<pre class="programlisting"> "accel-path" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

721

<pre class="programlisting"> "accel-path" gchar* : Read / Write</pre>

722

723

Sets the accelerator path of the menu item, through which runtime

724

changes of the menu item's accelerator caused by the user can be

730

<hr>

731

732

<a name="GtkMenuItem--label"></a><h3>The <code class="literal">"label"</code> property</h3>

733

<pre class="programlisting"> "label" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

733

<pre class="programlisting"> "label" gchar* : Read / Write</pre>

734

735

The text for the child label.

736

740

<hr>

741

742

<a name="GtkMenuItem--right-justified"></a><h3>The <code class="literal">"right-justified"</code> property</h3>

743

<pre class="programlisting"> "right-justified" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

743

<pre class="programlisting"> "right-justified" gboolean : Read / Write</pre>

744

745

Sets whether the menu item appears justified at the right side of a menu bar.

746

759

<hr>

760

761

<a name="GtkMenuItem--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3>

762

<pre class="programlisting"> "use-underline" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

762

<pre class="programlisting"> "use-underline" gboolean : Read / Write</pre>

763

764

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics

764

<code class="literal">TRUE</code> if underlines in the text indicate mnemonics

765

766

Default value: FALSE

767

Since 2.16

771

<a name="GtkMenuItem.style-property-details"></a><h2>Style Property Details</h2>

772

773

<a name="GtkMenuItem--s-arrow-scaling"></a><h3>The <code class="literal">"arrow-scaling"</code> style property</h3>

774

<pre class="programlisting"> "arrow-scaling" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat">gfloat</a> : Read</pre>

774

<pre class="programlisting"> "arrow-scaling" gfloat : Read</pre>

775

Amount of space used up by arrow, relative to the menu item's font size.

776

Allowed values: [0,2]

777

Default value: 0.8

779

<hr>

780

781

<a name="GtkMenuItem--s-arrow-spacing"></a><h3>The <code class="literal">"arrow-spacing"</code> style property</h3>

782

<pre class="programlisting"> "arrow-spacing" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

782

<pre class="programlisting"> "arrow-spacing" gint : Read</pre>

783

Space between label and arrow.

784

Allowed values: >= 0

785

Default value: 10

787

<hr>

788

789

<a name="GtkMenuItem--s-horizontal-padding"></a><h3>The <code class="literal">"horizontal-padding"</code> style property</h3>

790

<pre class="programlisting"> "horizontal-padding" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

790

<pre class="programlisting"> "horizontal-padding" gint : Read</pre>

791

Padding to left and right of the menu item.

792

Allowed values: >= 0

793

Default value: 3

802

<hr>

803

804

<a name="GtkMenuItem--s-toggle-spacing"></a><h3>The <code class="literal">"toggle-spacing"</code> style property</h3>

805

<pre class="programlisting"> "toggle-spacing" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

805

<pre class="programlisting"> "toggle-spacing" gint : Read</pre>

806

Space between icon and label.

807

Allowed values: >= 0

808

Default value: 5

810

<hr>

811

812

<a name="GtkMenuItem--s-width-chars"></a><h3>The <code class="literal">"width-chars"</code> style property</h3>

813

<pre class="programlisting"> "width-chars" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

813

<pre class="programlisting"> "width-chars" gint : Read</pre>

814

815

The minimum desired width of the menu item in characters.

816

824

825

<a name="GtkMenuItem-activate"></a><h3>The <code class="literal">"activate"</code> signal</h3>

826

<pre class="programlisting">void user_function (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menuitem,

827

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>

827

gpointer user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>

828

829

Emitted when the item is activated.

830

849

850

<a name="GtkMenuItem-activate-item"></a><h3>The <code class="literal">"activate-item"</code> signal</h3>

851

<pre class="programlisting">void user_function (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menuitem,

852

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</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>

852

gpointer 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>

853

854

Emitted when the item is activated, but also if the menu item has a

855

submenu. For normal applications, the relevant signal is "activate".

875

876

<a name="GtkMenuItem-toggle-size-allocate"></a><h3>The <code class="literal">"toggle-size-allocate"</code> signal</h3>

877

<pre class="programlisting">void user_function (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menuitem,

878

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> arg1,

879

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</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>

878

gint arg1,

879

gpointer 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>

880

881

882

900

901

<a name="GtkMenuItem-toggle-size-request"></a><h3>The <code class="literal">"toggle-size-request"</code> signal</h3>

902

<pre class="programlisting">void user_function (<a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a> *menuitem,

903

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> arg1,

904

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</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>

903

gpointer arg1,

904

gpointer 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>

905

906

907

952

</div>

953

954

<hr>

955

Generated by GTK-Doc V1.18</div>

955

Generated by GTK-Doc V1.18.1</div>

956

</body>

957

</html>

b'\\ No newline at end of file'

Older »