mirror of
https://github.com/brl/mutter.git
synced 2024-11-27 10:30:47 -05:00
a2f8ce175f
* Add documentation for all undocumented symbols * Add an overview section
118 lines
3.9 KiB
C
118 lines
3.9 KiB
C
/* CALLY - The Clutter Accessibility Implementation Library
|
|
*
|
|
* Copyright (C) 2008 Igalia, S.L.
|
|
*
|
|
* Author: Alejandro Piñeiro Iglesias <apinheiro@igalia.com>
|
|
*
|
|
* Based on gailfactory.h from GAIL
|
|
* Copyright 2001, 2002, 2003 Sun Microsystems Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser 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.
|
|
*/
|
|
|
|
#ifndef _CALLY_FACTORY_H__
|
|
#define _CALLY_FACTORY_H__
|
|
|
|
#include <glib-object.h>
|
|
#include <atk/atkobject.h>
|
|
|
|
/**
|
|
* CALLY_ACCESSIBLE_FACTORY:
|
|
* @type: GType of the accessible which is created by the factory
|
|
* @type_as_function: prefix of the accessible object methods
|
|
* @opt_create_accessible: method to instantiate the accessibility object
|
|
*
|
|
* Defines a new #AtkObjectFactory factory to create accessible
|
|
* objects of a specific GType. It defines the factory GType and also
|
|
* overrides the proper #AtkObjectFactory methods.
|
|
*
|
|
* It assumes that the accessibility object provides a
|
|
* @opt_create_accessible method in order to create the accessibility
|
|
* object. It returns a @type GType object.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
#define CALLY_ACCESSIBLE_FACTORY(type, type_as_function, opt_create_accessible) \
|
|
\
|
|
static GType \
|
|
type_as_function ## _factory_get_accessible_type (void) \
|
|
{ \
|
|
return type; \
|
|
} \
|
|
\
|
|
static AtkObject* \
|
|
type_as_function ## _factory_create_accessible (GObject *obj) \
|
|
{ \
|
|
ClutterActor *actor; \
|
|
AtkObject *accessible; \
|
|
\
|
|
g_return_val_if_fail (CLUTTER_ACTOR (obj), NULL); \
|
|
\
|
|
actor = CLUTTER_ACTOR (obj); \
|
|
\
|
|
accessible = opt_create_accessible (actor); \
|
|
\
|
|
return accessible; \
|
|
} \
|
|
\
|
|
static void \
|
|
type_as_function ## _factory_class_init (AtkObjectFactoryClass *klass) \
|
|
{ \
|
|
klass->create_accessible = type_as_function ## _factory_create_accessible; \
|
|
klass->get_accessible_type = type_as_function ## _factory_get_accessible_type;\
|
|
} \
|
|
\
|
|
static GType \
|
|
type_as_function ## _factory_get_type (void) \
|
|
{ \
|
|
static GType t = 0; \
|
|
\
|
|
if (!t) \
|
|
{ \
|
|
char *name; \
|
|
static const GTypeInfo tinfo = \
|
|
{ \
|
|
sizeof (AtkObjectFactoryClass), \
|
|
NULL, NULL, (GClassInitFunc) type_as_function ## _factory_class_init, \
|
|
NULL, NULL, sizeof (AtkObjectFactory), 0, NULL, NULL \
|
|
}; \
|
|
\
|
|
name = g_strconcat (g_type_name (type), "Factory", NULL); \
|
|
t = g_type_register_static ( \
|
|
ATK_TYPE_OBJECT_FACTORY, name, &tinfo, 0); \
|
|
g_free (name); \
|
|
} \
|
|
\
|
|
return t; \
|
|
}
|
|
|
|
/**
|
|
* CALLY_ACTOR_SET_FACTORY:
|
|
* @widget_type: GType of the clutter actor
|
|
* @type_as_function: prefix of the accessible object methods
|
|
*
|
|
* Sets the #AtkObjectFactory to be used in order to instantiate
|
|
* accessibility objects for the actor which GType is @widget_type.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
#define CALLY_ACTOR_SET_FACTORY(widget_type, type_as_function) \
|
|
atk_registry_set_factory_type (atk_get_default_registry (), \
|
|
widget_type, \
|
|
type_as_function ## _factory_get_type ())
|
|
|
|
#endif /* _CALLY_FACTORY_H__ */
|