1 #include <cspi/spi-private.h>
4 * AccessibleHyperlink_ref:
5 * @obj: a pointer to the #AccessibleHyperlink object on which to operate.
7 * Increment the reference count for an #AccessibleHyperlink object.
10 AccessibleHyperlink_ref (AccessibleHyperlink *obj)
12 cspi_object_ref (obj);
16 * AccessibleHyperlink_unref:
17 * @obj: a pointer to the #AccessibleHyperlink object on which to operate.
19 * Decrement the reference count for an #AccessibleHyperlink object.
22 AccessibleHyperlink_unref (AccessibleHyperlink *obj)
24 cspi_object_ref (obj);
28 * AccessibleHyperlink_getNAnchors:
29 * @obj: a pointer to the #AccessibleHyperlink object on which to operate.
31 * Get the total number of anchors which an #AccessibleHyperlink implementor has.
32 * Though typical hyperlinks have only one anchor, client-side image maps and
33 * other hypertext objects may potentially activate or refer to multiple
34 * URIs. For each anchor there is a corresponding URI and object.
35 * @see AccessibleHyperlink_getURI() and AccessibleHyperlink_getObject().
37 * Returns: a #long indicating the number of anchors in this hyperlink.
40 AccessibleHyperlink_getNAnchors (AccessibleHyperlink *obj)
44 cspi_return_val_if_fail (obj != NULL, -1);
47 Accessibility_Hyperlink__get_nAnchors (CSPI_OBJREF (obj), cspi_ev ());
49 cspi_return_val_if_ev ("getNAnchors", -1);
55 * AccessibleHyperlink_getURI:
56 * @obj: a pointer to the #AccessibleHyperlink implementor on which to operate.
57 * @i: a (zero-index) long integer indicating which hyperlink anchor to query.
59 * Get the URI associated with a particular hyperlink anchor.
61 * Returns: a UTF-8 string giving the URI of the @ith hyperlink anchor.
64 AccessibleHyperlink_getURI (AccessibleHyperlink *obj,
69 cspi_return_val_if_fail (obj != NULL, NULL);
72 Accessibility_Hyperlink_getURI (CSPI_OBJREF (obj),
73 (CORBA_long) i, cspi_ev ());
75 cspi_return_val_if_ev ("getURI", NULL);
81 * AccessibleHyperlink_getObject:
82 * @obj: a pointer to the #AccessibleHyperlink implementor on which to operate.
83 * @i: a (zero-index) long integer indicating which hyperlink anchor to query.
85 * Get the object associated with a particular hyperlink anchor, as an #Accessible.
87 * Returns: an #Accessible that represents the object associated with the @ith anchor
88 * of the specified #AccessibleHyperlink.
91 AccessibleHyperlink_getObject (AccessibleHyperlink *obj,
94 cspi_return_val_if_fail (obj != NULL, NULL);
96 return cspi_object_add (
97 Accessibility_Hyperlink_getObject (CSPI_OBJREF (obj),
98 (CORBA_long) i, cspi_ev ()));
102 * AccessibleHyperlink_getIndexRange:
103 * @obj: a pointer to the #AccessibleHyperlink implementor on which to operate.
104 * @startIndex: a pointer to a long integer into which the starting
105 * offset of the text associated with this #AccessibleHyperlink is returned.
106 * @endIndex: a pointer to a long integer into which the offset of the first character
107 * after the text associated with this #AccessibleHyperlink is returned.
110 * Get the starting and ending character offsets of the text range associated with
111 * a #AccessibleHyperlink, in its originating #AccessibleHypertext.
114 AccessibleHyperlink_getIndexRange (AccessibleHyperlink *obj,
115 long int *startIndex,
120 cspi_return_if_fail (obj != NULL);
123 Accessibility_Hyperlink__get_startIndex (CSPI_OBJREF (obj), cspi_ev ());
125 Accessibility_Hyperlink__get_endIndex (CSPI_OBJREF (obj), cspi_ev ());
127 cspi_return_if_ev ("getIndexRange");
131 * AccessibleHyperlink_isValid:
132 * @obj: a pointer to the #AccessibleHyperlink on which to operate.
134 * Tell whether an #AccessibleHyperlink object is still valid with respect to its
135 * originating hypertext object.
137 * Returns: #TRUE of the specified #AccessibleHyperlink is still valid with respect
138 * to its originating #AccessibleHypertext object, #FALSE otherwise.
141 AccessibleHyperlink_isValid (AccessibleHyperlink *obj)
145 cspi_return_val_if_fail (obj != NULL, FALSE);
148 Accessibility_Hyperlink_isValid (CSPI_OBJREF (obj), cspi_ev ());
150 cspi_return_val_if_ev ("isValid", FALSE);