X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=cspi%2Fspi_hypertext.c;h=23c86f52d860e63dbae49c4c4eed833535789684;hb=d35cd400a36b0f1393c17ce47015bf753327ccae;hp=4db6950457ab84f1f4fdc049a5006b9e73b8e62f;hpb=408978dd34f3338e49b6ace5f60b7606579ce7a9;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git

diff --git a/cspi/spi_hypertext.c b/cspi/spi_hypertext.c
index 4db6950..23c86f5 100644
--- a/cspi/spi_hypertext.c
+++ b/cspi/spi_hypertext.c
@@ -1,47 +1,101 @@
-int
-SpiAccessibleHyperspi_text_ref (SpiAccessibleHypertext *obj)
+#include <cspi/spi-private.h>
+
+/**
+ * AccessibleHypertext_ref:
+ * @obj: a pointer to the #AccessibleHypertext object on which to operate.
+ *
+ * Increment the reference count for an #AccessibleHypertext object.
+ *       Since AccessibleHypertext is derived from AccessibleText,
+ *       this is the same as AccessibleText_unref().
+ *
+ * Returns: (no return code implemented yet).
+ *
+ **/
+void
+AccessibleHypertext_ref (AccessibleHypertext *obj)
 {
-  Accessibility_SpiHyperspi_text_ref (*obj, &ev);
-  return 0;
+  cspi_object_ref (obj);
 }
 
-
-
-int
-SpiAccessibleHyperspi_text_unref (SpiAccessibleHypertext *obj)
+/**
+ * AccessibleHypertext_unref:
+ * @obj: a pointer to the #AccessibleHypertext object on which to operate.
+ *
+ * Decrement the reference count for an #AccessibleHypertext object.
+ *       Since AccessibleHypertext is derived from AccessibleText,
+ *       this is the same as AccessibleText_unref().
+ *
+ * Returns: (no return code implemented yet).
+ *
+ **/
+void
+AccessibleHypertext_unref (AccessibleHypertext *obj)
 {
-  Accessibility_SpiHyperspi_text_unref (*obj, &ev);
-  return 0;
+  cspi_object_unref (obj);
 }
 
-
-
+/**
+ * AccessibleHypertext_getNLinks:
+ * @obj: a pointer to the #AccessibleHypertext implementor on which to operate.
+ *
+ * Get the total number of #AccessibleHyperlinks which an
+ *        #AccessibleHypertext implementor has.
+ *
+ * Returns: a #long indicating the number of #AccessibleHyperlinks
+ *        of the #AccessibleHypertext implementor, or -1 if
+ *        the number cannot be determined (for example, if the
+ *        #AccessibleHypertext object is so large that it is not
+ *        all currently in the memory cache).
+ *
+ **/
 long
-SpiAccessibleHyperspi_text_getNLinks (SpiAccessibleHypertext *obj)
+AccessibleHypertext_getNLinks (AccessibleHypertext *obj)
 {
   return (long)
-    Accessibility_SpiHyperspi_text_getNLinks (*obj, &ev);
+    Accessibility_Hypertext_getNLinks (CSPI_OBJREF (obj), cspi_ev ());
 }
 
 
-SpiAccessibleHyperlink *
-SpiAccessibleHyperSpiText_getLink (SpiAccessibleHypertext *obj,
-                             long linkIndex)
+/**
+ * AccessibleHypertext_getLink:
+ * @obj: a pointer to the #AccessibleHypertext implementor on which to operate.
+ * @linkIndex: a (zero-index) long integer indicating which hyperlink to query.
+ *
+ * Get the #AccessibleHyperlink object at a specified index.
+ *
+ * Returns: the #AccessibleHyperlink object specified by #linkIndex.
+ *
+ **/
+AccessibleHyperlink *
+AccessibleHypertext_getLink (AccessibleHypertext *obj,
+                             long int linkIndex)
 {
-  return (SpiAccessibleHyperlink *)
-    Accessibility_SpiHyperspi_text_getLink (*obj,
-				     (CORBA_long) linkIndex, &ev);
+  return (AccessibleHyperlink *)
+    Accessibility_Hypertext_getLink (CSPI_OBJREF (obj),
+				     (CORBA_long) linkIndex, cspi_ev ());
 }
 
 
-
+/**
+ * AccessibleHypertext_getLinkIndex:
+ * @obj: a pointer to the #AccessibleHypertext implementor on which to operate.
+ * @characterOffset: an integer specifying the character offset to query.
+ *
+ * Get the index of the #AccessibleHyperlink object at a specified
+ *        character offset.
+ *
+ * Returns: the linkIndex of the #AccessibleHyperlink active at
+ *        character offset @characterOffset, or -1 if there is
+ *        no hyperlink at the specified character offset.
+ *
+ **/
 long
-SpiAccessibleHyperspi_text_getLinkIndex (SpiAccessibleHypertext *obj,
-                                  long characterIndex)
+AccessibleHypertext_getLinkIndex (AccessibleHypertext *obj,
+                                  long int characterOffset)
 {
   return (long)
-    Accessibility_SpiHyperspi_text_getLinkIndex (*obj,
-					  (CORBA_long) characterIndex, &ev);
+    Accessibility_Hypertext_getLinkIndex (CSPI_OBJREF (obj),
+					  (CORBA_long) characterOffset, cspi_ev ());
 }