1 /* ATK - Accessibility Toolkit
2 * Copyright 2001, 2002, 2003 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 <atk/atkgobjectaccessible.h>
21 #include <atk/atkregistry.h>
22 #include <atk/atkutil.h>
25 * SECTION:atkgobjectaccessible
26 * @Short_description: This object class is derived from AtkObject and
27 * can be used as a basis implementing accessible objects.
28 * @Title:AtkGObjectAccessible
30 * This object class is derived from AtkObject. It can be used as a
31 * basis for implementing accessible objects for GObjects which are
32 * not derived from GtkWidget. One example of its use is in providing
33 * an accessible object for GnomeCanvasItem in the GAIL library.
35 static void atk_gobject_accessible_class_init (AtkGObjectAccessibleClass
*klass
);
36 static void atk_real_gobject_accessible_initialize (AtkObject
*atk_obj
,
38 static void atk_gobject_accessible_dispose (gpointer data
);
40 static GQuark quark_accessible_object
= 0;
41 static GQuark quark_object
= 0;
42 static gpointer parent_class
= NULL
;
45 atk_gobject_accessible_get_type (void)
47 static GType type
= 0;
51 static const GTypeInfo tinfo
=
53 sizeof (AtkGObjectAccessibleClass
),
54 (GBaseInitFunc
) NULL
, /* base init */
55 (GBaseFinalizeFunc
) NULL
, /* base finalize */
56 (GClassInitFunc
) atk_gobject_accessible_class_init
,
57 (GClassFinalizeFunc
) NULL
, /* class finalize */
58 NULL
, /* class data */
59 sizeof (AtkGObjectAccessible
),
61 (GInstanceInitFunc
) NULL
, /* instance init */
62 NULL
/* value table */
65 type
= g_type_register_static (ATK_TYPE_OBJECT
,
66 "AtkGObjectAccessible", &tinfo
, 0);
73 * atk_gobject_accessible_for_object:
76 * Gets the accessible object for the specified @obj.
78 * Returns: (transfer none): a #AtkObject which is the accessible object for
82 atk_gobject_accessible_for_object (GObject
*obj
)
84 AtkObject
* accessible
;
86 g_return_val_if_fail (G_IS_OBJECT (obj
), NULL
);
87 /* See if we have a cached accessible for this object */
89 accessible
= g_object_get_qdata (obj
,
90 quark_accessible_object
);
94 AtkObjectFactory
*factory
;
95 AtkRegistry
*default_registry
;
97 default_registry
= atk_get_default_registry ();
98 factory
= atk_registry_get_factory (default_registry
,
100 accessible
= atk_object_factory_create_accessible (factory
,
102 if (!ATK_IS_GOBJECT_ACCESSIBLE (accessible
))
105 * The AtkObject which was created was not a AtkGObjectAccessible
107 g_object_weak_ref (obj
,
108 (GWeakNotify
) g_object_unref
,
110 if (!quark_accessible_object
)
111 quark_accessible_object
= g_quark_from_static_string ("accessible-object");
113 g_object_set_qdata (obj
, quark_accessible_object
, accessible
);
119 * atk_gobject_accessible_get_object:
120 * @obj: a #AtkGObjectAccessible
122 * Gets the GObject for which @obj is the accessible object.
124 * Returns: (transfer none): a #GObject which is the object for which @obj is
125 * the accessible object
128 atk_gobject_accessible_get_object (AtkGObjectAccessible
*obj
)
130 g_return_val_if_fail (ATK_IS_GOBJECT_ACCESSIBLE (obj
), NULL
);
132 return g_object_get_qdata (G_OBJECT (obj
), quark_object
);
136 atk_real_gobject_accessible_initialize (AtkObject
*atk_obj
,
139 AtkGObjectAccessible
*atk_gobj
;
141 atk_gobj
= ATK_GOBJECT_ACCESSIBLE (atk_obj
);
143 g_object_set_qdata (G_OBJECT (atk_gobj
), quark_object
, data
);
144 atk_obj
->layer
= ATK_LAYER_WIDGET
;
146 g_object_weak_ref (data
,
147 (GWeakNotify
) atk_gobject_accessible_dispose
,
152 atk_gobject_accessible_dispose (gpointer data
)
156 g_return_if_fail (ATK_IS_GOBJECT_ACCESSIBLE (data
));
158 object
= atk_gobject_accessible_get_object (data
);
160 g_object_set_qdata (object
, quark_accessible_object
, NULL
);
162 g_object_set_qdata (G_OBJECT (data
), quark_object
, NULL
);
163 atk_object_notify_state_change (ATK_OBJECT (data
), ATK_STATE_DEFUNCT
,
165 g_object_unref (data
);
169 atk_gobject_accessible_class_init (AtkGObjectAccessibleClass
*klass
)
171 AtkObjectClass
*class;
173 class = ATK_OBJECT_CLASS (klass
);
175 parent_class
= g_type_class_peek_parent (klass
);
177 class->initialize
= atk_real_gobject_accessible_initialize
;
179 if (!quark_accessible_object
)
180 quark_accessible_object
= g_quark_from_static_string ("accessible-object");
181 quark_object
= g_quark_from_static_string ("object-for-accessible");