Here is an example of using a ControlEditor:
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);
| Modifier and Type | Field and Description |
|---|---|
| private Listener | |
| pack-priv Control | |
| private static final int[] | |
| public boolean | grabHorizontal
Specifies whether the editor should be sized to use the entire width of the control. |
| public boolean | grabVertical
Specifies whether the editor should be sized to use the entire height of the control. |
| private boolean | |
| public int | horizontalAlignment
Specifies how the editor should be aligned relative to the control. |
| public int | minimumHeight
Specifies the minimum height the editor can have. |
| public int | minimumWidth
Specifies the minimum width the editor can have. |
| pack-priv Composite | |
| private Listener | |
| public int | verticalAlignment
Specifies how the editor should be aligned relative to the control. |
| Access | Constructor and Description |
|---|---|
| public | ControlEditor(Composite
the Composite above which this editor will be displayed parent)Creates a ControlEditor for the specified Composite. |
| Modifier and Type | Method and Description |
|---|---|
| pack-priv Rectangle | |
| public void | |
| public Control | Returns: the Control that is displayed above the composite being editedReturns the Control that is displayed above the composite being edited. |
| public void | |
| pack-priv void | |
| public void |
| controlListener | back to summary |
|---|---|
| private Listener controlListener | |
| editor | back to summary |
|---|---|
| pack-priv Control editor | |
| EVENTS | back to summary |
|---|---|
| private static final int[] EVENTS | |
| grabHorizontal | back to summary |
|---|---|
| public boolean grabHorizontal 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. | |
| grabVertical | back to summary |
|---|---|
| public boolean grabVertical 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. | |
| hadFocus | back to summary |
|---|---|
| private boolean hadFocus | |
| horizontalAlignment | back to summary |
|---|---|
| public int horizontalAlignment 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. | |
| minimumHeight | back to summary |
|---|---|
| public int minimumHeight 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 minimum height value. The default value is 0. | |
| minimumWidth | back to summary |
|---|---|
| public int minimumWidth 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 minimum width value. The default value is 0. | |
| parent | back to summary |
|---|---|
| pack-priv Composite parent | |
| scrollbarListener | back to summary |
|---|---|
| private Listener scrollbarListener | |
| verticalAlignment | back to summary |
|---|---|
| public int verticalAlignment 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. | |
| ControlEditor | back to summary |
|---|---|
| public ControlEditor(Composite parent) Creates a ControlEditor for the specified Composite.
| |
| computeBounds | back to summary |
|---|---|
| pack-priv Rectangle computeBounds() | |
| dispose | back to summary |
|---|---|
| public void dispose() Removes all associations between the Editor and the underlying composite. The composite and the editor Control are not disposed. | |
| getEditor | back to summary |
|---|---|
| public Control getEditor() Returns the Control that is displayed above the composite being edited.
| |
| layout | back to summary |
|---|---|
| public void layout() Lays out the control within the underlying composite. This method should be called after changing one or more fields to force the Editor to resize.
| |
| scroll | back to summary |
|---|---|
| pack-priv void scroll(Event e) | |
| setEditor | back to summary |
|---|---|
| public void setEditor(Control editor) Specify the Control that is to be displayed. Note The Control provided as the editor must be created with its parent being the Composite specified in the ControlEditor constructor.
| |