org.eclipse.ui.forms.widgets
Class OldForm

java.lang.Object
  org.eclipse.swt.widgets.Widget
      org.eclipse.swt.widgets.Control
          org.eclipse.swt.widgets.Scrollable
              org.eclipse.swt.widgets.Composite
                  org.eclipse.ui.forms.widgets.OldForm

All Implemented Interfaces:

Drawable

public class OldForm

extends Composite

Form is a custom control that renders a title and an optional background image above the body composite. It can be used alone when part of parents that are scrolled. If scrolling is required, use ScrolledForm instead because it has an instance of Form and adds scrolling capability.

Form can have a title if set. If not set, title area will not be left empty - form body will be resized to fill the entire form. In addition, an optional title image can be set and is rendered to the left of the title.

Since 3.2, the form supports status messages. These messages can have various severity (error, warning, info or none). Message tray can be minimized and later restored by the user, but can only be closed programmatically.

Form can have a background image behind the title text. The image can be painted as-is, or tiled as many times as needed to fill the title area.

Form has a custom layout manager that is wrap-enabled. If a form is placed in a composite whose layout manager implements ILayoutExtension, the body of the worm will participate in wrapping as long as its layout manager implements ILayoutExtension as well.

Children of the form should typically be created using FormToolkit to match the appearance and behaviour. When creating children, use the form body as a parent by calling 'getBody()' on the form instance. Example:

 FormToolkit toolkit = new FormToolkit(parent.getDisplay());
 Form form = toolkit.createForm(parent);
 formContent.setText("Sample form");
 formContent.getBody().setLayout(new GridLayout());
 toolkit.createButton(formContent.getBody(), "Checkbox", SWT.CHECK);
 

No layout manager has been set on the body. Clients are required to set the desired layout manager explicitly.

Although the class is not final, it should not be subclassed.

Since:

3.0

Field Summary

Fields inherited from class org.eclipse.swt.widgets.Control

handle

Constructor Summary

OldForm(Composite parent, int style)
Creates the form content control as a child of the provided parent.

Method Summary

Point	computeSize(int wHint, int hHint, boolean changed) Fully delegates the size computation to the internal layout manager.
Image	getBackgroundImage() Returns the optional background image of this form.
int	getBackgroundImageAlignment()
Composite	getBody() Returns the container that occupies the body of the form (the form area below the title).
Image	getImage() Returns the title image that will be rendered to the left of the title.
Color	getSeparatorColor() experimental - do not use yet TODO add javadoc
String	getText() Returns the title text that will be rendered at the top of the form.
IToolBarManager	getToolBarManager() Returns the tool bar manager that is used to manage tool items in the form's title area.
boolean	isBackgroundImageClipped()
boolean	isBackgroundImageTiled() TODO add javadoc
boolean	isBusy() Tests if the form is in the 'busy' state.
boolean	isSeparatorVisible() TODO add javadoc experimental - do not use yet
void	setBackground(Color bg) Sets the background color of the form.
void	setBackgroundImage(Image backgroundImage) Sets the optional background image to be rendered behind the title starting at the position 0,0.
void	setBackgroundImageAlignment(int backgroundImageAlignment)
void	setBackgroundImageClipped(boolean backgroundImageClipped)
void	setBackgroundImageTiled(boolean backgroundImageTiled) TODO add javadoc
void	setBusy(boolean busy) Sets the form's busy state.
void	setFont(Font font) Sets the font of the header text.
void	setForeground(Color fg) Sets the foreground color of the form.
void	setImage(Image image) Sets the image to be rendered to the left of the title.
void	setLayout(Layout layout) Prevents from changing the custom control layout.
void	setMenu(Menu menu) Passes the menu to the form body.
void	setMessage(String message) Sets the message for this form.
void	setMessage(String newMessage, int newType) Sets the message for this form with an indication of what type of message it is.
void	setSeparatorColor(Color separatorColor) experimental - do not use yet TODO add javadoc
void	setSeparatorVisible(boolean addSeparator) experimental - do not use yet TODO add javadoc
void	setText(String text) Sets the text to be rendered at the top of the form above the body as a title.
void	setTextBackground(Color[] gradientColors, int[] percents, boolean vertical)
void	updateToolBar() Updates the local tool bar manager if used.

Methods inherited from class org.eclipse.swt.widgets.Composite

changed, checkSubclass, getBackgroundMode, getChildren, getLayout, getLayoutDeferred, getTabList, isLayoutDeferred, layout, layout, layout, layout, setBackgroundMode, setFocus, setLayoutDeferred, setTabList

Methods inherited from class org.eclipse.swt.widgets.Scrollable

computeTrim, getClientArea, getHorizontalBar, getVerticalBar

Methods inherited from class org.eclipse.swt.widgets.Control

addControlListener, addFocusListener, addHelpListener, addKeyListener, addMouseListener, addMouseMoveListener, addMouseTrackListener, addPaintListener, addTraverseListener, computeSize, forceFocus, getAccessible, getBackground, getBorderWidth, getBounds, getEnabled, getFont, getForeground, getLayoutData, getLocation, getMenu, getMonitor, getParent, getShell, getSize, getToolTipText, getVisible, internal_dispose_GC, internal_new_GC, isEnabled, isFocusControl, isReparentable, isVisible, moveAbove, moveBelow, pack, pack, redraw, redraw, removeControlListener, removeFocusListener, removeHelpListener, removeKeyListener, removeMouseListener, removeMouseMoveListener, removeMouseTrackListener, removePaintListener, removeTraverseListener, setBounds, setBounds, setCapture, setCursor, setEnabled, setLayoutData, setLocation, setLocation, setParent, setRedraw, setSize, setSize, setToolTipText, setVisible, toControl, toControl, toDisplay, toDisplay, traverse, update

Methods inherited from class org.eclipse.swt.widgets.Widget

addDisposeListener, addListener, checkWidget, dispose, getData, getData, getDisplay, getStyle, isDisposed, isListening, notifyListeners, removeDisposeListener, removeListener, removeListener, setData, setData, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

OldForm

public OldForm(Composite parent,
               int style)

Creates the form content control as a child of the provided parent.

Parameters:

parent - the parent widget

Method Detail

setMenu

public void setMenu(Menu menu)

Passes the menu to the form body.

Overrides:

setMenu in class Control

Parameters:

menu -

computeSize

public final Point computeSize(int wHint,
                               int hHint,
                               boolean changed)

Fully delegates the size computation to the internal layout manager.

Overrides:

computeSize in class Composite

setLayout

public final void setLayout(Layout layout)

Prevents from changing the custom control layout.

Overrides:

setLayout in class Composite

Parameters:

layout - the receiver's new layout or null

getText

public String getText()

Returns the title text that will be rendered at the top of the form.

Returns:

the title text

getImage

public Image getImage()

Returns the title image that will be rendered to the left of the title.

Returns:

the title image

Since:

3.2

setForeground

public void setForeground(Color fg)

Sets the foreground color of the form. This color will also be used for the body.

Overrides:

setForeground in class Control

Parameters:

fg - the new color (or null)

setBackground

public void setBackground(Color bg)

Sets the background color of the form. This color will also be used for the body.

Overrides:

setBackground in class Control

Parameters:

bg - the new color (or null)

setFont

public void setFont(Font font)

Sets the font of the header text.

Overrides:

setFont in class Control

Parameters:

font - the new font (or null)

setText

public void setText(String text)

Sets the text to be rendered at the top of the form above the body as a title.

Parameters:

text - the title text

setImage

public void setImage(Image image)

Sets the image to be rendered to the left of the title.

Parameters:

image - the title image or null to show no image.

Since:

3.2

setTextBackground

public void setTextBackground(Color[] gradientColors,
                              int[] percents,
                              boolean vertical)

getBackgroundImage

public Image getBackgroundImage()

Returns the optional background image of this form. The image is rendered starting at the position 0,0 and is painted behind the title.

Overrides:

getBackgroundImage in class Control

Returns:

Returns the background image.

setBackgroundImage

public void setBackgroundImage(Image backgroundImage)

Sets the optional background image to be rendered behind the title starting at the position 0,0.

Overrides:

setBackgroundImage in class Control

Parameters:

backgroundImage - The backgroundImage to set.

getToolBarManager

public IToolBarManager getToolBarManager()

Returns the tool bar manager that is used to manage tool items in the form's title area.

Returns:

form tool bar manager

updateToolBar

public void updateToolBar()

Updates the local tool bar manager if used. Does nothing if local tool bar manager has not been created yet.

getBody

public Composite getBody()

Returns the container that occupies the body of the form (the form area below the title). Use this container as a parent for the controls that should be in the form. No layout manager has been set on the form body.

Returns:

Returns the body of the form.

isBackgroundImageTiled

public boolean isBackgroundImageTiled()

TODO add javadoc

Returns:

Returns the backgroundImageTiled.

setBackgroundImageTiled

public void setBackgroundImageTiled(boolean backgroundImageTiled)

TODO add javadoc

Parameters:

backgroundImageTiled - The backgroundImageTiled to set.

getBackgroundImageAlignment

public int getBackgroundImageAlignment()

Returns:

Returns the backgroundImageAlignment. TODO add javadoc

Since:

3.1

setBackgroundImageAlignment

public void setBackgroundImageAlignment(int backgroundImageAlignment)

Parameters:

backgroundImageAlignment - The backgroundImageAlignment to set. TODO add javadoc

Since:

3.1

isBackgroundImageClipped

public boolean isBackgroundImageClipped()

Returns:

Returns the backgroundImageClipped.

Since:

3.1

setBackgroundImageClipped

public void setBackgroundImageClipped(boolean backgroundImageClipped)

Parameters:

backgroundImageClipped - The backgroundImageClipped to set.

Since:

3.1

isSeparatorVisible

public boolean isSeparatorVisible()

TODO add javadoc experimental - do not use yet

Returns:

true if the receiver is a visible separator, false otherwise

setSeparatorVisible

public void setSeparatorVisible(boolean addSeparator)

experimental - do not use yet TODO add javadoc

getSeparatorColor

public Color getSeparatorColor()

experimental - do not use yet TODO add javadoc

setSeparatorColor

public void setSeparatorColor(Color separatorColor)

experimental - do not use yet TODO add javadoc

setMessage

public void setMessage(String message)

Sets the message for this form.

Parameters:

message - the message, or null to clear the message

Since:

3.2

setMessage

public void setMessage(String newMessage,
                       int newType)

Sets the message for this form with an indication of what type of message it is.

The valid message types are one of NONE, INFORMATION,WARNING, or ERROR.

Parameters:

newMessage - the message, or null to clear the message

newType - the message type

Since:

3.2

isBusy

public boolean isBusy()

Tests if the form is in the 'busy' state.

Returns:

true if busy, false otherwise.

setBusy

public void setBusy(boolean busy)

Sets the form's busy state. Busy form will display 'busy' animation in the area of the title image.

Parameters:

busy - the form's busy state