glib (2.79.0)
1 /*
2 * Copyright © 2010 Codethink Limited
3 *
4 * SPDX-License-Identifier: LGPL-2.1-or-later
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General
17 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
18 *
19 * Authors: Ryan Lortie <desrt@desrt.ca>
20 */
21
22 #ifndef __G_ACTION_H__
23 #define __G_ACTION_H__
24
25 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
26 #error "Only <gio/gio.h> can be included directly."
27 #endif
28
29 #include <gio/giotypes.h>
30
31 G_BEGIN_DECLS
32
33 #define G_TYPE_ACTION (g_action_get_type ())
34 #define G_ACTION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
35 G_TYPE_ACTION, GAction))
36 #define G_IS_ACTION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_ACTION))
37 #define G_ACTION_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), \
38 G_TYPE_ACTION, GActionInterface))
39
40 typedef struct _GActionInterface GActionInterface;
41
42 struct _GActionInterface
43 {
44 GTypeInterface g_iface;
45
46 /* virtual functions */
47 const gchar * (* get_name) (GAction *action);
48 const GVariantType * (* get_parameter_type) (GAction *action);
49 const GVariantType * (* get_state_type) (GAction *action);
50 GVariant * (* get_state_hint) (GAction *action);
51
52 gboolean (* get_enabled) (GAction *action);
53 GVariant * (* get_state) (GAction *action);
54
55 void (* change_state) (GAction *action,
56 GVariant *value);
57 void (* activate) (GAction *action,
58 GVariant *parameter);
59 };
60
61 GIO_AVAILABLE_IN_2_30
62 GType g_action_get_type (void) G_GNUC_CONST;
63
64 GIO_AVAILABLE_IN_ALL
65 const gchar * g_action_get_name (GAction *action);
66 GIO_AVAILABLE_IN_ALL
67 const GVariantType * g_action_get_parameter_type (GAction *action);
68 GIO_AVAILABLE_IN_ALL
69 const GVariantType * g_action_get_state_type (GAction *action);
70 GIO_AVAILABLE_IN_ALL
71 GVariant * g_action_get_state_hint (GAction *action);
72
73 GIO_AVAILABLE_IN_ALL
74 gboolean g_action_get_enabled (GAction *action);
75 GIO_AVAILABLE_IN_ALL
76 GVariant * g_action_get_state (GAction *action);
77
78 GIO_AVAILABLE_IN_ALL
79 void g_action_change_state (GAction *action,
80 GVariant *value);
81 GIO_AVAILABLE_IN_ALL
82 void g_action_activate (GAction *action,
83 GVariant *parameter);
84
85 GIO_AVAILABLE_IN_2_28
86 gboolean g_action_name_is_valid (const gchar *action_name);
87
88 GIO_AVAILABLE_IN_2_38
89 gboolean g_action_parse_detailed_name (const gchar *detailed_name,
90 gchar **action_name,
91 GVariant **target_value,
92 GError **error);
93
94 GIO_AVAILABLE_IN_2_38
95 gchar * g_action_print_detailed_name (const gchar *action_name,
96 GVariant *target_value);
97
98 G_END_DECLS
99
100 #endif /* __G_ACTION_H__ */