2391 lines
116 KiB
HTML
2391 lines
116 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkAction: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
|
||
<link rel="prev" href="GtkActionGroup.html" title="GtkActionGroup">
|
||
<link rel="next" href="GtkToggleAction.html" title="GtkToggleAction">
|
||
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkAction.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkAction.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
|
||
<a href="#GtkAction.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkAction.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkAction.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="GtkActionGroup.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkToggleAction.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkAction"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkAction.top_of_page"></a>GtkAction</span></h2>
|
||
<p>GtkAction — A deprecated action which can be triggered by a menu or toolbar item</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_return">
|
||
<col class="functions_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkAction.html" title="GtkAction"><span class="returnvalue">GtkAction</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-new" title="gtk_action_new ()">gtk_action_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-name" title="gtk_action_get_name ()">gtk_action_get_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()">gtk_action_is_sensitive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-sensitive" title="gtk_action_get_sensitive ()">gtk_action_get_sensitive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-sensitive" title="gtk_action_set_sensitive ()">gtk_action_set_sensitive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-is-visible" title="gtk_action_is_visible ()">gtk_action_is_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-visible" title="gtk_action_get_visible ()">gtk_action_get_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-visible" title="gtk_action_set_visible ()">gtk_action_set_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-activate" title="gtk_action_activate ()">gtk_action_activate</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-create-icon" title="gtk_action_create_icon ()">gtk_action_create_icon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-create-menu-item" title="gtk_action_create_menu_item ()">gtk_action_create_menu_item</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-create-tool-item" title="gtk_action_create_tool_item ()">gtk_action_create_tool_item</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-create-menu" title="gtk_action_create_menu ()">gtk_action_create_menu</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GSList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-proxies" title="gtk_action_get_proxies ()">gtk_action_get_proxies</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-connect-accelerator" title="gtk_action_connect_accelerator ()">gtk_action_connect_accelerator</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-disconnect-accelerator" title="gtk_action_disconnect_accelerator ()">gtk_action_disconnect_accelerator</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-block-activate" title="gtk_action_block_activate ()">gtk_action_block_activate</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-unblock-activate" title="gtk_action_unblock_activate ()">gtk_action_unblock_activate</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-always-show-image" title="gtk_action_get_always_show_image ()">gtk_action_get_always_show_image</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-always-show-image" title="gtk_action_set_always_show_image ()">gtk_action_set_always_show_image</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-accel-path" title="gtk_action_get_accel_path ()">gtk_action_get_accel_path</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-accel-path" title="gtk_action_set_accel_path ()">gtk_action_set_accel_path</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GClosure</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-accel-closure" title="gtk_action_get_accel_closure ()">gtk_action_get_accel_closure</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-accel-group" title="gtk_action_set_accel_group ()">gtk_action_set_accel_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-label" title="gtk_action_set_label ()">gtk_action_set_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-label" title="gtk_action_get_label ()">gtk_action_get_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-short-label" title="gtk_action_set_short_label ()">gtk_action_set_short_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-short-label" title="gtk_action_get_short_label ()">gtk_action_get_short_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-tooltip" title="gtk_action_set_tooltip ()">gtk_action_set_tooltip</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-tooltip" title="gtk_action_get_tooltip ()">gtk_action_get_tooltip</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-stock-id" title="gtk_action_set_stock_id ()">gtk_action_set_stock_id</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-stock-id" title="gtk_action_get_stock_id ()">gtk_action_get_stock_id</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-gicon" title="gtk_action_set_gicon ()">gtk_action_set_gicon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GIcon</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-gicon" title="gtk_action_get_gicon ()">gtk_action_get_gicon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-icon-name" title="gtk_action_set_icon_name ()">gtk_action_set_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-icon-name" title="gtk_action_get_icon_name ()">gtk_action_get_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-visible-horizontal" title="gtk_action_set_visible_horizontal ()">gtk_action_set_visible_horizontal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-visible-horizontal" title="gtk_action_get_visible_horizontal ()">gtk_action_get_visible_horizontal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-visible-vertical" title="gtk_action_set_visible_vertical ()">gtk_action_set_visible_vertical</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-visible-vertical" title="gtk_action_get_visible_vertical ()">gtk_action_get_visible_vertical</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-set-is-important" title="gtk_action_set_is_important ()">gtk_action_set_is_important</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkAction.html#gtk-action-get-is-important" title="gtk_action_get_is_important ()">gtk_action_get_is_important</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--action-group" title="The “action-group” property">action-group</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--always-show-image" title="The “always-show-image” property">always-show-image</a></td>
|
||
<td class="property_flags">Read / Write / Construct</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GIcon</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--gicon" title="The “gicon” property">gicon</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--hide-if-empty" title="The “hide-if-empty” property">hide-if-empty</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">gchar</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--icon-name" title="The “icon-name” property">icon-name</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--is-important" title="The “is-important” property">is-important</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">gchar</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--label" title="The “label” property">label</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">gchar</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--name" title="The “name” property">name</a></td>
|
||
<td class="property_flags">Read / Write / Construct Only</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--sensitive" title="The “sensitive” property">sensitive</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">gchar</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--short-label" title="The “short-label” property">short-label</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">gchar</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property">stock-id</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">gchar</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--tooltip" title="The “tooltip” property">tooltip</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible" title="The “visible” property">visible</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible-horizontal" title="The “visible-horizontal” property">visible-horizontal</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible-overflown" title="The “visible-overflown” property">visible-overflown</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible-vertical" title="The “visible-vertical” property">visible-vertical</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signals_return">
|
||
<col width="300px" class="signals_name">
|
||
<col width="200px" class="signals_flags">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkAction.html#GtkAction-activate" title="The “activate” signal">activate</a></td>
|
||
<td class="signal_flags">No Recursion</td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="name">
|
||
<col class="description">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkAction.html#GtkAction-struct" title="struct GtkAction">GtkAction</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkAction.html#GtkActionClass" title="struct GtkActionClass">GtkActionClass</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GtkAction
|
||
<span class="lineart">├──</span> <a class="link" href="GtkToggleAction.html" title="GtkToggleAction">GtkToggleAction</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkRecentAction.html" title="GtkRecentAction">GtkRecentAction</a>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||
<p>
|
||
GtkAction implements
|
||
<a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.description"></a><h2>Description</h2>
|
||
<div class="blockquote"><blockquote class="blockquote"><p>In GTK+ 3.10, GtkAction has been deprecated. Use <span class="type">GAction</span>
|
||
instead, and associate actions with <a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets. Use
|
||
<span class="type">GMenuModel</span> for creating menus with <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()"><code class="function">gtk_menu_new_from_model()</code></a>.</p></blockquote></div>
|
||
<p>Actions represent operations that the user can be perform, along with
|
||
some information how it should be presented in the interface. Each action
|
||
provides methods to create icons, menu items and toolbar items
|
||
representing itself.</p>
|
||
<p>As well as the callback that is called when the action gets activated,
|
||
the following also gets associated with the action:</p>
|
||
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
|
||
<li class="listitem"><p>a name (not translated, for path lookup)</p></li>
|
||
<li class="listitem"><p>a label (translated, for display)</p></li>
|
||
<li class="listitem"><p>an accelerator</p></li>
|
||
<li class="listitem"><p>whether label indicates a stock id</p></li>
|
||
<li class="listitem"><p>a tooltip (optional, translated)</p></li>
|
||
<li class="listitem"><p>a toolbar label (optional, shorter than label)</p></li>
|
||
</ul></div>
|
||
<p>The action will also have some state information:</p>
|
||
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
|
||
<li class="listitem"><p>visible (shown/hidden)</p></li>
|
||
<li class="listitem"><p>sensitive (enabled/disabled)</p></li>
|
||
</ul></div>
|
||
<p>Apart from regular actions, there are <a class="link" href="GtkToggleAction.html" title="GtkToggleAction">toggle actions</a>,
|
||
which can be toggled between two states and
|
||
<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">radio actions</a>, of which only one in a group
|
||
can be in the “active” state. Other actions can be implemented as <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>
|
||
subclasses.</p>
|
||
<p>Each action can have one or more proxy widgets. To act as an action proxy,
|
||
widget needs to implement <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> interface. Proxies mirror the state
|
||
of the action and should change when the action’s state changes. Properties
|
||
that are always mirrored by proxies are <a class="link" href="GtkAction.html#GtkAction--sensitive" title="The “sensitive” property"><span class="type">“sensitive”</span></a> and
|
||
<a class="link" href="GtkAction.html#GtkAction--visible" title="The “visible” property"><span class="type">“visible”</span></a>. <a class="link" href="GtkAction.html#GtkAction--gicon" title="The “gicon” property"><span class="type">“gicon”</span></a>, <a class="link" href="GtkAction.html#GtkAction--icon-name" title="The “icon-name” property"><span class="type">“icon-name”</span></a>, <a class="link" href="GtkAction.html#GtkAction--label" title="The “label” property"><span class="type">“label”</span></a>,
|
||
<a class="link" href="GtkAction.html#GtkAction--short-label" title="The “short-label” property"><span class="type">“short-label”</span></a> and <a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> properties are only mirorred
|
||
if proxy widget has <a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> property set to
|
||
<code class="literal">TRUE</code>.</p>
|
||
<p>When the proxy is activated, it should activate its action.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-new"></a><h3>gtk_action_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkAction.html" title="GtkAction"><span class="returnvalue">GtkAction</span></a> *
|
||
gtk_action_new (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_new</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, associating it to a widget with
|
||
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> or creating a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> with <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()"><code class="function">gtk_menu_new_from_model()</code></a></p>
|
||
</div>
|
||
<p>Creates a new <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> object. To add the action to a
|
||
<a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> and set the accelerator for the action,
|
||
call <a class="link" href="GtkActionGroup.html#gtk-action-group-add-action-with-accel" title="gtk_action_group_add_action_with_accel ()"><code class="function">gtk_action_group_add_action_with_accel()</code></a>.
|
||
See the <a class="link" href="GtkUIManager.html#XML-UI" title="UI Definitions">UI Definition section</a> for information on allowed action
|
||
names.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-new.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>A unique name for the action</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>label</p></td>
|
||
<td class="parameter_description"><p>the label displayed in menu items and on buttons,
|
||
or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tooltip</p></td>
|
||
<td class="parameter_description"><p>a tooltip for the action, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>stock_id</p></td>
|
||
<td class="parameter_description"><p>the stock icon to display in widgets representing
|
||
the action, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-new.returns"></a><h4>Returns</h4>
|
||
<p> a new <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-name"></a><h3>gtk_action_get_name ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_name (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_action_get_name()</code> on a <span class="type">GAction</span> instead</p>
|
||
</div>
|
||
<p>Returns the name of the action.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-name.returns"></a><h4>Returns</h4>
|
||
<p> the name of the action. The string belongs to GTK+ and should not
|
||
be freed.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-is-sensitive"></a><h3>gtk_action_is_sensitive ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_is_sensitive (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_is_sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_action_get_enabled()</code> on a <span class="type">GAction</span>
|
||
instead</p>
|
||
</div>
|
||
<p>Returns whether the action is effectively sensitive.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-is-sensitive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-is-sensitive.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the action and its associated action group
|
||
are both sensitive.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-sensitive"></a><h3>gtk_action_get_sensitive ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_get_sensitive (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_action_get_enabled()</code> on a <span class="type">GAction</span>
|
||
instead</p>
|
||
</div>
|
||
<p>Returns whether the action itself is sensitive. Note that this doesn’t
|
||
necessarily mean effective sensitivity. See <a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()"><code class="function">gtk_action_is_sensitive()</code></a>
|
||
for that.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-sensitive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-sensitive.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the action itself is sensitive.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-sensitive"></a><h3>gtk_action_set_sensitive ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_sensitive (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> sensitive</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_simple_action_set_enabled()</code> on a <span class="type">GSimpleAction</span>
|
||
instead</p>
|
||
</div>
|
||
<p>Sets the :sensitive property of the action to <em class="parameter"><code>sensitive</code></em>
|
||
. Note that
|
||
this doesn’t necessarily mean effective sensitivity. See
|
||
<a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()"><code class="function">gtk_action_is_sensitive()</code></a>
|
||
for that.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-sensitive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>sensitive</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to make the action sensitive</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-is-visible"></a><h3>gtk_action_is_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_is_visible (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_is_visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the state of
|
||
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets directly</p>
|
||
</div>
|
||
<p>Returns whether the action is effectively visible.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-is-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-is-visible.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the action and its associated action group
|
||
are both visible.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-visible"></a><h3>gtk_action_get_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_get_visible (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the state of
|
||
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets directly</p>
|
||
</div>
|
||
<p>Returns whether the action itself is visible. Note that this doesn’t
|
||
necessarily mean effective visibility. See <a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()"><code class="function">gtk_action_is_sensitive()</code></a>
|
||
for that.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-visible.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the action itself is visible.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-visible"></a><h3>gtk_action_set_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_visible (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> visible</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the state of
|
||
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets directly</p>
|
||
</div>
|
||
<p>Sets the :visible property of the action to <em class="parameter"><code>visible</code></em>
|
||
. Note that
|
||
this doesn’t necessarily mean effective visibility. See
|
||
<a class="link" href="GtkAction.html#gtk-action-is-visible" title="gtk_action_is_visible ()"><code class="function">gtk_action_is_visible()</code></a>
|
||
for that.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>visible</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to make the action visible</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-activate"></a><h3>gtk_action_activate ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_activate (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_action_group_activate_action()</code> on a <span class="type">GAction</span> instead</p>
|
||
</div>
|
||
<p>Emits the “activate” signal on the specified action, if it isn't
|
||
insensitive. This gets called by the proxy widgets when they get
|
||
activated.</p>
|
||
<p>It can also be used to manually activate an action.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-activate.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-create-icon"></a><h3>gtk_action_create_icon ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_action_create_icon (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_create_icon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_menu_item_set_icon()</code> to set an icon on a <span class="type">GMenuItem</span>,
|
||
or <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to add a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></p>
|
||
</div>
|
||
<p>This function is intended for use by action implementations to
|
||
create icons displayed in the proxy widgets.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-icon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_size</p></td>
|
||
<td class="parameter_description"><p>the size of the icon (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>) that should
|
||
be created. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-icon.returns"></a><h4>Returns</h4>
|
||
<p>a widget that displays the icon for this action. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-create-menu-item"></a><h3>gtk_action_create_menu_item ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_action_create_menu_item (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_create_menu_item</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_menu_item_new()</code> and associate it with a <span class="type">GAction</span>
|
||
instead.</p>
|
||
</div>
|
||
<p>Creates a menu item widget that proxies for the given action.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-menu-item.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-menu-item.returns"></a><h4>Returns</h4>
|
||
<p>a menu item connected to the action. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-create-tool-item"></a><h3>gtk_action_create_tool_item ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_action_create_tool_item (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_create_tool_item</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> and associate it with a <span class="type">GAction</span> using
|
||
<a class="link" href="GtkActionable.html#gtk-actionable-set-action-name" title="gtk_actionable_set_action_name ()"><code class="function">gtk_actionable_set_action_name()</code></a> instead</p>
|
||
</div>
|
||
<p>Creates a toolbar item widget that proxies for the given action.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-tool-item.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-tool-item.returns"></a><h4>Returns</h4>
|
||
<p>a toolbar item connected to the action. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-create-menu"></a><h3>gtk_action_create_menu ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_action_create_menu (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_create_menu</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and <span class="type">GMenuModel</span> instead, and create a
|
||
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> with <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()"><code class="function">gtk_menu_new_from_model()</code></a></p>
|
||
</div>
|
||
<p>If <em class="parameter"><code>action</code></em>
|
||
provides a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> widget as a submenu for the menu
|
||
item or the toolbar item it creates, this function returns an
|
||
instance of that menu.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-menu.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-create-menu.returns"></a><h4>Returns</h4>
|
||
<p>the menu item provided by the
|
||
action, or <code class="literal">NULL</code>. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-proxies"></a><h3>gtk_action_get_proxies ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GSList</span> *
|
||
gtk_action_get_proxies (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gtk_action_get_proxies</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Returns the proxy widgets for an action.
|
||
See also <a class="link" href="GtkActivatable.html#gtk-activatable-get-related-action" title="gtk_activatable_get_related_action ()"><code class="function">gtk_activatable_get_related_action()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-proxies.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-proxies.returns"></a><h4>Returns</h4>
|
||
<p>a <span class="type">GSList</span> of proxy widgets. The list is owned by GTK+
|
||
and must not be modified. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-connect-accelerator"></a><h3>gtk_action_connect_accelerator ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_connect_accelerator (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_connect_accelerator</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and the accelerator group on an associated
|
||
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
|
||
</div>
|
||
<p>Installs the accelerator for <em class="parameter"><code>action</code></em>
|
||
if <em class="parameter"><code>action</code></em>
|
||
has an
|
||
accel path and group. See <a class="link" href="GtkAction.html#gtk-action-set-accel-path" title="gtk_action_set_accel_path ()"><code class="function">gtk_action_set_accel_path()</code></a> and
|
||
<a class="link" href="GtkAction.html#gtk-action-set-accel-group" title="gtk_action_set_accel_group ()"><code class="function">gtk_action_set_accel_group()</code></a></p>
|
||
<p>Since multiple proxies may independently trigger the installation
|
||
of the accelerator, the <em class="parameter"><code>action</code></em>
|
||
counts the number of times this
|
||
function has been called and doesn’t remove the accelerator until
|
||
<a class="link" href="GtkAction.html#gtk-action-disconnect-accelerator" title="gtk_action_disconnect_accelerator ()"><code class="function">gtk_action_disconnect_accelerator()</code></a> has been called as many times.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-connect-accelerator.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-disconnect-accelerator"></a><h3>gtk_action_disconnect_accelerator ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_disconnect_accelerator (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_disconnect_accelerator</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and the accelerator group on an associated
|
||
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
|
||
</div>
|
||
<p>Undoes the effect of one call to <a class="link" href="GtkAction.html#gtk-action-connect-accelerator" title="gtk_action_connect_accelerator ()"><code class="function">gtk_action_connect_accelerator()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-disconnect-accelerator.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-block-activate"></a><h3>gtk_action_block_activate ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_block_activate (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_block_activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_simple_action_set_enabled()</code> to disable the
|
||
<span class="type">GSimpleAction</span> instead</p>
|
||
</div>
|
||
<p>Disable activation signals from the action </p>
|
||
<p>This is needed when updating the state of your proxy
|
||
<a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> widget could result in calling <a class="link" href="GtkAction.html#gtk-action-activate" title="gtk_action_activate ()"><code class="function">gtk_action_activate()</code></a>,
|
||
this is a convenience function to avoid recursing in those
|
||
cases (updating toggle state for instance).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-block-activate.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-unblock-activate"></a><h3>gtk_action_unblock_activate ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_unblock_activate (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_unblock_activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_simple_action_set_enabled()</code> to enable the
|
||
<span class="type">GSimpleAction</span> instead</p>
|
||
</div>
|
||
<p>Reenable activation signals from the action</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-unblock-activate.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-always-show-image"></a><h3>gtk_action_get_always_show_image ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_get_always_show_image (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_always_show_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_menu_item_get_attribute_value()</code> on a <span class="type">GMenuItem</span>
|
||
instead</p>
|
||
</div>
|
||
<p>Returns whether <em class="parameter"><code>action</code></em>
|
||
's menu item proxies will always
|
||
show their image, if available.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-always-show-image.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-always-show-image.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the menu item proxies will always show their image</p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-always-show-image"></a><h3>gtk_action_set_always_show_image ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_always_show_image (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> always_show</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_always_show_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <code class="function">g_menu_item_set_icon()</code> on a <span class="type">GMenuItem</span> instead, if the
|
||
item should have an image</p>
|
||
</div>
|
||
<p>Sets whether <em class="parameter"><code>action</code></em>
|
||
's menu item proxies will ignore the
|
||
<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a> setting and always show their image, if available.</p>
|
||
<p>Use this if the menu item would be useless or hard to use
|
||
without their image.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-always-show-image.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>always_show</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if menuitem proxies should always show their image</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-accel-path"></a><h3>gtk_action_get_accel_path ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_accel_path (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_accel_path</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and the accelerator path on an associated
|
||
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
|
||
</div>
|
||
<p>Returns the accel path for this action.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-accel-path.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-accel-path.returns"></a><h4>Returns</h4>
|
||
<p> the accel path for this action, or <code class="literal">NULL</code>
|
||
if none is set. The returned string is owned by GTK+
|
||
and must not be freed or modified.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-accel-path"></a><h3>gtk_action_set_accel_path ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_accel_path (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *accel_path</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_accel_path</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and the accelerator path on an associated
|
||
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
|
||
</div>
|
||
<p>Sets the accel path for this action. All proxy widgets associated
|
||
with the action will have this accel path, so that their
|
||
accelerators are consistent.</p>
|
||
<p>Note that <em class="parameter"><code>accel_path</code></em>
|
||
string will be stored in a <span class="type">GQuark</span>. Therefore, if you
|
||
pass a static string, you can save some memory by interning it first with
|
||
<code class="function">g_intern_static_string()</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-accel-path.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>accel_path</p></td>
|
||
<td class="parameter_description"><p>the accelerator path</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-accel-closure"></a><h3>gtk_action_get_accel_closure ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GClosure</span> *
|
||
gtk_action_get_accel_closure (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_accel_closure</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead, which have no
|
||
equivalent for getting the accel closure</p>
|
||
</div>
|
||
<p>Returns the accel closure for this action.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-accel-closure.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-accel-closure.returns"></a><h4>Returns</h4>
|
||
<p>the accel closure for this action. The
|
||
returned closure is owned by GTK+ and must not be unreffed
|
||
or modified. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-accel-group"></a><h3>gtk_action_set_accel_group ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_accel_group (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_accel_group</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> and the accelerator group on an associated
|
||
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
|
||
</div>
|
||
<p>Sets the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> in which the accelerator for this action
|
||
will be installed.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-accel-group.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>accel_group</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-label"></a><h3>gtk_action_set_label ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and set a label on a menu item with
|
||
<code class="function">g_menu_item_set_label()</code>. For <a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets, use the widget-specific
|
||
API to set a label</p>
|
||
</div>
|
||
<p>Sets the label of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>label</p></td>
|
||
<td class="parameter_description"><p>the label text to set</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-label"></a><h3>gtk_action_get_label ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and get a label from a menu item
|
||
with <code class="function">g_menu_item_get_attribute_value()</code>. For <a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets, use the
|
||
widget-specific API to get a label</p>
|
||
</div>
|
||
<p>Gets the label text of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-label.returns"></a><h4>Returns</h4>
|
||
<p> the label text</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-short-label"></a><h3>gtk_action_set_short_label ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_short_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *short_label</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_short_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, which has no equivalent of short
|
||
labels</p>
|
||
</div>
|
||
<p>Sets a shorter label text on <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-short-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>short_label</p></td>
|
||
<td class="parameter_description"><p>the label text to set</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-short-label"></a><h3>gtk_action_get_short_label ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_short_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_short_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, which has no equivalent of short
|
||
labels</p>
|
||
</div>
|
||
<p>Gets the short label text of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-short-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-short-label.returns"></a><h4>Returns</h4>
|
||
<p> the short label text.</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-tooltip"></a><h3>gtk_action_set_tooltip ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_tooltip (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_tooltip</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and set tooltips on associated
|
||
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets with <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a></p>
|
||
</div>
|
||
<p>Sets the tooltip text on <em class="parameter"><code>action</code></em>
|
||
</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-tooltip.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tooltip</p></td>
|
||
<td class="parameter_description"><p>the tooltip text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-tooltip"></a><h3>gtk_action_get_tooltip ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_tooltip (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_tooltip</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and get tooltips from associated
|
||
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets with <a class="link" href="GtkWidget.html#gtk-widget-get-tooltip-text" title="gtk_widget_get_tooltip_text ()"><code class="function">gtk_widget_get_tooltip_text()</code></a></p>
|
||
</div>
|
||
<p>Gets the tooltip text of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-tooltip.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-tooltip.returns"></a><h4>Returns</h4>
|
||
<p> the tooltip text</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-stock-id"></a><h3>gtk_action_set_stock_id ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_stock_id (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_stock_id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, which has no equivalent of stock
|
||
items</p>
|
||
</div>
|
||
<p>Sets the stock id on <em class="parameter"><code>action</code></em>
|
||
</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-stock-id.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>stock_id</p></td>
|
||
<td class="parameter_description"><p>the stock id</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-stock-id"></a><h3>gtk_action_get_stock_id ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_stock_id (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_stock_id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, which has no equivalent of stock
|
||
items</p>
|
||
</div>
|
||
<p>Gets the stock id of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-stock-id.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-stock-id.returns"></a><h4>Returns</h4>
|
||
<p> the stock id</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-gicon"></a><h3>gtk_action_set_gicon ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_gicon (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_gicon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and <code class="function">g_menu_item_set_icon()</code> to set an
|
||
icon on a <span class="type">GMenuItem</span> associated with a <span class="type">GAction</span>, or <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to
|
||
add a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></p>
|
||
</div>
|
||
<p>Sets the icon of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-gicon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon</p></td>
|
||
<td class="parameter_description"><p>the <span class="type">GIcon</span> to set</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-gicon"></a><h3>gtk_action_get_gicon ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GIcon</span> *
|
||
gtk_action_get_gicon (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_gicon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and
|
||
<code class="function">g_menu_item_get_attribute_value()</code> to get an icon from a <span class="type">GMenuItem</span>
|
||
associated with a <span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Gets the gicon of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-gicon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-gicon.returns"></a><h4>Returns</h4>
|
||
<p>The action’s <span class="type">GIcon</span> if one is set. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-icon-name"></a><h3>gtk_action_set_icon_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_icon_name (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_icon_name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and <code class="function">g_menu_item_set_icon()</code> to set an
|
||
icon on a <span class="type">GMenuItem</span> associated with a <span class="type">GAction</span>, or <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to
|
||
add a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></p>
|
||
</div>
|
||
<p>Sets the icon name on <em class="parameter"><code>action</code></em>
|
||
</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_name</p></td>
|
||
<td class="parameter_description"><p>the icon name to set</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-icon-name"></a><h3>gtk_action_get_icon_name ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_action_get_icon_name (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_icon_name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and
|
||
<code class="function">g_menu_item_get_attribute_value()</code> to get an icon from a <span class="type">GMenuItem</span>
|
||
associated with a <span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Gets the icon name of <em class="parameter"><code>action</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-icon-name.returns"></a><h4>Returns</h4>
|
||
<p> the icon name</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-visible-horizontal"></a><h3>gtk_action_set_visible_horizontal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_visible_horizontal (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> visible_horizontal</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_visible_horizontal</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the
|
||
visibility of associated widgets and menu items directly</p>
|
||
</div>
|
||
<p>Sets whether <em class="parameter"><code>action</code></em>
|
||
is visible when horizontal</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-visible-horizontal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>visible_horizontal</p></td>
|
||
<td class="parameter_description"><p>whether the action is visible horizontally</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-visible-horizontal"></a><h3>gtk_action_get_visible_horizontal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_get_visible_horizontal (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_visible_horizontal</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the
|
||
visibility of associated widgets and menu items directly</p>
|
||
</div>
|
||
<p>Checks whether <em class="parameter"><code>action</code></em>
|
||
is visible when horizontal</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-visible-horizontal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-visible-horizontal.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>action</code></em>
|
||
is visible when horizontal</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-visible-vertical"></a><h3>gtk_action_set_visible_vertical ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_visible_vertical (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> visible_vertical</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_visible_vertical</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the
|
||
visibility of associated widgets and menu items directly</p>
|
||
</div>
|
||
<p>Sets whether <em class="parameter"><code>action</code></em>
|
||
is visible when vertical</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-visible-vertical.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>visible_vertical</p></td>
|
||
<td class="parameter_description"><p>whether the action is visible vertically</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-visible-vertical"></a><h3>gtk_action_get_visible_vertical ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_get_visible_vertical (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_visible_vertical</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor the
|
||
visibility of associated widgets and menu items directly</p>
|
||
</div>
|
||
<p>Checks whether <em class="parameter"><code>action</code></em>
|
||
is visible when horizontal</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-visible-vertical.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-visible-vertical.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>action</code></em>
|
||
is visible when horizontal</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-set-is-important"></a><h3>gtk_action_set_is_important ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_action_set_is_important (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> is_important</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_set_is_important</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor whether
|
||
labels are shown directly</p>
|
||
</div>
|
||
<p>Sets whether the action is important, this attribute is used
|
||
primarily by toolbar items to decide whether to show a label
|
||
or not.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-set-is-important.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the action object</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>is_important</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to make the action important</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-action-get-is-important"></a><h3>gtk_action_get_is_important ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_action_get_is_important (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_action_get_is_important</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">GAction</span> instead, and control and monitor whether
|
||
labels are shown directly</p>
|
||
</div>
|
||
<p>Checks whether <em class="parameter"><code>action</code></em>
|
||
is important or not</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-is-important.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-action-get-is-important.returns"></a><h4>Returns</h4>
|
||
<p> whether <em class="parameter"><code>action</code></em>
|
||
is important</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkAction-struct"></a><h3>struct GtkAction</h3>
|
||
<pre class="programlisting">struct GtkAction;</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkActionClass"></a><h3>struct GtkActionClass</h3>
|
||
<pre class="programlisting">struct GtkActionClass {
|
||
GObjectClass parent_class;
|
||
|
||
|
||
/* activation signal */
|
||
void (* activate) (GtkAction *action);
|
||
};
|
||
</pre>
|
||
<div class="refsect3">
|
||
<a name="GtkActionClass.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="struct_members_name">
|
||
<col class="struct_members_description">
|
||
<col width="200px" class="struct_members_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkActionClass.activate"></a>activate</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Signal emitted when the action is activated.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--action-group"></a><h3>The <code class="literal">“action-group”</code> property</h3>
|
||
<pre class="programlisting"> “action-group” <a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> *</pre>
|
||
<p>The GtkActionGroup this GtkAction is associated with, or NULL
|
||
(for internal use).</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:action-group</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Lookup the <span class="type">GAction</span> using <code class="function">g_action_map_lookup_action()</code>
|
||
instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--always-show-image"></a><h3>The <code class="literal">“always-show-image”</code> property</h3>
|
||
<pre class="programlisting"> “always-show-image” <span class="type">gboolean</span></pre>
|
||
<p>If <code class="literal">TRUE</code>, the action's menu item proxies will ignore the <a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a>
|
||
|
||
setting and always show their image, if available.</p>
|
||
<p>Use this property if the menu item would be useless or hard to use
|
||
without their image.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:always-show-image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write / Construct</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--gicon"></a><h3>The <code class="literal">“gicon”</code> property</h3>
|
||
<pre class="programlisting"> “gicon” <span class="type">GIcon</span> *</pre>
|
||
<p>The <span class="type">GIcon</span> displayed in the <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>.</p>
|
||
<p>Note that the stock icon is preferred, if the <a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a>
|
||
|
||
property holds the id of an existing stock icon.</p>
|
||
<p>This is an appearance property and thus only applies if
|
||
|
||
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:gicon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use the "icon" attribute on a <span class="type">GMenuItem</span> instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--hide-if-empty"></a><h3>The <code class="literal">“hide-if-empty”</code> property</h3>
|
||
<pre class="programlisting"> “hide-if-empty” <span class="type">gboolean</span></pre>
|
||
<p>When TRUE, empty menu proxies for this action are hidden.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:hide-if-empty</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
|
||
<pre class="programlisting"> “icon-name” <span class="type">gchar</span> *</pre>
|
||
<p>The name of the icon from the icon theme. </p>
|
||
<p>Note that the stock icon is preferred, if the <a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a>
|
||
|
||
property holds the id of an existing stock icon, and the <span class="type">GIcon</span> is
|
||
preferred if the <a class="link" href="GtkAction.html#GtkAction--gicon" title="The “gicon” property"><span class="type">“gicon”</span></a> property is set. </p>
|
||
<p>This is an appearance property and thus only applies if
|
||
|
||
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:icon-name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use the "icon" attribute on a <span class="type">GMenuItem</span> instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--is-important"></a><h3>The <code class="literal">“is-important”</code> property</h3>
|
||
<pre class="programlisting"> “is-important” <span class="type">gboolean</span></pre>
|
||
<p>Whether the action is considered important. When TRUE, toolitem
|
||
proxies for this action show text in GTK_TOOLBAR_BOTH_HORIZ mode.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:is-important</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--label"></a><h3>The <code class="literal">“label”</code> property</h3>
|
||
<pre class="programlisting"> “label” <span class="type">gchar</span> *</pre>
|
||
<p>The label used for menu items and buttons that activate
|
||
this action. If the label is <code class="literal">NULL</code>, GTK+ uses the stock
|
||
|
||
label specified via the stock-id property.</p>
|
||
<p>This is an appearance property and thus only applies if
|
||
|
||
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use the "label" attribute on <span class="type">GMenuItem</span> instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--name"></a><h3>The <code class="literal">“name”</code> property</h3>
|
||
<pre class="programlisting"> “name” <span class="type">gchar</span> *</pre>
|
||
<p>A unique name for the action.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">“name”</span> instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write / Construct Only</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--sensitive"></a><h3>The <code class="literal">“sensitive”</code> property</h3>
|
||
<pre class="programlisting"> “sensitive” <span class="type">gboolean</span></pre>
|
||
<p>Whether the action is enabled.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">“enabled”</span> and <span class="type">“enabled”</span>
|
||
instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--short-label"></a><h3>The <code class="literal">“short-label”</code> property</h3>
|
||
<pre class="programlisting"> “short-label” <span class="type">gchar</span> *</pre>
|
||
<p>A shorter label that may be used on toolbar buttons.</p>
|
||
<p>This is an appearance property and thus only applies if
|
||
|
||
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:short-label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--stock-id"></a><h3>The <code class="literal">“stock-id”</code> property</h3>
|
||
<pre class="programlisting"> “stock-id” <span class="type">gchar</span> *</pre>
|
||
<p>The stock icon displayed in widgets representing this action.</p>
|
||
<p>This is an appearance property and thus only applies if
|
||
|
||
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:stock-id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--tooltip"></a><h3>The <code class="literal">“tooltip”</code> property</h3>
|
||
<pre class="programlisting"> “tooltip” <span class="type">gchar</span> *</pre>
|
||
<p>A tooltip for this action.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:tooltip</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a> instead</p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--visible"></a><h3>The <code class="literal">“visible”</code> property</h3>
|
||
<pre class="programlisting"> “visible” <span class="type">gboolean</span></pre>
|
||
<p>Whether the action is visible.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--visible-horizontal"></a><h3>The <code class="literal">“visible-horizontal”</code> property</h3>
|
||
<pre class="programlisting"> “visible-horizontal” <span class="type">gboolean</span></pre>
|
||
<p>Whether the toolbar item is visible when the toolbar is in a horizontal orientation.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:visible-horizontal</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--visible-overflown"></a><h3>The <code class="literal">“visible-overflown”</code> property</h3>
|
||
<pre class="programlisting"> “visible-overflown” <span class="type">gboolean</span></pre>
|
||
<p>When <code class="literal">TRUE</code>, toolitem proxies for this action are represented in the
|
||
|
||
toolbar overflow menu.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:visible-overflown</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkAction--visible-vertical"></a><h3>The <code class="literal">“visible-vertical”</code> property</h3>
|
||
<pre class="programlisting"> “visible-vertical” <span class="type">gboolean</span></pre>
|
||
<p>Whether the toolbar item is visible when the toolbar is in a vertical orientation.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction:visible-vertical</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>There is no corresponding replacement when using
|
||
<span class="type">GAction</span></p>
|
||
</div>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkAction-activate"></a><h3>The <code class="literal">“activate”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The "activate" signal is emitted when the action is activated.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkAction::activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <span class="type">“activate”</span> instead</p>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GtkAction-activate.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>action</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: No Recursion</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkAction.see-also"></a><h2>See Also</h2>
|
||
<p><a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>, <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>, <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.29</div>
|
||
</body>
|
||
</html> |