Mercurial > projects > dwt-mac
view dwt/events/SelectionListener.d @ 0:380af2bdd8e5
Upload of whole dwt tree
author | Jacob Carlborg <doob@me.com> <jacob.carlborg@gmail.com> |
---|---|
date | Sat, 09 Aug 2008 17:00:02 +0200 |
parents | |
children | 649b8e223d5a |
line wrap: on
line source
/******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ module dwt.events.SelectionListener; import dwt.dwthelper.utils; import dwt.internal.DWTEventListener; /** * Classes which implement this interface provide methods * that deal with the events that are generated when selection * occurs in a control. * <p> * After creating an instance of a class that implements * this interface it can be added to a control using the * <code>addSelectionListener</code> method and removed using * the <code>removeSelectionListener</code> method. When * selection occurs in a control the appropriate method * will be invoked. * </p> * * @see SelectionAdapter * @see SelectionEvent */ public interface SelectionListener extends DWTEventListener { /** * Sent when selection occurs in the control. * <p> * For example, selection occurs in a List when the user selects * an item or items with the keyboard or mouse. On some platforms, * the event occurs when a mouse button or key is pressed. On others, * it happens when the mouse or key is released. The exact key or * mouse gesture that causes this event is platform specific. * </p> * * @param e an event containing information about the selection */ public void widgetSelected(SelectionEvent e); /** * Sent when default selection occurs in the control. * <p> * For example, on some platforms default selection occurs in a List * when the user double-clicks an item or types return in a Text. * On some platforms, the event occurs when a mouse button or key is * pressed. On others, it happens when the mouse or key is released. * The exact key or mouse gesture that causes this event is platform * specific. * </p> * * @param e an event containing information about the default selection */ public void widgetDefaultSelected(SelectionEvent e); }