bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/events/VerifyListener.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 text
  23  * is about to be modified.
  24  * <p>
  25  * After creating an instance of a class that implements
  26  * this interface it can be added to a text control using the
  27  * <code>addVerifyListener</code> method and removed using
  28  * the <code>removeVerifyListener</code> method. When the
  29  * text is about to be modified, the verifyText method
  30  * will be invoked.
  31  * </p>
  32  *
  33  * @see VerifyEvent
  34  */
  35 @FunctionalInterface
  36 public interface VerifyListener extends SWTEventListener {
  37
  38 /**
  39  * Sent when the text is about to be modified.
  40  * <p>
  41  * A verify event occurs after the user has done something
  42  * to modify the text (typically typed a key), but before
  43  * the text is modified. The doit field in the verify event
  44  * indicates whether or not to modify the text.
  45  * </p>
  46  *
  47  * @param e an event containing information about the verify
  48  */
  49 void verifyText(VerifyEvent e);
  50 }