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

   1 /*******************************************************************************
   2  * Copyright (c) 2010, 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 methods
  22  * that deal with the events that are generated as touches
  23  * occur on a touch-aware input surface.
  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>addTouchListener</code> method and removed using
  28  * the <code>removeTouchListener</code> method. When a
  29  * touch occurs or changes state, the <code>touch</code> method
  30  * will be invoked.
  31  * </p>
  32  * <p>
  33  * <b>Warning</b>: This API is currently only implemented on Windows and Cocoa.
  34  * SWT doesn't send Gesture or Touch events on GTK.
  35  * </p>
  36  *
  37  * @see TouchEvent
  38  *
  39  * @since 3.7
  40  */
  41 @FunctionalInterface
  42 public interface TouchListener extends SWTEventListener {
  43
  44 /**
  45  * Sent when a touch sequence begins, changes state, or ends.
  46  *
  47  * @param e an event containing information about the touch
  48  */
  49 void touch(TouchEvent e);
  50 }