atkhyperlinkimpl.h (2865B)
1 /* ATK - Accessibility Toolkit 2 * Copyright 2001 Sun Microsystems Inc. 3 * 4 * This library is free software; you can redistribute it and/or 5 * modify it under the terms of the GNU Library 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. 8 * 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 * Library General Public License for more details. 13 * 14 * You should have received a copy of the GNU Library 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. 18 */ 19 20 #ifndef __ATK_HYPERLINK_IMPL_H__ 21 #define __ATK_HYPERLINK_IMPL_H__ 22 23 #include <atk/atkobject.h> 24 #include <atk/atkhyperlink.h> 25 26 #ifdef __cplusplus 27 extern "C" { 28 #endif /* __cplusplus */ 29 30 /* 31 * The AtkHyperlinkImpl interface should be supported by objects 32 * exposed within the hierarchy as children of an AtkHypertext container 33 * which correspond to "links" or embedded content within the text. 34 * HTML anchors are not, for instance, normally exposed this way, 35 * but embedded images and components which appear inline in the 36 * content of a text object are. The AtkHyperlinkIface interface 37 * allows a means of determining which children are hyperlinks in this 38 * sense of the word, and for obtaining their corresponding AtkHyperlink 39 * object, from which the embedding range, URI, etc. can be obtained. 40 * 41 * To some extent this interface exists because, for historical 42 * reasons, AtkHyperlink was defined as an object type, not an interface. 43 * Thus, in order to interact with AtkObjects via AtkHyperlink semantics, 44 * a new interface was required. 45 */ 46 47 #define ATK_TYPE_HYPERLINK_IMPL (atk_hyperlink_impl_get_type ()) 48 #define ATK_IS_HYPERLINK_IMPL(obj) G_TYPE_CHECK_INSTANCE_TYPE ((obj), ATK_TYPE_HYPERLINK_IMPL) 49 #define ATK_HYPERLINK_IMPL(obj) G_TYPE_CHECK_INSTANCE_CAST ((obj), ATK_TYPE_HYPERLINK_IMPL, AtkHyperlinkImpl) 50 #define ATK_HYPERLINK_IMPL_GET_IFACE(obj) G_TYPE_INSTANCE_GET_INTERFACE ((obj), ATK_TYPE_HYPERLINK_IMPL, AtkHyperlinkImplIface) 51 52 #ifndef _TYPEDEF_ATK_HYPERLINK_IMPL_ 53 #define _TYPEDEF_ATK_HYPERLINK_IMPL__ 54 typedef struct _AtkHyperlinkImpl AtkHyperlinkImpl; 55 #endif 56 typedef struct _AtkHyperlinkImplIface AtkHyperlinkImplIface; 57 58 struct _AtkHyperlinkImplIface 59 { 60 GTypeInterface parent; 61 62 AtkHyperlink* (* get_hyperlink) (AtkHyperlinkImpl *impl); 63 64 AtkFunction pad1; 65 }; 66 67 GType atk_hyperlink_impl_get_type (void); 68 69 AtkHyperlink *atk_hyperlink_impl_get_hyperlink (AtkHyperlinkImpl *obj); 70 71 #ifdef __cplusplus 72 } 73 #endif /* __cplusplus */ 74 75 76 #endif /* __ATK_HYPERLINK_IMPL_H__ */