1 /* ATK - Accessibility Toolkit
2 * Copyright 2001 Sun Microsystems Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
20 #include <glib-object.h>
21 #include "atkobject.h"
22 #include "atkrelation.h"
24 static void atk_relation_class_init (AtkRelationClass *klass);
25 static void atk_relation_finalize (GObject *object);
28 atk_relation_get_type (void)
30 static GType type = 0;
34 static const GTypeInfo typeInfo =
36 sizeof (AtkRelationClass),
38 (GBaseFinalizeFunc) NULL,
39 (GClassInitFunc) atk_relation_class_init,
40 (GClassFinalizeFunc) NULL,
44 (GInstanceInitFunc) NULL,
46 type = g_type_register_static (G_TYPE_OBJECT, "AtkRelation", &typeInfo, 0) ;
52 atk_relation_class_init (AtkRelationClass *klass)
54 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
56 gobject_class->finalize = atk_relation_finalize;
60 * atk_relation_type_register:
61 * @name: a name string
63 * Associate @name with a new #AtkRelationType
65 * Returns: an #AtkRelationType associated with @name
68 atk_relation_type_register (const gchar *name)
70 /* TODO: associate name with new type */
71 static guint type = ATK_RELATION_LAST_DEFINED;
77 * @targets: an array of pointers to #AtkObjects
78 * @n_targets: number of #AtkObjects pointed to by @targets
79 * @relationship: an #AtkRelationType with which to create the new
82 * Create a new relation for the specified key and the specified list
85 * Returns: a pointer to a new #AtkRelation
88 atk_relation_new (AtkObject **targets,
90 AtkRelationType relationship)
92 AtkRelation *relation;
96 g_return_val_if_fail (targets != NULL, NULL);
98 relation = g_object_new (ATK_TYPE_RELATION, NULL);
99 array = g_ptr_array_sized_new (n_targets);
100 for (i = 0; i < n_targets; i++)
103 * Add a reference to AtkObject being added to a relation
105 g_object_ref (targets[i]);
106 g_ptr_array_add (array, targets[i]);
109 relation->target = array;
110 relation->relationship = relationship;
116 * atk_relation_get_relation_type:
117 * @relation: an #AtkRelation
119 * Gets the type of @relation
121 * Returns: the type of @relation
124 atk_relation_get_relation_type (AtkRelation *relation)
126 g_return_val_if_fail (ATK_IS_RELATION (relation), 0);
128 return relation->relationship;
132 * atk_relation_get_target:
133 * @relation: an #AtkRelation
135 * Gets the target list of @relation
137 * Returns: the target list of @relation
140 atk_relation_get_target (AtkRelation *relation)
142 g_return_val_if_fail (ATK_IS_RELATION (relation), FALSE);
144 return relation->target;
148 atk_relation_finalize (GObject *object)
150 AtkRelation *relation;
152 g_return_if_fail (ATK_IS_RELATION (object));
154 relation = ATK_RELATION (object);
156 if (relation->target)
160 for (i = 0; i < relation->target->len; i++)
163 * Remove a reference to AtkObject being removed from a relation
165 g_object_unref (g_ptr_array_index (relation->target, i));
167 g_ptr_array_free (relation->target, TRUE);