1 /* ATK - Accessibility Toolkit
2 * Copyright 2001, 2002, 2003 Sun Microsystems Inc.
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.
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.
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.
21 #include "atkhyperlink.h"
22 #include <glib/gi18n-lib.h>
25 * SECTION:atkhyperlink
26 * @Short_description: An ATK object which encapsulates a link or set
27 * of links in a hypertext document.
30 * An ATK object which encapsulates a link or set of links (for
31 * instance in the case of client-side image maps) in a hypertext
32 * document. It may implement the AtkAction interface. AtkHyperlink
33 * may also be used to refer to inline embedded content, since it
34 * allows specification of a start and end offset within the host
35 * AtkHypertext object.
47 PROP_0
, /* gobject convention */
56 static void atk_hyperlink_class_init (AtkHyperlinkClass
*klass
);
57 static void atk_hyperlink_init (AtkHyperlink
*link
,
58 AtkHyperlinkClass
*klass
);
60 static void atk_hyperlink_real_get_property (GObject
*object
,
65 static void atk_hyperlink_action_iface_init (AtkActionIface
*iface
);
67 static guint atk_hyperlink_signals
[LAST_SIGNAL
] = { 0, };
69 static gpointer parent_class
= NULL
;
72 atk_hyperlink_get_type (void)
74 static GType type
= 0;
78 static const GTypeInfo typeInfo
=
80 sizeof (AtkHyperlinkClass
),
82 (GBaseFinalizeFunc
) NULL
,
83 (GClassInitFunc
) atk_hyperlink_class_init
,
84 (GClassFinalizeFunc
) NULL
,
86 sizeof (AtkHyperlink
),
88 (GInstanceInitFunc
) atk_hyperlink_init
,
91 static const GInterfaceInfo action_info
=
93 (GInterfaceInitFunc
) atk_hyperlink_action_iface_init
,
94 (GInterfaceFinalizeFunc
) NULL
,
98 type
= g_type_register_static (G_TYPE_OBJECT
, "AtkHyperlink", &typeInfo
, 0) ;
99 g_type_add_interface_static (type
, ATK_TYPE_ACTION
, &action_info
);
105 atk_hyperlink_class_init (AtkHyperlinkClass
*klass
)
107 GObjectClass
*gobject_class
= G_OBJECT_CLASS (klass
);
109 parent_class
= g_type_class_peek_parent (klass
);
111 gobject_class
->get_property
= atk_hyperlink_real_get_property
;
113 klass
->link_activated
= NULL
;
116 * AtkHyperlink:selected-link:
120 * Deprecated: Since 1.8. This property is deprecated since ATK
121 * version 1.8. Please use ATK_STATE_FOCUSABLE for all links, and
122 * ATK_STATE_FOCUSED for focused links.
125 g_object_class_install_property (gobject_class
,
127 g_param_spec_boolean ("selected-link",
129 _("Specifies whether the AtkHyperlink object is selected"),
132 g_object_class_install_property (gobject_class
,
134 g_param_spec_int ("number-of-anchors",
135 _("Number of Anchors"),
136 _("The number of anchors associated with the AtkHyperlink object"),
141 g_object_class_install_property (gobject_class
,
143 g_param_spec_int ("end-index",
145 _("The end index of the AtkHyperlink object"),
150 g_object_class_install_property (gobject_class
,
152 g_param_spec_int ("start-index",
154 _("The start index of the AtkHyperlink object"),
161 * AtkHyperlink::link-activated:
162 * @atkhyperlink: the object which received the signal.
164 * The signal link-activated is emitted when a link is activated.
166 atk_hyperlink_signals
[LINK_ACTIVATED
] =
167 g_signal_new ("link_activated",
168 G_TYPE_FROM_CLASS (klass
),
170 G_STRUCT_OFFSET (AtkHyperlinkClass
, link_activated
),
172 g_cclosure_marshal_VOID__VOID
,
179 atk_hyperlink_init (AtkHyperlink
*link
,
180 AtkHyperlinkClass
*klass
)
185 atk_hyperlink_real_get_property (GObject
*object
,
192 link
= ATK_HYPERLINK (object
);
196 case PROP_SELECTED_LINK
:
197 // This property is deprecated, also the method to get the value
198 g_value_set_boolean (value
, FALSE
);
200 case PROP_NUMBER_ANCHORS
:
201 g_value_set_int (value
, atk_hyperlink_get_n_anchors (link
));
204 g_value_set_int (value
, atk_hyperlink_get_end_index (link
));
206 case PROP_START_INDEX
:
207 g_value_set_int (value
, atk_hyperlink_get_start_index (link
));
215 * atk_hyperlink_get_uri:
216 * @link_: an #AtkHyperlink
217 * @i: a (zero-index) integer specifying the desired anchor
219 * Get a the URI associated with the anchor specified
222 * Multiple anchors are primarily used by client-side image maps.
224 * Returns: a string specifying the URI
227 atk_hyperlink_get_uri (AtkHyperlink
*link
,
230 AtkHyperlinkClass
*klass
;
232 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), NULL
);
234 klass
= ATK_HYPERLINK_GET_CLASS (link
);
236 return (klass
->get_uri
) (link
, i
);
242 * atk_hyperlink_get_object:
243 * @link_: an #AtkHyperlink
244 * @i: a (zero-index) integer specifying the desired anchor
246 * Returns the item associated with this hyperlinks nth anchor.
247 * For instance, the returned #AtkObject will implement #AtkText
248 * if @link_ is a text hyperlink, #AtkImage if @link_ is an image
251 * Multiple anchors are primarily used by client-side image maps.
253 * Returns: (transfer none): an #AtkObject associated with this hyperlinks
257 atk_hyperlink_get_object (AtkHyperlink
*link
,
260 AtkHyperlinkClass
*klass
;
262 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), NULL
);
264 klass
= ATK_HYPERLINK_GET_CLASS (link
);
265 if (klass
->get_object
)
266 return (klass
->get_object
) (link
, i
);
272 * atk_hyperlink_get_end_index:
273 * @link_: an #AtkHyperlink
275 * Gets the index with the hypertext document at which this link ends.
277 * Returns: the index with the hypertext document at which this link ends
280 atk_hyperlink_get_end_index (AtkHyperlink
*link
)
282 AtkHyperlinkClass
*klass
;
284 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), 0);
286 klass
= ATK_HYPERLINK_GET_CLASS (link
);
287 if (klass
->get_end_index
)
288 return (klass
->get_end_index
) (link
);
294 * atk_hyperlink_get_start_index:
295 * @link_: an #AtkHyperlink
297 * Gets the index with the hypertext document at which this link begins.
299 * Returns: the index with the hypertext document at which this link begins
302 atk_hyperlink_get_start_index (AtkHyperlink
*link
)
304 AtkHyperlinkClass
*klass
;
306 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), 0);
308 klass
= ATK_HYPERLINK_GET_CLASS (link
);
309 if (klass
->get_start_index
)
310 return (klass
->get_start_index
) (link
);
316 * atk_hyperlink_is_valid:
317 * @link_: an #AtkHyperlink
319 * Since the document that a link is associated with may have changed
320 * this method returns %TRUE if the link is still valid (with
321 * respect to the document it references) and %FALSE otherwise.
323 * Returns: whether or not this link is still valid
326 atk_hyperlink_is_valid (AtkHyperlink
*link
)
328 AtkHyperlinkClass
*klass
;
330 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), FALSE
);
332 klass
= ATK_HYPERLINK_GET_CLASS (link
);
334 return (klass
->is_valid
) (link
);
340 * atk_hyperlink_is_inline:
341 * @link_: an #AtkHyperlink
343 * Indicates whether the link currently displays some or all of its
344 * content inline. Ordinary HTML links will usually return
345 * %FALSE, but an inline <src> HTML element will return
348 * Returns: whether or not this link displays its content inline.
352 atk_hyperlink_is_inline (AtkHyperlink
*link
)
354 AtkHyperlinkClass
*klass
;
356 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), FALSE
);
358 klass
= ATK_HYPERLINK_GET_CLASS (link
);
359 if (klass
->link_state
)
360 return (klass
->link_state (link
) & ATK_HYPERLINK_IS_INLINE
);
366 * atk_hyperlink_get_n_anchors:
367 * @link_: an #AtkHyperlink
369 * Gets the number of anchors associated with this hyperlink.
371 * Returns: the number of anchors associated with this hyperlink
374 atk_hyperlink_get_n_anchors (AtkHyperlink
*link
)
376 AtkHyperlinkClass
*klass
;
378 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), 0);
380 klass
= ATK_HYPERLINK_GET_CLASS (link
);
381 if (klass
->get_n_anchors
)
382 return (klass
->get_n_anchors
) (link
);
388 * atk_hyperlink_is_selected_link:
389 * @link_: an #AtkHyperlink
391 * Determines whether this AtkHyperlink is selected
395 * Deprecated: This method is deprecated since ATK version 1.8.
396 * Please use ATK_STATE_FOCUSABLE for all links, and ATK_STATE_FOCUSED
399 * Returns: True if the AtkHyperlink is selected, False otherwise
402 atk_hyperlink_is_selected_link (AtkHyperlink
*link
)
404 AtkHyperlinkClass
*klass
;
406 g_return_val_if_fail (ATK_IS_HYPERLINK (link
), FALSE
);
408 klass
= ATK_HYPERLINK_GET_CLASS (link
);
409 if (klass
->is_selected_link
)
410 return (klass
->is_selected_link
) (link
);
415 static void atk_hyperlink_action_iface_init (AtkActionIface
*iface
)
420 * When we come to derive a class from AtkHyperlink we will provide an
421 * implementation of the AtkAction interface.