Mercurial > projects > dwt-win
diff dwt/events/SelectionListener.d @ 0:5406a8f6526d
Add initial files
author | John Reimer <terminal.node@gmail.com |
---|---|
date | Sun, 20 Jan 2008 21:50:55 -0800 |
parents | |
children | bef1ed4ebc50 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/dwt/events/SelectionListener.d Sun Jan 20 21:50:55 2008 -0800 @@ -0,0 +1,65 @@ +/******************************************************************************* + * 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 + * Port to the D programming language: + * Frank Benoit <benoit@tionex.de> + *******************************************************************************/ +module dwt.events.SelectionListener; + + +public import dwt.internal.DWTEventListener; +public import dwt.events.SelectionEvent; + +/** + * 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 extends + * 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 : 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); +}