Default page

Edit File: GtkActivatable.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>GtkActivatable: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkRecentAction.html" title="GtkRecentAction">
<link rel="next" href="GtkImageMenuItem.html" title="GtkImageMenuItem">
<meta name="generator" content="GTK-Doc V1.32 (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>  | 
 <a href="#GtkActivatable.description" class="shortcut">Description</a>  | 
 <a href="#GtkActivatable.object-hierarchy" class="shortcut">Object Hierarchy</a>  | 
 <a href="#GtkActivatable.prerequisites" class="shortcut">Prerequisites</a>  | 
 <a href="#GtkActivatable.implementations" class="shortcut">Known Implementations</a>  | 
 <a href="#GtkActivatable.properties" class="shortcut">Properties</a>
</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="GtkRecentAction.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkImageMenuItem.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><a name="GtkActivatable.top_of_page"></a>GtkActivatable</h2>
GtkActivatable — An interface for activatable widgets
</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_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
void
</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> ()
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</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> ()
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</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> ()
</td>
</tr>
<tr>
<td class="function_type">
void
</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> ()
</td>
</tr>
<tr>
<td class="function_type">
void
</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> ()
</td>
</tr>
<tr>
<td class="function_type">
void
</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> ()
</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">GtkAction</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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</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="other_proto_type">
<col class="other_proto_name">
</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="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
 ╰── GtkActivatable
</pre>
</div>
<div class="refsect1">
<a name="GtkActivatable.prerequisites"></a><h2>Prerequisites</h2>

GtkActivatable requires
 <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>.
</div>
<div class="refsect1">
<a name="GtkActivatable.implementations"></a><h2>Known Implementations</h2>

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="GtkCheckMenuItem.html" title="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="GtkLockButton.html" title="GtkLockButton">GtkLockButton</a>, <a class="link" href="GtkMenuButton.html" title="GtkMenuButton">GtkMenuButton</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="GtkModelButton.html" title="GtkModelButton">GtkModelButton</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="GtkSwitch.html" title="GtkSwitch">GtkSwitch</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>.
</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>
Activatable widgets can be connected to a <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> and reflects
the state of its action. A <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> can also provide feedback
through its action, as they are responsible for activating their
related actions.
<div class="refsect2">
<a name="id-1.3.25.31.10.3"></a><h3>Implementing GtkActivatable</h3>
When extending a class that is already <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a>; it is only
necessary to implement the <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a>-><code class="function">sync_action_properties()</code>
and <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</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">GtkActivatable</a> class; the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property">“related-action”</a> and
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property">“use-action-appearance”</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.
<div class="refsect3">
<a name="id-1.3.25.31.10.3.3"></a><h4>A class fragment implementing <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a>
</h4>
<div class="informalexample">
 <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">enum {
...

PROP_ACTIVATABLE_RELATED_ACTION,
PROP_ACTIVATABLE_USE_ACTION_APPEARANCE
}

struct _FooBarPrivate
{

...

GtkAction *action;
 gboolean use_action_appearance;
};

...

static void foo_bar_activatable_interface_init (GtkActivatableIface *iface);
static void foo_bar_activatable_update (GtkActivatable *activatable,
						 GtkAction *action,
						 const gchar *property_name);
static void foo_bar_activatable_sync_action_properties (GtkActivatable *activatable,
						 GtkAction *action);
...

static void
foo_bar_class_init (FooBarClass *klass)
{

...

g_object_class_override_property (gobject_class, PROP_ACTIVATABLE_RELATED_ACTION, "related-action");
 g_object_class_override_property (gobject_class, PROP_ACTIVATABLE_USE_ACTION_APPEARANCE, "use-action-appearance");

...
}

... Break the reference using gtk_activatable_do_set_related_action()...

static void 
foo_bar_dispose (GObject *object)
{
 FooBar *bar = FOO_BAR (object);
 FooBarPrivate *priv = FOO_BAR_GET_PRIVATE (bar);

...

if (priv->action)
 {
 gtk_activatable_do_set_related_action (GTK_ACTIVATABLE (bar), NULL);
 priv->action = NULL;
 }
 G_OBJECT_CLASS (foo_bar_parent_class)->dispose (object);
}

... Handle the “related-action” and “use-action-appearance” properties ...

static void
foo_bar_set_property (GObject *object,
 guint prop_id,
 const GValue *value,
 GParamSpec *pspec)
{
 FooBar *bar = FOO_BAR (object);
 FooBarPrivate *priv = FOO_BAR_GET_PRIVATE (bar);

switch (prop_id)
 {

...

case PROP_ACTIVATABLE_RELATED_ACTION:
 foo_bar_set_related_action (bar, g_value_get_object (value));
 break;
 case PROP_ACTIVATABLE_USE_ACTION_APPEARANCE:
 foo_bar_set_use_action_appearance (bar, g_value_get_boolean (value));
 break;
 default:
 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 break;
 }
}

static void
foo_bar_get_property (GObject *object,
 guint prop_id,
 GValue *value,
 GParamSpec *pspec)
{
 FooBar *bar = FOO_BAR (object);
 FooBarPrivate *priv = FOO_BAR_GET_PRIVATE (bar);

switch (prop_id)
 {

...

case PROP_ACTIVATABLE_RELATED_ACTION:
 g_value_set_object (value, priv->action);
 break;
 case PROP_ACTIVATABLE_USE_ACTION_APPEARANCE:
 g_value_set_boolean (value, priv->use_action_appearance);
 break;
 default:
 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 break;
 }
}

static void
foo_bar_set_use_action_appearance (FooBar *bar, 
				 gboolean use_appearance)
{
 FooBarPrivate *priv = FOO_BAR_GET_PRIVATE (bar);

if (priv->use_action_appearance != use_appearance)
 {
 priv->use_action_appearance = use_appearance;
 
 gtk_activatable_sync_action_properties (GTK_ACTIVATABLE (bar), priv->action);
 }
}

... call gtk_activatable_do_set_related_action() and then assign the action pointer, 
no need to reference the action here since gtk_activatable_do_set_related_action() already 
holds a reference here for you...
static void
foo_bar_set_related_action (FooBar *bar, 
			 GtkAction *action)
{
 FooBarPrivate *priv = FOO_BAR_GET_PRIVATE (bar);

if (priv->action == action)
 return;

gtk_activatable_do_set_related_action (GTK_ACTIVATABLE (bar), action);

priv->action = action;
}

... Selectively reset and update activatable depending on the use-action-appearance property ...
static void
gtk_button_activatable_sync_action_properties (GtkActivatable *activatable,
		 GtkAction *action)
{
 GtkButtonPrivate *priv = GTK_BUTTON_GET_PRIVATE (activatable);

if (!action)
 return;

if (gtk_action_is_visible (action))
 gtk_widget_show (GTK_WIDGET (activatable));
 else
 gtk_widget_hide (GTK_WIDGET (activatable));
 
 gtk_widget_set_sensitive (GTK_WIDGET (activatable), gtk_action_is_sensitive (action));

...
 
 if (priv->use_action_appearance)
 {
 if (gtk_action_get_stock_id (action))
	foo_bar_set_stock (button, gtk_action_get_stock_id (action));
 else if (gtk_action_get_label (action))
	foo_bar_set_label (button, gtk_action_get_label (action));

...

}
}

static void 
foo_bar_activatable_update (GtkActivatable *activatable,
			 GtkAction *action,
			 const gchar *property_name)
{
 FooBarPrivate *priv = FOO_BAR_GET_PRIVATE (activatable);

if (strcmp (property_name, "visible") == 0)
 {
 if (gtk_action_is_visible (action))
	gtk_widget_show (GTK_WIDGET (activatable));
 else
	gtk_widget_hide (GTK_WIDGET (activatable));
 }
 else if (strcmp (property_name, "sensitive") == 0)
 gtk_widget_set_sensitive (GTK_WIDGET (activatable), gtk_action_is_sensitive (action));

...

if (!priv->use_action_appearance)
 return;

if (strcmp (property_name, "stock-id") == 0)
 foo_bar_set_stock (button, gtk_action_get_stock_id (action));
 else if (strcmp (property_name, "label") == 0)
 foo_bar_set_label (button, gtk_action_get_label (action));

...
}</pre></td>
 </tr>
 </tbody>
 </table>
</div>

</div>
</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">void
gtk_activatable_do_set_related_action (<code><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> *activatable</code>,
 <code><a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action</code>);</pre>
<div class="warning"><code class="literal">gtk_activatable_do_set_related_action</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
This is a utility function for <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> implementors.
When implementing <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> you must call this when
handling changes of the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property">“related-action”</a>, and
you must also use this to break references in <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>-><code class="function">dispose()</code>.
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">GtkActivatable</a>-><code class="function">update()</code>
method is called when the related <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> properties change
and registers to the action’s proxy list.
<div class="blockquote"><blockquote class="blockquote">Be careful to call this before setting the local
copy of the <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> property, since this function uses 
<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> to retrieve the
previous action.</blockquote></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">activatable</td>
<td class="parameter_description">a <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name">action</td>
<td class="parameter_description">the <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> to set</td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
Since: 2.16
</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">GtkAction</a> *
gtk_activatable_get_related_action (<code><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> *activatable</code>);</pre>
<div class="warning"><code class="literal">gtk_activatable_get_related_action</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
Gets the related <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> for <code>activatable</code>
.
<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">activatable</td>
<td class="parameter_description">a <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a></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>
the related <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> if one is set. 
[<acronym title="Don't free data after the code is done.">transfer none</acronym>]
</div>
Since: 2.16
</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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a>
gtk_activatable_get_use_action_appearance
 (<code><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> *activatable</code>);</pre>
<div class="warning"><code class="literal">gtk_activatable_get_use_action_appearance</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
Gets whether this activatable should reset its layout
and appearance when setting the related action or when
the action changes appearance.
<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">activatable</td>
<td class="parameter_description">a <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a></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>
 whether <code>activatable</code>
uses its actions appearance.
</div>
Since: 2.16
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-sync-action-properties"></a><h3>gtk_activatable_sync_action_properties ()</h3>
<pre class="programlisting">void
gtk_activatable_sync_action_properties
 (<code><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> *activatable</code>,
 <code><a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action</code>);</pre>
<div class="warning"><code class="literal">gtk_activatable_sync_action_properties</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
This is called to update the activatable completely, this is called
internally when the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property">“related-action”</a> property is set
or unset and by the implementing class when
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property">“use-action-appearance”</a> changes.
<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">activatable</td>
<td class="parameter_description">a <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name">action</td>
<td class="parameter_description">the related <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>
<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>
</tr>
</tbody>
</table></div>
</div>
Since: 2.16
</div>
<hr>
<div class="refsect2">
<a name="gtk-activatable-set-related-action"></a><h3>gtk_activatable_set_related_action ()</h3>
<pre class="programlisting">void
gtk_activatable_set_related_action (<code><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> *activatable</code>,
 <code><a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action</code>);</pre>
<div class="warning"><code class="literal">gtk_activatable_set_related_action</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
Sets the related action on the <code>activatable</code>
 object.
<div class="blockquote"><blockquote class="blockquote"><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> implementors need to handle the <a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property">“related-action”</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.</blockquote></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">activatable</td>
<td class="parameter_description">a <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name">action</td>
<td class="parameter_description">the <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> to set</td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
Since: 2.16
</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">void
gtk_activatable_set_use_action_appearance
 (<code><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> *activatable</code>,
 <code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> use_appearance</code>);</pre>
<div class="warning"><code class="literal">gtk_activatable_set_use_action_appearance</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
Sets whether this activatable should reset its layout and appearance
when setting the related action or when the action changes appearance
<div class="blockquote"><blockquote class="blockquote"><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> implementors need to handle the
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property">“use-action-appearance”</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 <code>activatable</code>

if needed.</blockquote></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">activatable</td>
<td class="parameter_description">a <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name">use_appearance</td>
<td class="parameter_description">whether to use the actions appearance</td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
Since: 2.16
</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 {
 /* virtual table */
 void (* update) (GtkActivatable *activatable,
		 GtkAction *action,
		 const gchar *property_name);
 void (* sync_action_properties) (GtkActivatable *activatable,
		 GtkAction *action);
};
</pre>
<div class="warning"><code class="literal">GtkActivatableIface</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
<div class="blockquote"><blockquote class="blockquote">This method can be called with a <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> action at times.</blockquote></div>
<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"><code><a name="GtkActivatableIface.update"></a>update</code> ()</td>
<td class="struct_member_description">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">“use-action-appearance”</a> property only apply action
properties that are meant to effect the appearance accordingly.</td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><code><a name="GtkActivatableIface.sync-action-properties"></a>sync_action_properties</code> ()</td>
<td class="struct_member_description">Called to update the activatable completely, this is called internally when
<a class="link" href="GtkActivatable.html#GtkActivatable--related-action" title="The “related-action” property">“related-action”</a> property is set or unset and by the implementor when
<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property">“use-action-appearance”</a> changes.</td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
Since: 2.16
</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">GtkAction</a> *</pre>
The action that this activatable will activate and receive
updates from for various states and possibly appearance.
<div class="blockquote"><blockquote class="blockquote"><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</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.</blockquote></div>
<div class="warning"><code class="literal">GtkActivatable:related-action</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
Owner: GtkActivatable
Flags: Read / Write
Since: 2.16
</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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a></pre>
Whether this activatable should reset its layout
and appearance when setting the related action or when
the action changes appearance.
See the <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> documentation directly to find which properties
should be ignored by the <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> when this property is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
<div class="blockquote"><blockquote class="blockquote"><a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</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.</blockquote></div>
<div class="warning"><code class="literal">GtkActivatable:use-action-appearance</code> has been deprecated since version 3.10 and should not be used in newly-written code.</div>
Owner: GtkActivatable
Flags: Read / Write
Default value: TRUE
Since: 2.16
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.32</div>
</body>
</html>