bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/events/TraverseListener.java

   1 /*******************************************************************************
   2  * Copyright (c) 2000, 2016 IBM Corporation and others.
   3  *
   4  * This program and the accompanying materials
   5  * are made available under the terms of the Eclipse Public License 2.0
   6  * which accompanies this distribution, and is available at
   7  * https://www.eclipse.org/legal/epl-2.0/
   8  *
   9  * SPDX-License-Identifier: EPL-2.0
  10  *
  11  * Contributors:
  12  *     IBM Corporation - initial API and implementation
  13  *     Lars Vogel <Lars.Vogel@vogella.com> - Bug 502576
  14  *******************************************************************************/
  15 package org.eclipse.swt.events;
  16
  17
  18 import org.eclipse.swt.internal.*;
  19
  20 /**
  21  * Classes which implement this interface provide a method
  22  * that deals with the events that are generated when a
  23  * traverse event occurs in a control.
  24  * <p>
  25  * After creating an instance of a class that implements
  26  * this interface it can be added to a control using the
  27  * <code>addTraverseListener</code> method and removed using
  28  * the <code>removeTraverseListener</code> method. When a
  29  * traverse event occurs in a control, the keyTraversed method
  30  * will be invoked.
  31  * </p>
  32  *
  33  * @see TraverseEvent
  34  */
  35 @FunctionalInterface
  36 public interface TraverseListener extends SWTEventListener {
  37
  38 /**
  39  * Sent when a traverse event occurs in a control.
  40  * <p>
  41  * A traverse event occurs when the user presses a traversal
  42  * key. Traversal keys are typically tab and arrow keys, along
  43  * with certain other keys on some platforms. Traversal key
  44  * constants beginning with <code>TRAVERSE_</code> are defined
  45  * in the <code>SWT</code> class.
  46  * </p>
  47  *
  48  * @param e an event containing information about the traverse
  49  */
  50 void keyTraversed(TraverseEvent e);
  51 }