X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=xml%2Forg.freedesktop.atspi.Hyperlink.xml;h=d2f2d79f3ce6d8959595eedccf5d41e9c9f7d28a;hb=c21124faa3a36efbd3300f08861f974de9d866aa;hp=ae39f0d2e2e68dd7c6772186d8732cba52ea65f7;hpb=7b966cf7ccd4f530e0250bcc8ec6880cbb6d20e3;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git diff --git a/xml/org.freedesktop.atspi.Hyperlink.xml b/xml/org.freedesktop.atspi.Hyperlink.xml index ae39f0d..d2f2d79 100644 --- a/xml/org.freedesktop.atspi.Hyperlink.xml +++ b/xml/org.freedesktop.atspi.Hyperlink.xml @@ -1,29 +1,15 @@ - + + + + -AT-SPI - Assistive Technology Service Provider Interface -Copyright 2008 Novell, Inc. -Copyright 2001 Sun Microsystems, Inc. - -

This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library General Public - License as published by the Free Software Foundation; either - version 2 of the License, or (at your option) any later version.

-

This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Library General Public License for more details.

-

You should have received a copy of the GNU Library General Public - License along with this library; if not, write to the - Free Software Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA.

-

Instances of Hyperlink are returned by Hypertext objects, and are the means by which end users and clients interact with linked, and in - some cases embedded, content. Hyperlinks may have multiple "anchors", + some cases embedded, content. Hyperlinks may have multiple "anchors", where an anchor corresponds to a reference to a particular resource with a corresponding resource identified (URI). Hyperlinks may be queried for their URIs, or queried for the objects corresponding to their @@ -31,9 +17,9 @@ and may be queried, and manipulated via the Action interface.

@note A Hyperlink implementor is normally NOT an Accessible; - the preferred usage is for a Hyperlink's associated "objects" + the preferred usage is for a Hyperlink's associated "objects" (accessed via the ::getObject method) are Accessibles. This means - that Actions such as "open link" are normally invoked on + that Actions such as "open link" are normally invoked on the result of Hyperlink::getObject rather than directly on the Hyperlink instance. For historical reasons some implementors of Hyperlink implement Action as well. This usage on the part of implementing @@ -65,13 +51,13 @@ Hyperlink::numAnchors - 1, inclusive) associated with a Hyperlink. The objects returned are usually actionable (i.e. they should implement Accessibility::Action), and the available actions often include - "open", "bookmark", "save link as", etc. They may also implement + "open", "bookmark", "save link as", etc. They may also implement Accessibility::StreamableContent, although clients can normally use ::getURI to obtain a resource locator via which the object's data may be accessed.

@note the most common application for 'multi anchor' - hyperlinks in HTML is probably "client side imagemaps". + hyperlinks in HTML is probably "client side imagemaps". A clickable image which uses the HTML 'usemap' attribute should have one anchor for every <area> element that includes an HREF. The objects corresponding to these map @@ -89,7 +75,7 @@

Obtain a resource locator ('URI') which can be used to - access the content to which this link "points" or is connected.

+ access the content to which this link "points" or is connected.