/*
 * Copyright 2008 Google Inc.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.google.gwt.user.client.ui;

import java.util.EventListener;

/**
 * Event listener interface for keyboard events.
 * 
 * @deprecated use {@link com.google.gwt.event.dom.client.KeyDownHandler},
 *             {@link com.google.gwt.event.dom.client.KeyUpHandler} and/or
 *             {@link com.google.gwt.event.dom.client.KeyPressHandler} instead
 */
@Deprecated
public interface KeyboardListener extends EventListener {
  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_ALT}
   *             instead
   */
  @Deprecated
  int KEY_ALT = 18;

  /**
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyCodes#KEY_BACKSPACE}
   *             instead
   */
  @Deprecated
  int KEY_BACKSPACE = 8;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_CTRL}
   *             instead
   */
  @Deprecated
  int KEY_CTRL = 17;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_DELETE}
   *             instead
   */
  @Deprecated
  int KEY_DELETE = 46;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_DOWN}
   *             instead
   */
  @Deprecated
  int KEY_DOWN = 40;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_END}
   *             instead
   */
  @Deprecated
  int KEY_END = 35;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_ENTER}
   *             instead
   */
  @Deprecated
  int KEY_ENTER = 13;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_ESCAPE}
   *             instead
   */
  @Deprecated
  int KEY_ESCAPE = 27;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_HOME}
   *             instead
   */
  @Deprecated
  int KEY_HOME = 36;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_LEFT}
   *             instead
   */
  @Deprecated
  int KEY_LEFT = 37;

  /**
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyCodes#KEY_PAGEDOWN}
   *             instead
   */
  @Deprecated
  int KEY_PAGEDOWN = 34;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_PAGEUP}
   *             instead
   */
  @Deprecated
  int KEY_PAGEUP = 33;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_RIGHT}
   *             instead
   */
  @Deprecated
  int KEY_RIGHT = 39;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_SHIFT}
   *             instead
   */
  @Deprecated
  int KEY_SHIFT = 16;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_TAB}
   *             instead
   */
  @Deprecated
  int KEY_TAB = 9;

  /**
   * @deprecated use {@link com.google.gwt.event.dom.client.KeyCodes#KEY_UP}
   *             instead
   */
  @Deprecated
  int KEY_UP = 38;

  /**
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyCodeEvent#isAltKeyDown()}
   *             instead
   */
  @Deprecated
  int MODIFIER_ALT = 4;

  /**
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyCodeEvent#isControlKeyDown()}
   *             instead
   */
  @Deprecated
  int MODIFIER_CTRL = 2;

  /**
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyCodeEvent#isMetaKeyDown()}
   *             instead
   */
  @Deprecated
  int MODIFIER_META = 8;

  /**
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyCodeEvent#isShiftKeyDown()}
   *             instead
   */
  @Deprecated
  int MODIFIER_SHIFT = 1;

  /**
   * Fired when the user depresses a physical key.
   * 
   * @param sender the widget that was focused when the event occurred.
   * @param keyCode the physical key that was depressed. Constants for this
   *          value are defined in this interface with the KEY prefix.
   * @param modifiers the modifier keys pressed at when the event occurred. This
   *          value is a combination of the bits defined by
   *          {@link KeyboardListener#MODIFIER_SHIFT},
   *          {@link KeyboardListener#MODIFIER_CTRL}, and
   *          {@link KeyboardListener#MODIFIER_ALT}
   * 
   * 
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyDownHandler#onKeyDown(com.google.gwt.event.dom.client.KeyDownEvent)}
   *             instead
   */
  @Deprecated
  void onKeyDown(Widget sender, char keyCode, int modifiers);

  /**
   * Fired when a keyboard action generates a character. This occurs after
   * onKeyDown and onKeyUp are fired for the physical key that was pressed.
   * 
   * <p>
   * It should be noted that many browsers do not generate keypress events for
   * non-printing keyCode values, such as {@link KeyboardListener#KEY_ENTER} or
   * arrow keys. These keyCodes can be reliably captured either with
   * {@link KeyboardListener#onKeyDown(Widget, char, int)} or
   * {@link KeyboardListener#onKeyUp(Widget, char, int)}.
   * </p>
   * 
   * @param sender the widget that was focused when the event occurred.
   * @param keyCode the Unicode character that was generated by the keyboard
   *          action.
   * @param modifiers the modifier keys pressed at when the event occurred. This
   *          value is a combination of the bits defined by
   *          {@link KeyboardListener#MODIFIER_SHIFT},
   *          {@link KeyboardListener#MODIFIER_CTRL}, and
   *          {@link KeyboardListener#MODIFIER_ALT}
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyPressHandler#onKeyPress(com.google.gwt.event.dom.client.KeyPressEvent)}
   *             instead
   */
  @Deprecated
  void onKeyPress(Widget sender, char keyCode, int modifiers);

  /**
   * Fired when the user releases a physical key.
   * 
   * @param sender the widget that was focused when the event occurred.
   * @param keyCode the physical key that was released. Constants for this value
   *          are defined in this interface with the KEY prefix.
   * @param modifiers the modifier keys pressed at when the event occurred. This
   *          value is a combination of the bits defined by
   *          {@link KeyboardListener#MODIFIER_SHIFT},
   *          {@link KeyboardListener#MODIFIER_CTRL}, and
   *          {@link KeyboardListener#MODIFIER_ALT}
   * @deprecated use
   *             {@link com.google.gwt.event.dom.client.KeyUpHandler#onKeyUp(com.google.gwt.event.dom.client.KeyUpEvent)}
   *             instead
   */
  @Deprecated
  void onKeyUp(Widget sender, char keyCode, int modifiers);
}