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:
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 (relation != NULL, 0);
127 g_return_val_if_fail (ATK_IS_RELATION (relation), 0);
129 return relation->relationship;
133 *atk_relation_get_target:
134 *@relation: an #AtkRelation
136 * Gets the target list of @relation
138 *Returns: the target list of @relation
141 atk_relation_get_target (AtkRelation *relation)
143 g_return_val_if_fail (relation != NULL, FALSE);
144 g_return_val_if_fail (ATK_IS_RELATION (relation), FALSE);
146 return relation->target;
150 atk_relation_finalize (GObject *object)
152 AtkRelation *relation;
154 g_return_if_fail (ATK_IS_RELATION (object));
156 relation = ATK_RELATION (object);
158 if (relation->target)
162 for (i = 0; i < relation->target->len; i++)
165 * Remove a reference to AtkObject being removed from a relation
167 g_object_unref (g_ptr_array_index (relation->target, i));
169 g_ptr_array_free (relation->target, TRUE);