Decorators

Intoduction

Decorators are graphical components to visualize data or images. Decorators are used by Greip widgets (e.g. Picture, Tile). You can also use all decorators for your own widgets.

IDecorator

IDecorator is the interface that is used by controls to paint decorators. All decorators must implement this interface. The base implementation is AbstractDecorator.

Methods

• void doPaint(GC gc, int x, int y), paints the decorator to the specified GC.
• Point getSize(), returns the size of the decorator

AbstractDecorator

AbstractDecorator is the base implementation of the IDecorator interface. All decorator implementations are subclasses of this abstract class.

Constructors

• AbstractDecorator(Control parent)
  • parent the parent control to paint the decorator

Methods

• void dispose(), is called when the parent control is disposed
• Display getDisplay(), returns the display of the parent control
• Control getParent(), returns the parent control
• void redraw(), force decorator paintig by redrawing the parent control

ImageDecorator

Paint an image to the parent control. Supports all image formats supported by ImageLoaderplus animated GIFs.

Methods

• void loadImage(InputStream stream), loads an image from input stream
• void loadImage(String filename), loads an image from the file
• void setImage(Image image), sets an image
• void scaleTo(final Point scaleTo), scales the image to the defined size

PercentageDecorator

Displays an percentage value as animated graphic.

Methods

• void setCircleBackground(Color color), defines the circle background color
• void setCircleForeground(Color color), defines the circle foreground color
• void setCircleType(CircleType type), defines the type of the circle
• void setFont(final Font font), sets the text font
• void setForeground(final Color color), sets the foreground (text) color
• void setInnerDiameter(int innerDiameter), sets the inner diameter in pixels
• void setMaxValue(int maxValue), sets the maximum number (equal to 100 percent)
• void setNumberFormat(NumberFormat format), sets the format for number formatting
• void setOuterDiameter(int outerDiameter), sets the outer diameter in pixels
• void setShowAnimation(boolean animate), enables or disables the animation
• void setTreshholdColors(Map<Integer, Color> treshholdMap), defines color treshholds
• void setUnit(String text), sets the unit text
• void setUnitAlignment(int alignment), sets the alignment of the unit
• void setUnitFont(Font font), sets the font to paint the unit text
• void setValue(int value), sets the displayed value

You can also use all related getters.

NumberDecorator

Displays an absolute number value as animated graphic.

Methods

• void setCircleColor(Color color), defines the circle color
• void setFont(final Font font), sets the text font
• void setForeground(final Color color), sets the foreground (text) color
• void setInnerDiameter(int innerDiameter), sets the inner diameter in pixels
• void setNumberFormat(NumberFormat format), sets the format for number formatting
• void setOuterDiameter(int outerDiameter), sets the outer diameter in pixels
• void setShowAnimation(boolean animate), enables or disables the animation
• void setTreshholdColors(Map<Integer, Color> treshholdMap), defines color treshholds
• void setUnit(String text), sets the unit text
• void setUnitAlignment(int alignment), sets the alignment of the unit
• void setUnitFont(Font font), sets the font to paint the unit text
• void setValue(int value), sets the displayed value

You can also use all related getters.

Examples

• Sample1 shows the display of an animated GIF using the ImageDecorator.
• Sample2 shows the use of an ShapeDecorator. The graphical shape is configured as circle.
• Sample3 shows the use of an ShapeDecorator to display a formatted date.
• Sample4 shows the use of a PercentageDecorator.