<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkActivatable: GTK+ 2 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="Actions.html" title="Action-based menus and toolbars">
<link rel="prev" href="GtkRecentAction.html" title="GtkRecentAction">
<link rel="next" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<meta name="generator" content="GTK-Doc V1.26.1 (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="#GtkActivatable.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#GtkActivatable.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites"> <span class="dim">|</span>
<a href="#GtkActivatable.prerequisites" class="shortcut">Prerequisites</a></span><span id="nav_implementations"> <span class="dim">|</span>
<a href="#GtkActivatable.implementations" class="shortcut">Known Implementations</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#GtkActivatable.properties" class="shortcut">Properties</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="Actions.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkRecentAction.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="SelectorWidgets.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkActivatable"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkActivatable.top_of_page"></a>GtkActivatable</span></h2>
<p>GtkActivatable — An interface for activatable widgets</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkActivatable.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">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkActivatable.html#gtk-activatable-do-set-related-action" title="gtk_activatable_do_set_related_action ()">gtk_activatable_do_set_related_action</a> <span class="c_punctuation">()</span>
</td>
</tr>
<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="GtkActivatable.html#gtk-activatable-get-related-action" title="gtk_activatable_get_related_action ()">gtk_activatable_get_related_action</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkActivatable.html#gtk-activatable-get-use-action-appearance" title="gtk_activatable_get_use_action_appearance ()">gtk_activatable_get_use_action_appearance</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="GtkActivatable.html#gtk-activatable-sync-action-properties" title="gtk_activatable_sync_action_properties ()">gtk_activatable_sync_action_properties</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="GtkActivatable.html#gtk-activatable-set-related-action" title="gtk_activatable_set_related_action ()">gtk_activatable_set_related_action</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="GtkActivatable.html#gtk-activatable-set-use-action-appearance" title="gtk_activatable_set_use_action_appearance ()">gtk_activatable_set_use_action_appearance</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkActivatable.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="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *</td>
<td class="property_name"><a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property">related-action</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property">use-action-appearance</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkActivatable.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"> </td>
<td class="function_name"><a class="link" href="GtkActivatable.html#GtkActivatable-struct" title="GtkActivatable">GtkActivatable</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkActivatable.html#GtkActivatableIface" title="struct GtkActivatableIface">GtkActivatableIface</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkActivatable.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="/home/mclasen/gnome/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
<span class="lineart">╰──</span> GtkActivatable
</pre>
</div>
<div class="refsect1">
<a name="GtkActivatable.prerequisites"></a><h2>Prerequisites</h2>
<p>
GtkActivatable requires
<a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>.</p>
</div>
<div class="refsect1">
<a name="GtkActivatable.implementations"></a><h2>Known Implementations</h2>
<p>
GtkActivatable is implemented by
<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>, <a class="link" href="GtkCheckButton.html" title="GtkCheckButton">GtkCheckButton</a>, <a class="link" href="gtk2-gtkcheckmenuitem.html#GtkCheckMenuItem">GtkCheckMenuItem</a>, <a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a>, <a class="link" href="GtkFontButton.html" title="GtkFontButton">GtkFontButton</a>, <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem">GtkImageMenuItem</a>, <a class="link" href="GtkLinkButton.html" title="GtkLinkButton">GtkLinkButton</a>, <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>, <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton">GtkMenuToolButton</a>, <a class="link" href="GtkOptionMenu.html" title="GtkOptionMenu">GtkOptionMenu</a>, <a class="link" href="GtkRadioButton.html" title="GtkRadioButton">GtkRadioButton</a>, <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>, <a class="link" href="GtkRadioToolButton.html" title="GtkRadioToolButton">GtkRadioToolButton</a>, <a class="link" href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a>, <a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a>, <a class="link" href="GtkSeparatorMenuItem.html" title="GtkSeparatorMenuItem">GtkSeparatorMenuItem</a>, <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">GtkSeparatorToolItem</a>, <a class="link" href="GtkTearoffMenuItem.html" title="GtkTearoffMenuItem">GtkTearoffMenuItem</a>, <a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a>, <a class="link" href="GtkToggleToolButton.html" title="GtkToggleToolButton">GtkToggleToolButton</a>, <a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a>, <a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> and <a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton">GtkVolumeButton</a>.</p>
</div>
<div class="refsect1">
<a name="GtkActivatable.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include <gtk/gtk.h>
</pre>
</div>
<div class="refsect1">
<a name="GtkActivatable.description"></a><h2>Description</h2>
<p>Activatable widgets can be connected to a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> and reflects
the state of its action. A <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> can also provide feedback
through its action, as they are responsible for activating their
related actions.</p>
<div class="refsect2">
<a name="id-1.4.11.8.10.3"></a><h3>Implementing GtkActivatable</h3>
<p>
When extending a class that is already <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a>; it is only
necessary to implement the <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a>-><code class="function">sync_action_properties()</code>
and <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a>-><code class="function">update()</code> methods and chain up to the parent
implementation, however when introducing
a new <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> class; the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property"><span class="type">“related-action”</span></a> and
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> properties need to be handled by
the implementor. Handling these properties is mostly a matter of installing
the action pointer and boolean flag on your instance, and calling
<a class="link" href="GtkActivatable.html#gtk-activatable-do-set-related-action" title="gtk_activatable_do_set_related_action ()"><code class="function">gtk_activatable_do_set_related_action()</code></a> and
<a class="link" href="GtkActivatable.html#gtk-activatable-sync-action-properties" title="gtk_activatable_sync_action_properties ()"><code class="function">gtk_activatable_sync_action_properties()</code></a> at the appropriate times.
</p>
<div class="example">
<a name="id-1.4.11.8.10.3.3"></a><p class="title"><b>Example 9. A class fragment implementing <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></b></p>
<div class="example-contents">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">enum</span> <span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span>
PROP_ACTIVATABLE_RELATED_ACTION<span class="gtkdoc opt">,</span>
PROP_ACTIVATABLE_USE_ACTION_APPEARANCE
<span class="gtkdoc opt">}</span>
<span class="gtkdoc kwb">struct</span> _FooBarPrivate
<span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span>
GtkAction <span class="gtkdoc opt">*</span>action<span class="gtkdoc opt">;</span>
gboolean use_action_appearance<span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">};</span>
<span class="gtkdoc opt">...</span>
<span class="gtkdoc kwb">static void</span> <span class="function">foo_bar_activatable_interface_init</span> <span class="gtkdoc opt">(</span>GtkActivatableIface <span class="gtkdoc opt">*</span>iface<span class="gtkdoc opt">);</span>
<span class="gtkdoc kwb">static void</span> <span class="function">foo_bar_activatable_update</span> <span class="gtkdoc opt">(</span>GtkActivatable <span class="gtkdoc opt">*</span>activatable<span class="gtkdoc opt">,</span>
GtkAction <span class="gtkdoc opt">*</span>action<span class="gtkdoc opt">,</span>
<span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>property_name<span class="gtkdoc opt">);</span>
<span class="gtkdoc kwb">static void</span> <span class="function">foo_bar_activatable_sync_action_properties</span> <span class="gtkdoc opt">(</span>GtkActivatable <span class="gtkdoc opt">*</span>activatable<span class="gtkdoc opt">,</span>
GtkAction <span class="gtkdoc opt">*</span>action<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">...</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_class_init</span> <span class="gtkdoc opt">(</span>FooBarClass <span class="gtkdoc opt">*</span>klass<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-class-override-property">g_object_class_override_property</a></span> <span class="gtkdoc opt">(</span>gobject_class<span class="gtkdoc opt">,</span> PROP_ACTIVATABLE_RELATED_ACTION<span class="gtkdoc opt">,</span> <span class="string">"related-action"</span><span class="gtkdoc opt">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-class-override-property">g_object_class_override_property</a></span> <span class="gtkdoc opt">(</span>gobject_class<span class="gtkdoc opt">,</span> PROP_ACTIVATABLE_USE_ACTION_APPEARANCE<span class="gtkdoc opt">,</span> <span class="string">"use-action-appearance"</span><span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">...</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_activatable_interface_init</span> <span class="gtkdoc opt">(</span>GtkActivatableIface <span class="gtkdoc opt">*</span>iface<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
iface<span class="gtkdoc opt">-></span>update <span class="gtkdoc opt">=</span> foo_bar_activatable_update<span class="gtkdoc opt">;</span>
iface<span class="gtkdoc opt">-></span>sync_action_properties <span class="gtkdoc opt">=</span> foo_bar_activatable_sync_action_properties<span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">...</span> Break the reference <span class="keyword">using</span> <span class="function"><a href="GtkActivatable.html#gtk-activatable-do-set-related-action">gtk_activatable_do_set_related_action</a></span><span class="gtkdoc opt">()...</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_dispose</span> <span class="gtkdoc opt">(</span>GObject <span class="gtkdoc opt">*</span>object<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
FooBar <span class="gtkdoc opt">*</span>bar <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR</span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
FooBarPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">...</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>priv<span class="gtkdoc opt">-></span>action<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="function"><a href="GtkActivatable.html#gtk-activatable-do-set-related-action">gtk_activatable_do_set_related_action</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_ACTIVATABLE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
priv<span class="gtkdoc opt">-></span>action <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span> <span class="gtkdoc opt">(</span>foo_bar_parent_class<span class="gtkdoc opt">)-></span><span class="function">dispose</span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">...</span> Handle the <span class="string">"related-action"</span> <span class="keyword">and</span> <span class="string">"use-action-appearance"</span> properties <span class="gtkdoc opt">...</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_set_property</span> <span class="gtkdoc opt">(</span>GObject <span class="gtkdoc opt">*</span>object<span class="gtkdoc opt">,</span>
guint prop_id<span class="gtkdoc opt">,</span>
<span class="gtkdoc kwb">const</span> GValue <span class="gtkdoc opt">*</span>value<span class="gtkdoc opt">,</span>
GParamSpec <span class="gtkdoc opt">*</span>pspec<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
FooBar <span class="gtkdoc opt">*</span>bar <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR</span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
FooBarPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">);</span>
<span class="keyword">switch</span> <span class="gtkdoc opt">(</span>prop_id<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span>
<span class="keyword">case</span> PROP_ACTIVATABLE_RELATED_ACTION<span class="gtkdoc opt">:</span>
<span class="function">foo_bar_set_related_action</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">,</span> <span class="function"><a href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#g-value-get-object">g_value_get_object</a></span> <span class="gtkdoc opt">(</span>value<span class="gtkdoc opt">));</span>
<span class="keyword">break</span><span class="gtkdoc opt">;</span>
<span class="keyword">case</span> PROP_ACTIVATABLE_USE_ACTION_APPEARANCE<span class="gtkdoc opt">:</span>
<span class="function">foo_bar_set_use_action_appearance</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">,</span> <span class="function"><a href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#g-value-get-boolean">g_value_get_boolean</a></span> <span class="gtkdoc opt">(</span>value<span class="gtkdoc opt">));</span>
<span class="keyword">break</span><span class="gtkdoc opt">;</span>
<span class="keyword">default</span><span class="gtkdoc opt">:</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT-WARN-INVALID-PROPERTY-ID:CAPS">G_OBJECT_WARN_INVALID_PROPERTY_ID</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">,</span> prop_id<span class="gtkdoc opt">,</span> pspec<span class="gtkdoc opt">);</span>
<span class="keyword">break</span><span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_get_property</span> <span class="gtkdoc opt">(</span>GObject <span class="gtkdoc opt">*</span>object<span class="gtkdoc opt">,</span>
guint prop_id<span class="gtkdoc opt">,</span>
GValue <span class="gtkdoc opt">*</span>value<span class="gtkdoc opt">,</span>
GParamSpec <span class="gtkdoc opt">*</span>pspec<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
FooBar <span class="gtkdoc opt">*</span>bar <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR</span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
FooBarPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">);</span>
<span class="keyword">switch</span> <span class="gtkdoc opt">(</span>prop_id<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="gtkdoc opt">...</span>
<span class="keyword">case</span> PROP_ACTIVATABLE_RELATED_ACTION<span class="gtkdoc opt">:</span>
<span class="function"><a href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#g-value-set-object">g_value_set_object</a></span> <span class="gtkdoc opt">(</span>value<span class="gtkdoc opt">,</span> priv<span class="gtkdoc opt">-></span>action<span class="gtkdoc opt">);</span>
<span class="keyword">break</span><span class="gtkdoc opt">;</span>
<span class="keyword">case</span> PROP_ACTIVATABLE_USE_ACTION_APPEARANCE<span class="gtkdoc opt">:</span>
<span class="function"><a href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#g-value-set-boolean">g_value_set_boolean</a></span> <span class="gtkdoc opt">(</span>value<span class="gtkdoc opt">,</span> priv<span class="gtkdoc opt">-></span>use_action_appearance<span class="gtkdoc opt">);</span>
<span class="keyword">break</span><span class="gtkdoc opt">;</span>
<span class="keyword">default</span><span class="gtkdoc opt">:</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT-WARN-INVALID-PROPERTY-ID:CAPS">G_OBJECT_WARN_INVALID_PROPERTY_ID</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">,</span> prop_id<span class="gtkdoc opt">,</span> pspec<span class="gtkdoc opt">);</span>
<span class="keyword">break</span><span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_set_use_action_appearance</span> <span class="gtkdoc opt">(</span>FooBar <span class="gtkdoc opt">*</span>bar<span class="gtkdoc opt">,</span>
gboolean use_appearance<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
FooBarPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">);</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>priv<span class="gtkdoc opt">-></span>use_action_appearance <span class="gtkdoc opt">!=</span> use_appearance<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
priv<span class="gtkdoc opt">-></span>use_action_appearance <span class="gtkdoc opt">=</span> use_appearance<span class="gtkdoc opt">;</span>
<span class="function"><a href="GtkActivatable.html#gtk-activatable-sync-action-properties">gtk_activatable_sync_action_properties</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_ACTIVATABLE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">),</span> priv<span class="gtkdoc opt">-></span>action<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">...</span> call <span class="function"><a href="GtkActivatable.html#gtk-activatable-do-set-related-action">gtk_activatable_do_set_related_action</a></span><span class="gtkdoc opt">()</span> <span class="keyword">and</span> then assign the action pointer<span class="gtkdoc opt">,</span>
no need to reference the action here since <span class="function"><a href="GtkActivatable.html#gtk-activatable-do-set-related-action">gtk_activatable_do_set_related_action</a></span><span class="gtkdoc opt">()</span> already
holds a reference here <span class="keyword">for</span> you<span class="gtkdoc opt">...</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_set_related_action</span> <span class="gtkdoc opt">(</span>FooBar <span class="gtkdoc opt">*</span>bar<span class="gtkdoc opt">,</span>
GtkAction <span class="gtkdoc opt">*</span>action<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
FooBarPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">);</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>priv<span class="gtkdoc opt">-></span>action <span class="gtkdoc opt">==</span> action<span class="gtkdoc opt">)</span>
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
<span class="function"><a href="GtkActivatable.html#gtk-activatable-do-set-related-action">gtk_activatable_do_set_related_action</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_ACTIVATABLE</span> <span class="gtkdoc opt">(</span>bar<span class="gtkdoc opt">),</span> action<span class="gtkdoc opt">);</span>
priv<span class="gtkdoc opt">-></span>action <span class="gtkdoc opt">=</span> action<span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">...</span> Selectively reset <span class="keyword">and</span> update activatable depending on the use<span class="gtkdoc opt">-</span>action<span class="gtkdoc opt">-</span>appearance property <span class="gtkdoc opt">...</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">gtk_button_activatable_sync_action_properties</span> <span class="gtkdoc opt">(</span>GtkActivatable <span class="gtkdoc opt">*</span>activatable<span class="gtkdoc opt">,</span>
GtkAction <span class="gtkdoc opt">*</span>action<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
GtkButtonPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">GTK_BUTTON_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">);</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(!</span>action<span class="gtkdoc opt">)</span>
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GtkAction.html#gtk-action-is-visible">gtk_action_is_visible</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">))</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_WIDGET</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">));</span>
<span class="keyword">else</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-hide">gtk_widget_hide</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_WIDGET</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">));</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-set-sensitive">gtk_widget_set_sensitive</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_WIDGET</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">),</span> <span class="function"><a href="GtkAction.html#gtk-action-is-sensitive">gtk_action_is_sensitive</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">));</span>
<span class="gtkdoc opt">...</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span>priv<span class="gtkdoc opt">-></span>use_action_appearance<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GtkAction.html#gtk-action-get-stock-id">gtk_action_get_stock_id</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">))</span>
<span class="function">foo_bar_set_stock</span> <span class="gtkdoc opt">(</span>button<span class="gtkdoc opt">,</span> <span class="function"><a href="GtkAction.html#gtk-action-get-stock-id">gtk_action_get_stock_id</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">));</span>
<span class="keyword">else if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GtkAction.html#gtk-action-get-label">gtk_action_get_label</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">))</span>
<span class="function">foo_bar_set_label</span> <span class="gtkdoc opt">(</span>button<span class="gtkdoc opt">,</span> <span class="function"><a href="GtkAction.html#gtk-action-get-label">gtk_action_get_label</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">));</span>
<span class="gtkdoc opt">...</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc opt">}</span>
<span class="gtkdoc kwb">static void</span>
<span class="function">foo_bar_activatable_update</span> <span class="gtkdoc opt">(</span>GtkActivatable <span class="gtkdoc opt">*</span>activatable<span class="gtkdoc opt">,</span>
GtkAction <span class="gtkdoc opt">*</span>action<span class="gtkdoc opt">,</span>
<span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>property_name<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
FooBarPrivate <span class="gtkdoc opt">*</span>priv <span class="gtkdoc opt">=</span> <span class="function">FOO_BAR_GET_PRIVATE</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">);</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function">strcmp</span> <span class="gtkdoc opt">(</span>property_name<span class="gtkdoc opt">,</span> <span class="string">"visible"</span><span class="gtkdoc opt">) ==</span> <span class="number">0</span><span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GtkAction.html#gtk-action-is-visible">gtk_action_is_visible</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">))</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_WIDGET</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">));</span>
<span class="keyword">else</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-hide">gtk_widget_hide</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_WIDGET</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">));</span>
<span class="gtkdoc opt">}</span>
<span class="keyword">else if</span> <span class="gtkdoc opt">(</span><span class="function">strcmp</span> <span class="gtkdoc opt">(</span>property_name<span class="gtkdoc opt">,</span> <span class="string">"sensitive"</span><span class="gtkdoc opt">) ==</span> <span class="number">0</span><span class="gtkdoc opt">)</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-set-sensitive">gtk_widget_set_sensitive</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_WIDGET</span> <span class="gtkdoc opt">(</span>activatable<span class="gtkdoc opt">),</span> <span class="function"><a href="GtkAction.html#gtk-action-is-sensitive">gtk_action_is_sensitive</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">));</span>
<span class="gtkdoc opt">...</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(!</span>priv<span class="gtkdoc opt">-></span>use_action_appearance<span class="gtkdoc opt">)</span>
<span class="keyword">return</span><span class="gtkdoc opt">;</span>
<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function">strcmp</span> <span class="gtkdoc opt">(</span>property_name<span class="gtkdoc opt">,</span> <span class="string">"stock-id"</span><span class="gtkdoc opt">) ==</span> <span class="number">0</span><span class="gtkdoc opt">)</span>
<span class="function">foo_bar_set_stock</span> <span class="gtkdoc opt">(</span>button<span class="gtkdoc opt">,</span> <span class="function"><a href="GtkAction.html#gtk-action-get-stock-id">gtk_action_get_stock_id</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">));</span>
<span class="keyword">else if</span> <span class="gtkdoc opt">(</span><span class="function">strcmp</span> <span class="gtkdoc opt">(</span>property_name<span class="gtkdoc opt">,</span> <span class="string">"label"</span><span class="gtkdoc opt">) ==</span> <span class="number">0</span><span class="gtkdoc opt">)</span>
<span class="function">foo_bar_set_label</span> <span class="gtkdoc opt">(</span>button<span class="gtkdoc opt">,</span> <span class="function"><a href="GtkAction.html#gtk-action-get-label">gtk_action_get_label</a></span> <span class="gtkdoc opt">(</span>action<span class="gtkdoc opt">));</span>
<span class="gtkdoc opt">...</span>
<span class="gtkdoc opt">}</span></pre></td>
</tr>
</tbody>
</table>
</div>
</div>
<br class="example-break">
</div>
</div>
<div class="refsect1">
<a name="GtkActivatable.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-activatable-do-set-related-action"></a><h3>gtk_activatable_do_set_related_action ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_activatable_do_set_related_action (<em class="parameter"><code><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> *activatable</code></em>,
<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<p>This is a utility function for <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> implementors.</p>
<p>When implementing <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> you must call this when
handling changes of the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property"><span class="type">“related-action”</span></a>, and
you must also use this to break references in <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>-><code class="function">dispose()</code>.</p>
<p>This function adds a reference to the currently set related
action for you, it also makes sure the <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a>-><code class="function">update()</code>
method is called when the related <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> properties change
and registers to the action's proxy list.</p>
<div class="note"><p>Be careful to call this before setting the local
copy of the <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> property, since this function uses
<code class="function">gtk_activatable_get_action()</code> to retrieve the previous action</p></div>
<div class="refsect3">
<a name="gtk-activatable-do-set-related-action.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>activatable</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<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> to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-get-related-action"></a><h3>gtk_activatable_get_related_action ()</h3>
<pre class="programlisting"><a class="link" href="GtkAction.html" title="GtkAction"><span class="returnvalue">GtkAction</span></a> *
gtk_activatable_get_related_action (<em class="parameter"><code><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> *activatable</code></em>);</pre>
<p>Gets the related <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> for <em class="parameter"><code>activatable</code></em>
.</p>
<div class="refsect3">
<a name="gtk-activatable-get-related-action.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>activatable</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-activatable-get-related-action.returns"></a><h4>Returns</h4>
<p>the related <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> 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: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-get-use-action-appearance"></a><h3>gtk_activatable_get_use_action_appearance ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_activatable_get_use_action_appearance
(<em class="parameter"><code><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> *activatable</code></em>);</pre>
<p>Gets whether this activatable should reset its layout
and appearance when setting the related action or when
the action changes appearance.</p>
<div class="refsect3">
<a name="gtk-activatable-get-use-action-appearance.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>activatable</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-activatable-get-use-action-appearance.returns"></a><h4>Returns</h4>
<p> whether <em class="parameter"><code>activatable</code></em>
uses its actions appearance.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-sync-action-properties"></a><h3>gtk_activatable_sync_action_properties ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_activatable_sync_action_properties
(<em class="parameter"><code><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> *activatable</code></em>,
<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<p>This is called to update the activatable completely, this is called
internally when the <span class="type">“related-action”</span> property is set
or unset and by the implementing class when
<span class="type">“use-action-appearance”</span> changes.</p>
<div class="refsect3">
<a name="gtk-activatable-sync-action-properties.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>activatable</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the related <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-set-related-action"></a><h3>gtk_activatable_set_related_action ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_activatable_set_related_action (<em class="parameter"><code><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> *activatable</code></em>,
<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<p>Sets the related action on the <em class="parameter"><code>activatable</code></em>
object.</p>
<div class="note"><p><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> implementors need to handle the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property"><span class="type">“related-action”</span></a>
property and call <a class="link" href="GtkActivatable.html#gtk-activatable-do-set-related-action" title="gtk_activatable_do_set_related_action ()"><code class="function">gtk_activatable_do_set_related_action()</code></a> when it changes.</p></div>
<div class="refsect3">
<a name="gtk-activatable-set-related-action.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>activatable</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<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> to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-set-use-action-appearance"></a><h3>gtk_activatable_set_use_action_appearance ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_activatable_set_use_action_appearance
(<em class="parameter"><code><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> *activatable</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_appearance</code></em>);</pre>
<p>Sets whether this activatable should reset its layout and appearance
when setting the related action or when the action changes appearance</p>
<div class="note"><p><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> implementors need to handle the
<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 and call
<a class="link" href="GtkActivatable.html#gtk-activatable-sync-action-properties" title="gtk_activatable_sync_action_properties ()"><code class="function">gtk_activatable_sync_action_properties()</code></a> to update <em class="parameter"><code>activatable</code></em>
if needed.</p></div>
<div class="refsect3">
<a name="gtk-activatable-set-use-action-appearance.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>activatable</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>use_appearance</p></td>
<td class="parameter_description"><p>whether to use the actions appearance</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
</div>
<div class="refsect1">
<a name="GtkActivatable.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkActivatable-struct"></a><h3>GtkActivatable</h3>
<pre class="programlisting">typedef struct _GtkActivatable GtkActivatable;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkActivatableIface"></a><h3>struct GtkActivatableIface</h3>
<pre class="programlisting">struct GtkActivatableIface {
GTypeInterface g_iface;
/* virtual table */
void (* update) (GtkActivatable *activatable,
GtkAction *action,
const gchar *property_name);
void (* sync_action_properties) (GtkActivatable *activatable,
GtkAction *action);
};
</pre>
<div class="refsect3">
<a name="GtkActivatableIface.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="GtkActivatableIface.update"></a>update</code></em> ()</p></td>
<td class="struct_member_description"><p>Called to update the activatable when its related action's properties change.
You must check the <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 only apply action
properties that are meant to effect the appearance accordingly.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkActivatableIface.sync-action-properties"></a>sync_action_properties</code></em> ()</p></td>
<td class="struct_member_description">
<p>Called to update the activatable completely, this is called internally when
<span class="type">“related-action”</span> property is set or unset and by the implementor when
<span class="type">“use-action-appearance”</span> changes.</p>
<div class="note"><p>This method can be called
with a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> action at times</p></div>
</td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
</div>
<div class="refsect1">
<a name="GtkActivatable.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkActivatable--related-action"></a><h3>The <code class="literal">“related-action”</code> property</h3>
<pre class="programlisting"> “related-action” <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *</pre>
<p>The action that this activatable will activate and receive
updates from for various states and possibly appearance.</p>
<div class="note"><p><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> implementors need to handle the this property and
call <a class="link" href="GtkActivatable.html#gtk-activatable-do-set-related-action" title="gtk_activatable_do_set_related_action ()"><code class="function">gtk_activatable_do_set_related_action()</code></a> when it changes.</p></div>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkActivatable--use-action-appearance"></a><h3>The <code class="literal">“use-action-appearance”</code> property</h3>
<pre class="programlisting"> “use-action-appearance” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>Whether this activatable should reset its layout
and appearance when setting the related action or when
the action changes appearance.</p>
<p>See the <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> documentation directly to find which properties
should be ignored by the <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> when this property is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="note"><p><a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> implementors need to handle this property
and call <a class="link" href="GtkActivatable.html#gtk-activatable-sync-action-properties" title="gtk_activatable_sync_action_properties ()"><code class="function">gtk_activatable_sync_action_properties()</code></a> on the activatable
widget when it changes.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.26.1</div>
</body>
</html>