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
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
|
-----------------------------------------------------------------------
-- GtkAda - Ada95 binding for Gtk+/Gnome --
-- --
-- Copyright (C) 2001-2003, ACT-Europe --
-- Copyright (C) 2010-2013, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or --
-- modify it under the terms of the GNU General Public --
-- License as published by the Free Software Foundation; either --
-- version 2 of the License, or (at your option) any later version. --
-- --
-- This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of --
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU --
-- General Public License for more details. --
-- --
-- You should have received a copy of the GNU General Public --
-- License along with this library; if not, write to the --
-- Free Software Foundation, Inc., 59 Temple Place - Suite 330, --
-- Boston, MA 02111-1307, USA. --
-- --
-----------------------------------------------------------------------
-- <description>
-- Properties are a fully general way to modify the appareance or behavior
-- of widgets. Most of the time, there exists a faster way to modify the
-- widget in the same fashion (for instance a direct call to a primitive
-- subprogram). However, the properties provide a general scheme to modify
-- these attributes.
-- For instance, they can be used to provide introspection on the widget
-- (to automatically retrieve the attributes that can be modified), or if
-- you need to implement a tool like a GUI-Builder that is able to
-- manipulate any widget, even those that didn't exist when the tool was
-- written.
--
-- Two functions are provided for each type of property: Set_Property and
-- Get_Property, which allow easy modification of specific widget
-- properties. For instance, you could do the following:
-- declare
-- Button : Gtk_Button;
-- begin
-- Gtk_New (Button, "old label");
-- Set_Property (Button, Label_Property, "new label");
-- end;
-- to modify the label of a button.
--
-- Likewise, you can retrieve the current label with:
-- Current : String := Get_Property (Button, Label_Property);
--
-- Dispatching is used ensure type-safety while using properties. The
-- appropriate Set_Property/Get_Property functions are called depending
-- on the type of the property you are trying to use. This is checked
-- statically by the compiler, which provides additional type-safety
-- compared to the C library.
--
-- Note that some properties are read-only, and thus do not have the
-- Set_Property subprogram defined.
--
-- When a property is modified, the signal "notify::<property>" is emitted,
-- for instance, "notify::label" for a gtk_button. This is a standard gtk+
-- signal to which you can connect with the subprograms in gtk-handlers.ads
-- </description>
-- <c_version>1.3.4</c_version>
-- <group>Glib, the general-purpose library</group>
with Glib.Object;
with Glib.Generic_Properties; use Glib.Generic_Properties;
pragma Elaborate_All (Glib.Generic_Properties);
with System;
with Glib.Values;
package Glib.Properties is
-- <doc_ignore>
-- Definition of the types and subprograms.
-- You can ignore this section.
package Char_Properties is new
Generic_Internal_Discrete_Property (Glib.Gchar);
package Uchar_Properties is new
Generic_Internal_Discrete_Property (Glib.Guchar);
package Int_Properties is new
Generic_Internal_Discrete_Property (Glib.Gint);
package Uint_Properties is new
Generic_Internal_Discrete_Property (Glib.Guint);
package Long_Properties is new
Generic_Internal_Discrete_Property (Glib.Glong);
package Ulong_Properties is new
Generic_Internal_Discrete_Property (Glib.Gulong);
package Unichar_Properties is new
Generic_Internal_Discrete_Property (Glib.Gunichar);
-- </doc_ignore>
-- Predefined types of properties. Additional types are available
-- for most of the standard enumeration types, and you can create
-- your own types (see Glib.Properties).
type Property_Char is new Char_Properties.Property;
type Property_Char_RO is new Char_Properties.Property_RO;
type Property_Uchar is new Uchar_Properties.Property;
type Property_Uchar_RO is new Uchar_Properties.Property_RO;
type Property_Int is new Int_Properties.Property;
type Property_Uint_RO is new Uint_Properties.Property_RO;
type Property_Uint is new Uint_Properties.Property;
type Property_Long_RO is new Long_Properties.Property_RO;
type Property_Long is new Long_Properties.Property;
type Property_Ulong_RO is new Ulong_Properties.Property_RO;
type Property_Ulong is new Ulong_Properties.Property;
type Property_Unichar is new Unichar_Properties.Property;
type Property_C_Proxy is new Glib.Property;
type Property_String_RO is new Glib.Property;
type Property_String_WO is new Glib.Property;
type Property_String is new Glib.Property;
type Property_Boolean is new Glib.Property;
type Property_Object is new Glib.Property;
type Property_Object_WO is new Glib.Property;
type Property_Address is new Glib.Property;
type Property_Float is new Glib.Property;
type Property_Double is new Glib.Property;
type Property_Enum is new Glib.Property;
type Property_Boxed is new Glib.Property;
-- General properties getter
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : String;
Value : in out Glib.Values.GValue);
procedure Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : String;
Value : in out Glib.Values.GValue);
-- Get the property. Value must have been initialized first with the
-- expected type for the property, as in:
-- Value : GValue;
-- Init (Value, Value_Type (Pspec));
-- Get_Property (Object, Pspec_Name (Pspec), Value);
-- If you do not have a Param_Spec, this can be replaced with:
-- Init (Value, GType_Int);
-- Get_Property (Object, Property_Name (Property), Value);
-- Value must be Unset by the caller to free memory
-- Special handling of string properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_String;
Value : String);
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_String_WO;
Value : String);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_String) return String;
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_String_RO) return String;
-- Special handling of boolean properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Boolean;
Value : Boolean);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Boolean) return Boolean;
-- Special handling of object properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Object;
Value : access Glib.Object.GObject_Record'Class);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Object) return Glib.Object.GObject;
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Object_WO;
Value : access Glib.Object.GObject_Record'Class);
-- Special handling of address properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Address;
Value : System.Address);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Address) return System.Address;
-- Special handling of float properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Float;
Value : Gfloat);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Float) return Gfloat;
-- Special handling of double properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Double;
Value : Gdouble);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_Double) return Gdouble;
-- Special handling of c_proxy properties
procedure Set_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_C_Proxy;
Value : C_Proxy);
function Get_Property
(Object : access Glib.Object.GObject_Record'Class;
Name : Property_C_Proxy) return C_Proxy;
end Glib.Properties;
|
