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.
22 #include "atkobjectfactory.h"
23 #include "atknoopobjectfactory.h"
26 * SECTION:atkobjectfactory
27 * @Short_description: The base object class for a factory used to
28 * create accessible objects for objects of a specific GType.
29 * @Title:AtkObjectFactory
31 * This class is the base object class for a factory used to create an
32 * accessible object for a specific GType. The function
33 * atk_registry_set_factory_type() is normally called to store in the
34 * registry the factory type to be used to create an accessible of a
38 static void atk_object_factory_class_init (AtkObjectFactoryClass
*klass
);
40 static gpointer parent_class
= NULL
;
43 atk_object_factory_get_type (void)
45 static GType type
= 0;
50 sizeof (AtkObjectFactoryClass
),
51 (GBaseInitFunc
) NULL
, /* base init */
52 (GBaseFinalizeFunc
) NULL
, /* base finalize */
53 (GClassInitFunc
) atk_object_factory_class_init
, /* class init */
54 (GClassFinalizeFunc
) NULL
, /* class finalize */
55 NULL
, /* class data */
56 sizeof (AtkObjectFactory
), /* instance size */
58 (GInstanceInitFunc
) NULL
, /* instance init */
59 NULL
/* value table */
62 type
= g_type_register_static (G_TYPE_OBJECT
, "AtkObjectFactory", &tinfo
, 0);
68 atk_object_factory_class_init (AtkObjectFactoryClass
*klass
)
70 parent_class
= g_type_class_peek_parent (klass
);
75 * atk_object_factory_create_accessible:
76 * @factory: The #AtkObjectFactory associated with @obj's
80 * Provides an #AtkObject that implements an accessibility interface
83 * Returns: (transfer full): an #AtkObject that implements an accessibility
84 * interface on behalf of @obj
87 atk_object_factory_create_accessible (AtkObjectFactory
*factory
,
90 AtkObjectFactoryClass
*klass
;
91 AtkObject
*accessible
= NULL
;
93 g_return_val_if_fail (ATK_IS_OBJECT_FACTORY (factory
), NULL
);
94 g_return_val_if_fail (G_IS_OBJECT (obj
), NULL
);
96 klass
= ATK_OBJECT_FACTORY_GET_CLASS (factory
);
98 if (klass
->create_accessible
)
100 accessible
= klass
->create_accessible (obj
);
106 * atk_object_factory_invalidate:
107 * @factory: an #AtkObjectFactory to invalidate
109 * Inform @factory that it is no longer being used to create
110 * accessibles. When called, @factory may need to inform
111 * #AtkObjects which it has created that they need to be re-instantiated.
112 * Note: primarily used for runtime replacement of #AtkObjectFactorys
113 * in object registries.
116 atk_object_factory_invalidate (AtkObjectFactory
*factory
)
118 AtkObjectFactoryClass
*klass
;
120 g_return_if_fail (ATK_OBJECT_FACTORY (factory
));
122 klass
= ATK_OBJECT_FACTORY_GET_CLASS (factory
);
123 if (klass
->invalidate
)
124 (klass
->invalidate
) (factory
);
128 * atk_object_factory_get_accessible_type:
129 * @factory: an #AtkObjectFactory
131 * Gets the GType of the accessible which is created by the factory.
132 * Returns: the type of the accessible which is created by the @factory.
133 * The value G_TYPE_INVALID is returned if no type if found.
136 atk_object_factory_get_accessible_type (AtkObjectFactory
*factory
)
138 AtkObjectFactoryClass
*klass
;
140 g_return_val_if_fail (ATK_OBJECT_FACTORY (factory
), G_TYPE_INVALID
);
142 klass
= ATK_OBJECT_FACTORY_GET_CLASS (factory
);
143 if (klass
->get_accessible_type
)
144 return (klass
->get_accessible_type
) ();
146 return G_TYPE_INVALID
;