blob: d0034594cd39db671c37735b224a07c352b3edb1 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/*******************************************************************************
* Copyright (c) 2000, 2011 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
*******************************************************************************/
package org.eclipse.swt.events;
import org.eclipse.swt.widgets.*;
/**
* Instances of this class are sent as a result of
* widgets being selected.
* <p>
* Note: The fields that are filled in depend on the widget.
* </p>
*
* @see SelectionListener
* @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class SelectionEvent extends TypedEvent {
/**
* The item that was selected.
*/
public Widget item;
/**
* Extra detail information about the selection, depending on the widget.
*
* <p><b>Sash</b><ul>
* <li>{@link org.eclipse.swt.SWT#DRAG}</li>
* </ul></p><p><b>ScrollBar and Slider</b><ul>
* <li>{@link org.eclipse.swt.SWT#DRAG}</li>
* <li>{@link org.eclipse.swt.SWT#HOME}</li>
* <li>{@link org.eclipse.swt.SWT#END}</li>
* <li>{@link org.eclipse.swt.SWT#ARROW_DOWN}</li>
* <li>{@link org.eclipse.swt.SWT#ARROW_UP}</li>
* <li>{@link org.eclipse.swt.SWT#PAGE_DOWN}</li>
* <li>{@link org.eclipse.swt.SWT#PAGE_UP}</li>
* </ul></p><p><b>Table and Tree</b><ul>
* <li>{@link org.eclipse.swt.SWT#CHECK}</li>
* </ul></p><p><b>Text</b><ul>
* <li>{@link org.eclipse.swt.SWT#CANCEL}</li>
* </ul></p><p><b>CoolItem and ToolItem</b><ul>
* <li>{@link org.eclipse.swt.SWT#ARROW}</li>
* </ul></p>
*/
public int detail;
/**
* The x location of the selected area.
*/
public int x;
/**
* The y location of selected area.
*/
public int y;
/**
* The width of selected area.
*/
public int width;
/**
* The height of selected area.
*/
public int height;
/**
* The state of the keyboard modifier keys at the time
* the event was generated.
*/
public int stateMask;
/**
* The text of the hyperlink that was selected.
* This will be either the text of the hyperlink or the value of its HREF,
* if one was specified.
*
* @see org.eclipse.swt.widgets.Link#setText(String)
* @since 3.1
*/
public String text;
/**
* A flag indicating whether the operation should be allowed.
* Setting this field to <code>false</code> will cancel the
* operation, depending on the widget.
*/
public boolean doit;
static final long serialVersionUID = 3976735856884987953L;
/**
* Constructs a new instance of this class based on the
* information in the given untyped event.
*
* @param e the untyped event containing the information
*/
public SelectionEvent(Event e) {
super(e);
this.item = e.item;
this.x = e.x;
this.y = e.y;
this.width = e.width;
this.height = e.height;
this.detail = e.detail;
this.stateMask = e.stateMask;
this.text = e.text;
this.doit = e.doit;
}
/**
* Returns a string containing a concise, human-readable
* description of the receiver.
*
* @return a string representation of the event
*/
public String toString() {
String string = super.toString ();
return string.substring (0, string.length() - 1) // remove trailing '}'
+ " item=" + item
+ " detail=" + detail
+ " x=" + x
+ " y=" + y
+ " width=" + width
+ " height=" + height
+ " stateMask=0x" + Integer.toHexString(stateMask)
+ " text=" + text
+ " doit=" + doit
+ "}";
}
}
|
