Mercurial > projects > dwt-win

comparison dwt/events/SelectionListener.d @ 0:5406a8f6526d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add initial files
author John Reimer <terminal.node@gmail.com
date Sun, 20 Jan 2008 21:50:55 -0800
parents
children bef1ed4ebc50
comparison
equal deleted inserted replaced
-1:000000000000 0:5406a8f6526d
1 /*******************************************************************************
2 * Copyright (c) 2000, 2005 IBM Corporation and others.
3 * All rights reserved. This program and the accompanying materials
4 * are made available under the terms of the Eclipse Public License v1.0
5 * which accompanies this distribution, and is available at
6 * http://www.eclipse.org/legal/epl-v10.html
7 *
8 * Contributors:
9 * IBM Corporation - initial API and implementation
10 * Port to the D programming language:
11 * Frank Benoit <benoit@tionex.de>
12 *******************************************************************************/
13 module dwt.events.SelectionListener;
14
15
16 public import dwt.internal.DWTEventListener;
17 public import dwt.events.SelectionEvent;
18
19 /**
20 * Classes which implement this interface provide methods
21 * that deal with the events that are generated when selection
22 * occurs in a control.
23 * <p>
24 * After creating an instance of a class that extends
25 * this interface it can be added to a control using the
26 * <code>addSelectionListener</code> method and removed using
27 * the <code>removeSelectionListener</code> method. When
28 * selection occurs in a control the appropriate method
29 * will be invoked.
30 * </p>
31 *
32 * @see SelectionAdapter
33 * @see SelectionEvent
34 */
35 public interface SelectionListener : DWTEventListener {
36
37 /**
38 * Sent when selection occurs in the control.
39 * <p>
40 * For example, selection occurs in a List when the user selects
41 * an item or items with the keyboard or mouse. On some platforms,
42 * the event occurs when a mouse button or key is pressed. On others,
43 * it happens when the mouse or key is released. The exact key or
44 * mouse gesture that causes this event is platform specific.
45 * </p>
46 *
47 * @param e an event containing information about the selection
48 */
49 public void widgetSelected(SelectionEvent e);
50
51 /**
52 * Sent when default selection occurs in the control.
53 * <p>
54 * For example, on some platforms default selection occurs in a List
55 * when the user double-clicks an item or types return in a Text.
56 * On some platforms, the event occurs when a mouse button or key is
57 * pressed. On others, it happens when the mouse or key is released.
58 * The exact key or mouse gesture that causes this event is platform
59 * specific.
60 * </p>
61 *
62 * @param e an event containing information about the default selection
63 */
64 public void widgetDefaultSelected(SelectionEvent e);
65 }