com.diffplug.common.swt

Interface ControlWrapper

All Known Implementing Classes:

CoatMux, ControlWrapper.AroundControl, ControlWrapper.AroundWrapper

public interface ControlWrapper

Wraps an SWT Control to encapsulate its API.

The traditional way to make a custom class is this: class CustomControl extends Composite

This has three main problems:

1. Users can add random widgets to your "Control" because it exposes the Composite interface.
2. Users can set the layout to your "Control" because it exposes the Composite interface.
3. Users can add random listeners to your "Control", and overridding Widget.addListener to intercept them is a very dangerous plan.

ControlWrapper fixes this by providing an low-overhead skeleton which encapsulates the SWT Control that you're using as the base of your custom control, which allows you to only expose the APIs that are appropriate.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ControlWrapper.AroundControl<T extends Control> Default implementation of a ControlWrapper which wraps a Control.
static class	ControlWrapper.AroundWrapper<T extends ControlWrapper> Default implementation of a ControlWrapper which wraps some other form of `ControlWrapper` with a new interface.

Method Summary

Modifier and Type	Method and Description
default Object	getLayoutData() Returns the LayoutData for this control.
default Composite	getParent() Returns the parent of this Control.
Control	getRootControl() Returns the wrapped Control (only appropriate for limited purposes!).
default Shell	getShell() Returns the parent Shell of this Control.
default void	setLayoutData(Object layoutData) Sets the LayoutData for this control.

Method Detail

setLayoutData

default void setLayoutData(Object layoutData)

Sets the LayoutData for this control.

getLayoutData

default Object getLayoutData()

Returns the LayoutData for this control.

getParent

default Composite getParent()

Returns the parent of this Control.

getShell

default Shell getShell()

Returns the parent Shell of this Control.

getRootControl

Control getRootControl()

Returns the wrapped Control (only appropriate for limited purposes!).

The implementor of this ControlWrapper is free to change the wrapped Control as she sees fit, and she doesn't have to tell you about it! You shouldn't rely on this control being anything in particular.

You can rely on this Control for:

1. Managing lifetimes: `wrapped.getRootControl().addListener(SWT.Dispose, ...`

But that's all. If you use it for something else, it's on you when it breaks.