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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
|
package org.eclipse.swt.custom;
/*
* Licensed Materials - Property of IBM,
* (c) Copyright IBM Corp. 1998, 2001 All Rights Reserved
*/
import org.eclipse.swt.*;
import org.eclipse.swt.graphics.*;
import org.eclipse.swt.widgets.*;
/**
*
* A ControlEditor is a manager for a Control that appears above a composite and tracks with the
* moving and resizing of that composite. It can be used to display one control above
* another control. This could be used when editing a control that does not have editing
* capabilities by using a text editor or for launching a dialog by placing a button
* above a control.
*
* <p> Here is an example of using a ControlEditor:
*
* <code><pre>
* Canvas canvas = new Canvas(shell, SWT.BORDER);
* canvas.setBounds(10, 10, 300, 300);
* Color color = new Color(null, 255, 0, 0);
* canvas.setBackground(color);
* ControlEditor editor = new ControlEditor (canvas);
* // The editor will be a button in the bottom right corner of the canvas.
* // When selected, it will launch a Color dialog that will change the background
* // of the canvas.
* Button button = new Button(canvas, SWT.PUSH);
* button.setText("Select Color...");
* button.addSelectionListener (new SelectionAdapter() {
* public void widgetSelected(SelectionEvent e) {
* ColorDialog dialog = new ColorDialog(shell);
* dialog.open();
* RGB rgb = dialog.getRGB();
* if (rgb != null) {
* if (color != null) color.dispose();
* color = new Color(null, rgb);
* canvas.setBackground(color);
* }
*
* }
* });
*
* editor.horizontalAlignment = SWT.RIGHT;
* editor.verticalAlignment = SWT.BOTTOM;
* editor.grabHorizontal = false;
* editor.grabVertical = false;
* Point size = button.computeSize(SWT.DEFAULT, SWT.DEFAULT);
* editor.minimumWidth = size.x;
* editor.minimumHeight = size.y;
* editor.setEditor (button);
* </pre></code>
*/
public class ControlEditor {
/**
* Specifies how the editor should be aligned relative to the control. Allowed values
* are SWT.LEFT, SWT.RIGHT and SWT.CENTER. The default value is SWT.CENTER.
*/
public int horizontalAlignment = SWT.CENTER;
/**
* Specifies whether the editor should be sized to use the entire width of the control.
* True means resize the editor to the same width as the cell. False means do not adjust
* the width of the editor. The default value is false.
*/
public boolean grabHorizontal = false;
/**
* Specifies the minimum width the editor can have. This is used in association with
* a true value of grabHorizontal. If the cell becomes smaller than the minimumWidth, the
* editor will not made smaller than the minumum width value. The default value is 0.
*/
public int minimumWidth = 0;
/**
* Specifies how the editor should be aligned relative to the control. Allowed values
* are SWT.TOP, SWT.BOTTOM and SWT.CENTER. The default value is SWT.CENTER.
*/
public int verticalAlignment = SWT.CENTER;
/**
* Specifies whether the editor should be sized to use the entire height of the control.
* True means resize the editor to the same height as the underlying control. False means do not adjust
* the height of the editor. The default value is false.
*/
public boolean grabVertical = false;
/**
* Specifies the minimum height the editor can have. This is used in association with
* a true value of grabVertical. If the control becomes smaller than the minimumHeight, the
* editor will not made smaller than the minumum height value. The default value is 0.
*/
public int minimumHeight = 0;
Composite parent;
Control editor;
private boolean hadFocus;
private Listener internalListener;
/**
* Creates a ControlEditor for the specified Composite.
*
* @param parent the Composite above which this editor will be displayed
*
*/
public ControlEditor (Composite parent) {
this.parent = parent;
internalListener = new Listener() {
public void handleEvent(Event e) {
if (e.widget instanceof ScrollBar && e.type == SWT.Selection)
scroll (e);
else if (e.type == SWT.Resize)
resize ();
}
};
parent.addListener (SWT.Resize, internalListener);
ScrollBar hBar = parent.getHorizontalBar ();
if (hBar != null) hBar.addListener (SWT.Selection, internalListener);
ScrollBar vBar = parent.getVerticalBar ();
if (vBar != null) vBar.addListener (SWT.Selection, internalListener);
}
Rectangle computeBounds (){
Rectangle clientArea = parent.getClientArea();
Rectangle editorRect = new Rectangle(clientArea.x, clientArea.y, minimumWidth, minimumHeight);
if (grabHorizontal)
editorRect.width = Math.max(clientArea.width, minimumWidth);
if (grabVertical)
editorRect.height = Math.max(clientArea.height, minimumHeight);
switch (horizontalAlignment) {
case SWT.RIGHT:
editorRect.x += clientArea.width - editorRect.width;
break;
case SWT.LEFT:
// do nothing - clientArea.x is the right answer
break;
default:
// default is CENTER
editorRect.x += (clientArea.width - editorRect.width)/2;
}
switch (verticalAlignment) {
case SWT.BOTTOM:
editorRect.y += clientArea.height - editorRect.height;
break;
case SWT.TOP:
// do nothing - clientArea.y is the right answer
break;
default :
// default is CENTER
editorRect.y += (clientArea.height - editorRect.height)/2;
}
return editorRect;
}
/**
* Removes all associations between the Editor and the underlying composite. The
* composite and the editor Control are <b>not</b> disposed.
*/
public void dispose () {
if (!parent.isDisposed()) {
parent.removeListener (SWT.Resize, internalListener);
ScrollBar hBar = parent.getHorizontalBar ();
if (hBar != null) hBar.removeListener (SWT.Selection, internalListener);
ScrollBar vBar = parent.getVerticalBar ();
if (vBar != null) vBar.removeListener (SWT.Selection, internalListener);
}
parent = null;
editor = null;
hadFocus = false;
internalListener = null;
}
/**
* Returns the Control that is displayed above the composite being edited.
*
* @return the Control that is displayed above the composite being edited
*/
public Control getEditor () {
return editor;
}
void resize () {
if (editor == null || editor.isDisposed()) return;
if (editor.getVisible ()) {
hadFocus = editor.isFocusControl();
} // this doesn't work because
// resizing the column takes the focus away
// before we get here
editor.setBounds (computeBounds ());
if (hadFocus) editor.setFocus ();
}
void scroll (Event e) {
if (editor == null || editor.isDisposed()) return;
if (editor.getVisible ()) {
hadFocus = editor.isFocusControl();
}
boolean visible = e.detail != SWT.DRAG;
if (visible) {
editor.setBounds (computeBounds ());
}
editor.setVisible (visible);
if (visible && hadFocus) editor.setFocus ();
}
/**
* Specify the Control that is to be displayed.
*
* <p>Note: The Control provided as the editor <b>must</b> be created with its parent
* being the Composite specified in the ControlEditor constructor.
*
* @param editor the Control that is displayed above the composite being edited
*/
public void setEditor (Control editor) {
if (editor == null) {
// this is the case where the caller is setting the editor to be blank
// set all the values accordingly
this.editor = null;
return;
}
this.editor = editor;
editor.setVisible (false);
editor.setBounds (computeBounds ());
editor.setVisible (true);
}
}
|
