libspi/hyperlink.c

   1 /*
   2  * AT-SPI - Assistive Technology Service Provider Interface
   3  * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
   4  *
   5  * Copyright 2001, 2002 Sun Microsystems Inc.,
   6  * Copyright 2001, 2002 Ximian, Inc.
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Library General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Library General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Library General Public
  19  * License along with this library; if not, write to the
  20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  21  * Boston, MA 02111-1307, USA.
  22  */
  23
  24 /* hyperlink.c : implements the Hyperlink interface */
  25
  26 #include <config.h>
  27 #include <stdio.h>
  28 #include <libspi/hyperlink.h>
  29 #include <libspi/action.h>
  30 #include <libspi/accessible.h>
  31
  32 /* Static function declarations */
  33
  34 static void
  35 spi_hyperlink_class_init (SpiHyperlinkClass *klass);
  36 static void
  37 spi_hyperlink_init (SpiHyperlink *hyperlink);
  38 static CORBA_string
  39 impl_getURI (PortableServer_Servant _servant,
  40              const CORBA_long i, CORBA_Environment * ev);
  41 static CORBA_short
  42 impl__get_n_anchors (PortableServer_Servant _servant,
  43                      CORBA_Environment * ev);
  44 static CORBA_long
  45 impl__get_startIndex (PortableServer_Servant _servant,
  46                       CORBA_Environment * ev);
  47 static CORBA_long
  48 impl__get_endIndex (PortableServer_Servant _servant,
  49                     CORBA_Environment * ev);
  50 static Accessibility_Accessible
  51 impl_getObject (PortableServer_Servant _servant,
  52                 const CORBA_long i,
  53                 CORBA_Environment * ev);
  54 static CORBA_boolean
  55 impl_isValid (PortableServer_Servant _servant,
  56               CORBA_Environment * ev);
  57
  58
  59 BONOBO_TYPE_FUNC_FULL (SpiHyperlink,
  60                        Accessibility_Hyperlink,
  61                        SPI_TYPE_BASE,
  62                        spi_hyperlink)
  63
  64
  65 static void
  66 spi_hyperlink_class_init (SpiHyperlinkClass *klass)
  67 {
  68   POA_Accessibility_Hyperlink__epv *epv = &klass->epv;
  69
  70   /* Initialize epv table */
  71
  72   epv->_get_nAnchors = impl__get_n_anchors;
  73   epv->getURI = impl_getURI;
  74   epv->_get_startIndex = impl__get_startIndex;
  75   epv->_get_endIndex = impl__get_endIndex;
  76   epv->getObject = impl_getObject;
  77   epv->isValid = impl_isValid;
  78 }
  79
  80
  81 static void
  82 spi_hyperlink_init (SpiHyperlink *hyperlink)
  83 {
  84 }
  85
  86
  87 SpiHyperlink *
  88 spi_hyperlink_new (AtkHyperlink *object)
  89 {
  90   SpiHyperlink *new_hyperlink = g_object_new (
  91           SPI_HYPERLINK_TYPE, NULL);
  92
  93   spi_base_construct (SPI_BASE (new_hyperlink), G_OBJECT(object));
  94
  95   /*
  96    * some hyperlinks are actionable... this is an ATK convention
  97    * that seems convenient though possibly poorly documented or unintended.
  98    */
  99   if (ATK_IS_ACTION (object))
 100     {
 101       /*
 102        * NOTE: we don't cast 'object' to ATK_OBJECT in the call to
 103        * spi_action_interface_new(), because of the above convention,
 104        * even though it means we may be violating the func prototype.
 105        * See discussion in bugzilla bug #120659.
 106        */
 107       bonobo_object_add_interface (bonobo_object (new_hyperlink),
 108                                    BONOBO_OBJECT (spi_action_interface_new (object)));
 109     }
 110   return new_hyperlink;
 111 }
 112
 113 static AtkHyperlink *
 114 get_hyperlink_from_servant (PortableServer_Servant servant)
 115 {
 116   SpiBase *object = SPI_BASE (bonobo_object_from_servant (servant));
 117
 118   g_return_val_if_fail (object != NULL, NULL);
 119   g_return_val_if_fail (ATK_IS_HYPERLINK(object->gobj), NULL);
 120   return ATK_HYPERLINK (object->gobj);
 121 }
 122
 123
 124 static CORBA_short
 125 impl__get_n_anchors (PortableServer_Servant servant,
 126                      CORBA_Environment     *ev)
 127 {
 128   AtkHyperlink *link = get_hyperlink_from_servant (servant);
 129
 130   g_return_val_if_fail (link != NULL, 0);
 131
 132   return atk_hyperlink_get_n_anchors (link);
 133 }
 134
 135
 136 static CORBA_long
 137 impl__get_startIndex (PortableServer_Servant servant,
 138                       CORBA_Environment     *ev)
 139 {
 140   AtkHyperlink *link = get_hyperlink_from_servant (servant);
 141
 142   g_return_val_if_fail (link != NULL, -1);
 143
 144   return atk_hyperlink_get_start_index (link);
 145 }
 146
 147
 148 static CORBA_long
 149 impl__get_endIndex (PortableServer_Servant servant,
 150                     CORBA_Environment     *ev)
 151 {
 152   AtkHyperlink *link = get_hyperlink_from_servant (servant);
 153
 154   g_return_val_if_fail (link != NULL, -1);
 155
 156   return atk_hyperlink_get_end_index (link);
 157 }
 158
 159
 160 static CORBA_string
 161 impl_getURI (PortableServer_Servant servant,
 162              const CORBA_long i, CORBA_Environment *ev)
 163 {
 164   gchar *uri;
 165   CORBA_char *rv;
 166   AtkHyperlink *link = get_hyperlink_from_servant (servant);
 167
 168   g_return_val_if_fail (link != NULL, CORBA_string_dup (""));
 169
 170   uri = atk_hyperlink_get_uri (link, i);
 171   if (uri)
 172     {
 173       rv = CORBA_string_dup (uri);
 174       g_free (uri);
 175     }
 176   else
 177     rv = CORBA_string_dup ("");
 178
 179   return rv;
 180 }
 181
 182
 183 static Accessibility_Accessible
 184 impl_getObject (PortableServer_Servant servant,
 185                 const CORBA_long       i,
 186                 CORBA_Environment     *ev)
 187 {
 188   AtkObject    *atk_object;
 189   AtkHyperlink *link = get_hyperlink_from_servant (servant);
 190
 191   g_return_val_if_fail (link != NULL, CORBA_OBJECT_NIL);
 192
 193   atk_object = atk_hyperlink_get_object (link, i);
 194
 195   return spi_accessible_new_return (atk_object, FALSE, ev);
 196 }
 197
 198
 199 static CORBA_boolean
 200 impl_isValid (PortableServer_Servant servant,
 201               CORBA_Environment     *ev)
 202 {
 203   AtkHyperlink *link = get_hyperlink_from_servant (servant);
 204
 205   g_return_val_if_fail (link != NULL, TRUE);
 206
 207   return atk_hyperlink_is_valid (link);
 208 }
 209