/* ATK - Accessibility Toolkit * Copyright 2001 Sun Microsystems Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library 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 __ATK_COMPONENT_H__ #define __ATK_COMPONENT_H__ #if defined(ATK_DISABLE_SINGLE_INCLUDES) && !defined (__ATK_H_INSIDE__) && !defined (ATK_COMPILATION) #error "Only can be included directly." #endif #include #include G_BEGIN_DECLS /* * The AtkComponent interface should be supported by any object that is * rendered on the screen. The interface provides the standard mechanism * for an assistive technology to determine and set the graphical * representation of an object. */ #define ATK_TYPE_COMPONENT (atk_component_get_type ()) #define ATK_IS_COMPONENT(obj) G_TYPE_CHECK_INSTANCE_TYPE ((obj), ATK_TYPE_COMPONENT) #define ATK_COMPONENT(obj) G_TYPE_CHECK_INSTANCE_CAST ((obj), ATK_TYPE_COMPONENT, AtkComponent) #define ATK_COMPONENT_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), ATK_TYPE_COMPONENT, AtkComponentIface)) #ifndef _TYPEDEF_ATK_COMPONENT_ #define _TYPEDEF_ATK_COMPONENT_ typedef struct _AtkComponent AtkComponent; #endif typedef struct _AtkComponentIface AtkComponentIface; /** * AtkFocusHandler: * @object: the #AtkObject that receives/lose the focus * @focus_in: TRUE if the object receives the focus * * The type of callback function used for * atk_component_add_focus_handler() and * atk_component_remove_focus_handler() * * Deprecated: 2.9.4: Deprecated with atk_component_add_focus_handler() * and atk_component_remove_focus_handler(). See those * methods for more information. */ typedef void (*AtkFocusHandler) (AtkObject* object, gboolean focus_in); typedef struct _AtkRectangle AtkRectangle; /** * AtkRectangle: * @x: X coordinate of the left side of the rectangle. * @y: Y coordinate of the top side of the rectangle. * @width: width of the rectangle. * @height: height of the rectangle. * * A data structure for holding a rectangle. Those coordinates are * relative to the component top-level parent. */ struct _AtkRectangle { gint x; gint y; gint width; gint height; }; ATK_AVAILABLE_IN_ALL GType atk_rectangle_get_type (void); #define ATK_TYPE_RECTANGLE (atk_rectangle_get_type ()) /** * AtkComponentIface: * @add_focus_handler: This virtual function is deprecated since 2.9.4 * and it should not be overriden. See * atk_component_add_focus_handler() for more information. * @get_position: This virtual function is deprecated since 2.12 and * it should not be overriden. Use @get_extents instead. * @get_size: This virtual function is deprecated since 2.12 and it * should not be overriden. Use @get_extents instead. * @remove_focus_handler: This virtual function is deprecated since * 2.9.4 and it should not be overriden. See * atk_component_remove_focus_handler() for more information. */ struct _AtkComponentIface { GTypeInterface parent; guint (* add_focus_handler) (AtkComponent *component, AtkFocusHandler handler); gboolean (* contains) (AtkComponent *component, gint x, gint y, AtkCoordType coord_type); AtkObject* (* ref_accessible_at_point) (AtkComponent *component, gint x, gint y, AtkCoordType coord_type); void (* get_extents) (AtkComponent *component, gint *x, gint *y, gint *width, gint *height, AtkCoordType coord_type); void (* get_position) (AtkComponent *component, gint *x, gint *y, AtkCoordType coord_type); void (* get_size) (AtkComponent *component, gint *width, gint *height); gboolean (* grab_focus) (AtkComponent *component); void (* remove_focus_handler) (AtkComponent *component, guint handler_id); gboolean (* set_extents) (AtkComponent *component, gint x, gint y, gint width, gint height, AtkCoordType coord_type); gboolean (* set_position) (AtkComponent *component, gint x, gint y, AtkCoordType coord_type); gboolean (* set_size) (AtkComponent *component, gint width, gint height); AtkLayer (* get_layer) (AtkComponent *component); gint (* get_mdi_zorder) (AtkComponent *component); /* * signal handlers */ void (* bounds_changed) (AtkComponent *component, AtkRectangle *bounds); gdouble (* get_alpha) (AtkComponent *component); }; ATK_AVAILABLE_IN_ALL GType atk_component_get_type (void); /* convenience functions */ ATK_DEPRECATED_IN_2_10 guint atk_component_add_focus_handler (AtkComponent *component, AtkFocusHandler handler); ATK_AVAILABLE_IN_ALL gboolean atk_component_contains (AtkComponent *component, gint x, gint y, AtkCoordType coord_type); ATK_AVAILABLE_IN_ALL AtkObject* atk_component_ref_accessible_at_point(AtkComponent *component, gint x, gint y, AtkCoordType coord_type); ATK_AVAILABLE_IN_ALL void atk_component_get_extents (AtkComponent *component, gint *x, gint *y, gint *width, gint *height, AtkCoordType coord_type); ATK_DEPRECATED_IN_2_12_FOR(atk_component_get_extents) void atk_component_get_position (AtkComponent *component, gint *x, gint *y, AtkCoordType coord_type); ATK_DEPRECATED_IN_2_12_FOR(atk_component_get_extents) void atk_component_get_size (AtkComponent *component, gint *width, gint *height); ATK_AVAILABLE_IN_ALL AtkLayer atk_component_get_layer (AtkComponent *component); ATK_AVAILABLE_IN_ALL gint atk_component_get_mdi_zorder (AtkComponent *component); ATK_AVAILABLE_IN_ALL gboolean atk_component_grab_focus (AtkComponent *component); ATK_DEPRECATED_IN_2_10 void atk_component_remove_focus_handler (AtkComponent *component, guint handler_id); ATK_AVAILABLE_IN_ALL gboolean atk_component_set_extents (AtkComponent *component, gint x, gint y, gint width, gint height, AtkCoordType coord_type); ATK_AVAILABLE_IN_ALL gboolean atk_component_set_position (AtkComponent *component, gint x, gint y, AtkCoordType coord_type); ATK_AVAILABLE_IN_ALL gboolean atk_component_set_size (AtkComponent *component, gint width, gint height); ATK_AVAILABLE_IN_ALL gdouble atk_component_get_alpha (AtkComponent *component); G_END_DECLS #endif /* __ATK_COMPONENT_H__ */