atk/atkhyperlink.c

   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 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.
   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  * Lesser General Public License for more details.
  13  *
  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.
  18  */
  19
  20 #include "atkhyperlink.h"
  21
  22
  23 static void atk_hyperlink_class_init (AtkHyperlinkClass *klass);
  24 static void atk_hyperlink_init       (AtkHyperlink      *link,
  25                                       AtkHyperlinkClass *klass);
  26
  27 static void atk_hyperlink_action_iface_init (AtkActionIface *iface);
  28
  29 static gpointer  parent_class = NULL;
  30
  31 GType
  32 atk_hyperlink_get_type (void)
  33 {
  34   static GType type = 0;
  35
  36   if (!type)
  37     {
  38       static const GTypeInfo typeInfo =
  39       {
  40         sizeof (AtkHyperlinkClass),
  41         (GBaseInitFunc) NULL,
  42         (GBaseFinalizeFunc) NULL,
  43         (GClassInitFunc) atk_hyperlink_class_init,
  44         (GClassFinalizeFunc) NULL,
  45         NULL,
  46         sizeof (AtkObject),
  47         0,
  48         (GInstanceInitFunc) atk_hyperlink_init,
  49       } ;
  50
  51       static const GInterfaceInfo action_info =
  52       {
  53         (GInterfaceInitFunc) atk_hyperlink_action_iface_init,
  54         (GInterfaceFinalizeFunc) NULL,
  55         NULL
  56       };
  57
  58       type = g_type_register_static (G_TYPE_OBJECT, "AtkHyperlink", &typeInfo, 0) ;
  59       g_type_add_interface_static (type, ATK_TYPE_ACTION, &action_info);
  60     }
  61   return type;
  62 }
  63
  64 static void
  65 atk_hyperlink_class_init (AtkHyperlinkClass *klass)
  66 {
  67   parent_class = g_type_class_ref (G_TYPE_OBJECT);
  68
  69 }
  70
  71 static void
  72 atk_hyperlink_init  (AtkHyperlink        *link,
  73                      AtkHyperlinkClass   *klass)
  74 {
  75 }
  76
  77 /**
  78  * atk_hyperlink_get_uri:
  79  * @link: an #AtkHyperlink
  80  * @i: a (zero-index) integer specifying the desired anchor
  81  *
  82  * Get a the URI associated with the anchor specified
  83  * by @i of @link.
  84  *
  85  * Multiple anchors are primarily used by client-side image maps.
  86  *
  87  * Returns: a string specifying the URI
  88  **/
  89 gchar*
  90 atk_hyperlink_get_uri (AtkHyperlink *link,
  91                        gint         i)
  92 {
  93   AtkHyperlinkClass *klass;
  94
  95   g_return_val_if_fail (link != NULL, NULL);
  96   g_return_val_if_fail (ATK_IS_HYPERLINK (link), NULL);
  97
  98   klass = ATK_HYPERLINK_GET_CLASS (link);
  99   if (klass->get_uri)
 100     return (klass->get_uri) (link, i);
 101   else
 102     return NULL;
 103 }
 104
 105 /**
 106  * atk_hyperlink_get_object:
 107  * @link: an #AtkHyperlink
 108  * @i: a (zero-index) integer specifying the desired anchor
 109  *
 110  * Returns the item associated with this hyperlinks nth anchor. For instance,
 111  * the returned #AtkObject will implement #AtkText if @link is a text hyperlink,
 112  * #AtkImage if @link is an image hyperlink etc.
 113  *
 114  * Multiple anchors are primarily used by client-side image maps.
 115  *
 116  * Returns: an #AtkObject associated with this hyperlinks i-th anchor.
 117  **/
 118 AtkObject*
 119 atk_hyperlink_get_object (AtkHyperlink *link,
 120                           gint         i)
 121 {
 122   AtkHyperlinkClass *klass;
 123
 124   g_return_val_if_fail (link != NULL, NULL);
 125   g_return_val_if_fail (ATK_IS_HYPERLINK (link), NULL);
 126
 127   klass = ATK_HYPERLINK_GET_CLASS (link);
 128   if (klass->get_object)
 129     return (klass->get_object) (link, i);
 130   else
 131     return NULL;
 132 }
 133
 134 /**
 135  * atk_hyperlink_get_end_index:
 136  * @link: an #AtkHyperlink
 137  *
 138  * Gets the index with the hypertext document at which this link ends
 139  *
 140  * Returns: the index with the hypertext document at which this link ends
 141  **/
 142 gint
 143 atk_hyperlink_get_end_index (AtkHyperlink *link)
 144 {
 145   AtkHyperlinkClass *klass;
 146
 147   g_return_val_if_fail (link != NULL, 0);
 148   g_return_val_if_fail (ATK_IS_HYPERLINK (link), 0);
 149
 150   klass = ATK_HYPERLINK_GET_CLASS (link);
 151   if (klass->get_end_index)
 152     return (klass->get_end_index) (link);
 153   else
 154     return 0;
 155 }
 156
 157 /**
 158  * atk_hyperlink_get_start_index:
 159  * @link: an #AtkHyperlink
 160  *
 161  * Gets the index with the hypertext document at which this link begins
 162  *
 163  * Returns: the index with the hypertext document at which this link begins
 164  **/
 165 gint
 166 atk_hyperlink_get_start_index (AtkHyperlink *link)
 167 {
 168   AtkHyperlinkClass *klass;
 169
 170   g_return_val_if_fail (link != NULL, 0);
 171   g_return_val_if_fail (ATK_IS_HYPERLINK (link), 0);
 172
 173   klass = ATK_HYPERLINK_GET_CLASS (link);
 174   if (klass->get_start_index)
 175     return (klass->get_start_index) (link);
 176   else
 177     return 0;
 178 }
 179
 180 /**
 181  * atk_hyperlink_is_valid:
 182  * @link: an #AtkHyperlink
 183  *
 184  * Since the document a link is associated with may have changed, this
 185  * method returns whether or not this link is still valid (with respect
 186  * to the document is references)
 187  *
 188  * Returns: whether or not this link is still valid.
 189  **/
 190 gboolean
 191 atk_hyperlink_is_valid (AtkHyperlink *link)
 192 {
 193   AtkHyperlinkClass *klass;
 194
 195   g_return_val_if_fail (link != NULL, FALSE);
 196   g_return_val_if_fail (ATK_IS_HYPERLINK (link), FALSE);
 197
 198   klass = ATK_HYPERLINK_GET_CLASS (link);
 199   if (klass->is_valid)
 200     return (klass->is_valid) (link);
 201   else
 202     return FALSE;
 203 }
 204
 205 /**
 206  * atk_hyperlink_get_n_anchors:
 207  * @link: an #AtkHyperlink
 208  *
 209  * Gets the number of anchors associated with this hyperlink
 210  *
 211  * Returns: the number of anchors associated with this hyperlink
 212  **/
 213 gint
 214 atk_hyperlink_get_n_anchors (AtkHyperlink *link)
 215 {
 216   AtkHyperlinkClass *klass;
 217
 218   g_return_val_if_fail (link != NULL, 0);
 219   g_return_val_if_fail (ATK_IS_HYPERLINK (link), 0);
 220
 221   klass = ATK_HYPERLINK_GET_CLASS (link);
 222   if (klass->get_n_anchors)
 223     return (klass->get_n_anchors) (link);
 224   else
 225     return 0;
 226 }
 227
 228 static void atk_hyperlink_action_iface_init (AtkActionIface *iface)
 229 {
 230   /*
 231    * We do nothing here
 232    *
 233    * When we come to derive a class from AtkHyperlink we will provide an
 234    * implementation of the AtkAction interface.
 235    *
 236    * This depends on being able to override an interface in a derived class
 237    * which currently (March 2001) is not implemented but will be in GTK+ 2.0.
 238    */
 239 }