Merge branch 'bug-623' into release/1.43.0

[simantics/platform.git] / bundles / org.eclipse.swt.win32.win32.x86_64 / src / org / eclipse / swt / accessibility / AccessibleHyperlinkAdapter.java

diff --git a/bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/accessibility/AccessibleHyperlinkAdapter.java b/bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/accessibility/AccessibleHyperlinkAdapter.java
new file mode 100644 (file)
index 0000000..18254f7
--- /dev/null
+++ b/bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/accessibility/AccessibleHyperlinkAdapter.java
@@ -0,0 +1,91 @@
+/*******************************************************************************
+ * Copyright (c) 2009, 2016 IBM Corporation and others.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License 2.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     IBM Corporation - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.swt.accessibility;
+
+/**
+ * This adapter class provides default implementations for the
+ * methods in the <code>AccessibleHyperlinkListener</code> interface.
+ * <p>
+ * Classes that wish to deal with <code>AccessibleHyperlink</code> events can
+ * extend this class and override only the methods that they are
+ * interested in.
+ * </p>
+ *
+ * @see AccessibleHyperlinkListener
+ * @see AccessibleHyperlinkEvent
+ *
+ * @since 3.6
+ */
+public class AccessibleHyperlinkAdapter implements AccessibleHyperlinkListener {
+       /**
+        * Returns the anchor for the link at the specified index.
+        *
+        * @param e an event object containing the following fields:<ul>
+        * <li>[in] index - a 0 based index identifying the anchor if this object
+        *              has more than one link, as in the case of an image map</li>
+        * <li>[typical out] result - the returned anchor</li>
+        * <li>[optional out] accessible - the returned anchor.
+        *              Note: The returned anchor can either be a string or an accessible.
+        *              For example, for a text link this could be the substring of the containing string
+        *              where the substring is overridden with link behavior, and for an image link this could be
+        *              the accessible for the image.</li>
+        * </ul>
+        */
+       @Override
+       public void getAnchor(AccessibleHyperlinkEvent e) {}
+
+       /**
+        * Returns the target of the link at the specified index.
+        *
+        * @param e an event object containing the following fields:<ul>
+        * <li>[in] index - a 0 based index identifying the anchor if this object
+        *              has more than one link, as in the case of an image map</li>
+        * <li>[typical out] result - the returned target</li>
+        * <li>[optional out] accessible - the returned target.
+        *              Note: The returned target can either be a string or an accessible.
+        *              For example, this could be a string URI, or the accessible for the target
+        *              object to be activated when the link is activated.</li>
+        * </ul>
+        */
+       @Override
+       public void getAnchorTarget(AccessibleHyperlinkEvent e) {}
+
+       /**
+        * Returns the 0 based character offset at which the textual representation of the hyperlink starts.
+        * <p>
+        * The returned value is related to the AccessibleTextExtended interface of the object that
+        * owns this hyperlink.
+        * </p>
+        *
+        * @param e an event object containing the following fields:<ul>
+        * <li>[out] index</li>
+        * </ul>
+        */
+       @Override
+       public void getStartIndex(AccessibleHyperlinkEvent e) {}
+
+       /**
+        * Returns the 0 based character offset at which the textual representation of the hyperlink ends.
+        * <p>
+        * The returned value is related to the AccessibleTextExtended interface of the object that
+        * owns this hyperlink. The character at the index is not part of the hypertext.
+        * </p>
+        *
+        * @param e an event object containing the following fields:<ul>
+        * <li>[out] index</li>
+        * </ul>
+        */
+       @Override
+       public void getEndIndex(AccessibleHyperlinkEvent e) {}
+}