summaryrefslogtreecommitdiff
path: root/src/glade-property.h
blob: 7916f744ad69a1e5598a2e77df4215aae1e97297 (plain)
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
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
#ifndef __GLADE_PROPERTY_H__
#define __GLADE_PROPERTY_H__

G_BEGIN_DECLS

#define GLADE_TYPE_PROPERTY            (glade_property_get_type())
#define GLADE_PROPERTY(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GLADE_TYPE_PROPERTY, GladeProperty))
#define GLADE_PROPERTY_KLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GLADE_TYPE_PROPERTY, GladePropertyKlass))
#define GLADE_IS_PROPERTY(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GLADE_TYPE_PROPERTY))
#define GLADE_IS_PROPERTY_KLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GLADE_TYPE_PROPERTY))
#define GLADE_PROPERTY_GET_KLASS(o)    (G_TYPE_INSTANCE_GET_CLASS ((o), GLADE_PROPERTY, GladePropertyKlass))

typedef struct _GladePropertyKlass GladePropertyKlass;

/* A GladeProperty is an instance of a GladePropertyClass.
 * There will be one GladePropertyClass for "GtkLabel->label" but one
 * GladeProperty for each GtkLabel in the GladeProject.
 */
struct _GladeProperty
{
	GObject             parent_instance;

	GladePropertyClass *class;     /* A pointer to the GladeProperty that this
					* setting specifies
					*/
	GladeWidget        *widget;    /* A pointer to the GladeWidget that this
					* GladeProperty is modifying
					*/
	
	GValue             *value;     /* The value of the property
					*/

	gboolean            sensitive; /* Whether this property is sensitive (if the
					* property is "optional" this takes precedence).
					*/
	gchar              *insensitive_tooltip; /* Tooltip to display when in insensitive state
						  * (used to explain why the property is insensitive)
						  */

	gboolean            enabled;   /* Enabled is a flag that is used for GladeProperties
					* that have the optional flag set to let us know
					* if this widget has this GladeSetting enabled or
					* not. (Like default size, it can be specified or
					* unspecified). This flag also sets the state
					* of the property->input state for the loaded
					* widget.
					*/

	/* Used only for translatable strings. */
	gboolean  i18n_translatable;
	gboolean  i18n_has_context;
	gchar    *i18n_comment;
		
	gboolean     syncing;    /* Avoid recursion while synchronizing object with value.
				  */
};


struct _GladePropertyKlass
{
	GObjectClass  parent_class;

	/* Class methods */
	GladeProperty *         (* dup)                   (GladeProperty *, GladeWidget *);
	void                    (* reset)                 (GladeProperty *);
	gboolean                (* def)                   (GladeProperty *);
	gboolean                (* equals_value)          (GladeProperty *, const GValue *);
	void                    (* set_value)             (GladeProperty *, const GValue *);
	void                    (* get_value)             (GladeProperty *, GValue *);
	void                    (* get_default)           (GladeProperty *, GValue *);
	void                    (* sync)                  (GladeProperty *);
	void                    (* load)                  (GladeProperty *);
	gboolean                (* write)                 (GladeProperty *, GladeInterface *, GArray *);
	G_CONST_RETURN gchar *  (* get_tooltip)           (GladeProperty *);

	/* Signals */
	void             (* value_changed)         (GladeProperty *, GValue *, GValue *);
	void             (* tooltip_changed)       (GladeProperty *, const gchar *);
};

LIBGLADEUI_API
GType                   glade_property_get_type              (void);
LIBGLADEUI_API
GladeProperty          *glade_property_new                   (GladePropertyClass *class,
							      GladeWidget        *widget,
							      GValue             *value,
							      gboolean            catalog_default);
LIBGLADEUI_API
GladeProperty          *glade_property_dup                   (GladeProperty      *template,
							      GladeWidget        *widget);
LIBGLADEUI_API
void                    glade_property_reset                 (GladeProperty      *property);
LIBGLADEUI_API
gboolean                glade_property_default               (GladeProperty      *property);
LIBGLADEUI_API
gboolean                glade_property_equals_value          (GladeProperty      *property, 
							      const GValue       *value);
LIBGLADEUI_API
gboolean                glade_property_equals                (GladeProperty      *property, 
							      ...);
LIBGLADEUI_API
void                    glade_property_set_value             (GladeProperty      *property, 
							      const GValue       *value);
LIBGLADEUI_API
void                    glade_property_set_va_list           (GladeProperty      *property,
							      va_list             vl);
LIBGLADEUI_API
void                    glade_property_set                   (GladeProperty      *property,
							      ...);
LIBGLADEUI_API
void                    glade_property_get_value             (GladeProperty      *property, 
							      GValue             *value);
LIBGLADEUI_API
void                    glade_property_get_default           (GladeProperty      *property, 
							      GValue             *value);
LIBGLADEUI_API
void                    glade_property_get_va_list           (GladeProperty      *property,
							      va_list             vl);
LIBGLADEUI_API
void                    glade_property_get                   (GladeProperty      *property, 
							      ...);
LIBGLADEUI_API
void                    glade_property_add_object            (GladeProperty      *property,
							      GObject            *object);
LIBGLADEUI_API
void                    glade_property_remove_object         (GladeProperty      *property,
							      GObject            *object);
LIBGLADEUI_API
void                    glade_property_sync                  (GladeProperty      *property);
LIBGLADEUI_API
void                    glade_property_load                  (GladeProperty      *property);
LIBGLADEUI_API
GValue                 *glade_property_read                  (GladeProperty      *property,
							      GladePropertyClass *pclass,
							      GladeProject       *project,
							      gpointer            info,
							      gboolean            free_value);
LIBGLADEUI_API
gboolean                glade_property_write                 (GladeProperty      *property, 
							      GladeInterface     *interface, 
							      GArray             *props);
LIBGLADEUI_API
G_CONST_RETURN gchar   *glade_property_get_tooltip           (GladeProperty      *property);
LIBGLADEUI_API
void                    glade_property_set_sensitive         (GladeProperty      *property,
							      gboolean            sensitive,
							      const gchar        *reason);
LIBGLADEUI_API
gboolean                glade_property_get_sensitive         (GladeProperty      *property);
LIBGLADEUI_API
void                    glade_property_set_enabled           (GladeProperty      *property,
							      gboolean            enabled);
LIBGLADEUI_API
gboolean                glade_property_get_enabled           (GladeProperty      *property);

LIBGLADEUI_API
void                    glade_property_i18n_set_comment      (GladeProperty      *property, 
							      const gchar        *str);
LIBGLADEUI_API
G_CONST_RETURN gchar   *glade_property_i18n_get_comment      (GladeProperty      *property);
LIBGLADEUI_API
void                    glade_property_i18n_set_translatable (GladeProperty      *property,
							      gboolean            translatable);
LIBGLADEUI_API
gboolean                glade_property_i18n_get_translatable (GladeProperty      *property);
LIBGLADEUI_API
void                    glade_property_i18n_set_has_context  (GladeProperty      *property,
							      gboolean            has_context);
LIBGLADEUI_API
gboolean                glade_property_i18n_get_has_context  (GladeProperty      *property);

LIBGLADEUI_API
void                    glade_property_push_superuser        (void);
LIBGLADEUI_API
void                    glade_property_pop_superuser         (void);
LIBGLADEUI_API
gboolean                glade_property_superuser             (void);

G_END_DECLS

#endif /* __GLADE_PROPERTY_H__ */