1 /* 2 * Copyright 2006 Google Inc. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); you may not 5 * use this file except in compliance with the License. You may obtain a copy of 6 * the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT 12 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the 13 * License for the specific language governing permissions and limitations under 14 * the License. 15 */ 16 package com.google.gwt.user.client; 17 18 /** 19 * A listener interface for previewing browser events. 20 * 21 * @see com.google.gwt.user.client.DOM#addEventPreview(EventPreview) 22 */ 23 public interface EventPreview { 24 25 /** 26 * Called when a browser event occurs and this event preview is on top of the 27 * preview stack. 28 * 29 * @param event the browser event 30 * @return <code>false</code> to cancel the event 31 * @see DOM#addEventPreview(EventPreview) 32 */ 33 boolean onEventPreview(Event event); 34 } 35