org.eclipse.jface.text
Class DefaultInformationControl

java.lang.Object
  |
  +--org.eclipse.jface.text.DefaultInformationControl

All Implemented Interfaces:

IInformationControl, IInformationControlExtension

public class DefaultInformationControl

extends Object

implements IInformationControl, IInformationControlExtension

Text based implementation of IInformationControl. Displays information in a styled text widget. Before displaying, the information set to this information control is processed by an IInformationPresenter.

Since:

2.0

Nested Class Summary

static interface

DefaultInformationControl.IInformationPresenter An information presenter determines the style presentation of information displayed in the default information control.

Constructor Summary

DefaultInformationControl(Shell parent)
Creates a default information control with the given shell as parent.

DefaultInformationControl(Shell parent, DefaultInformationControl.IInformationPresenter presenter)
Creates a default information control with the given shell as parent.

DefaultInformationControl(Shell parent, int style, DefaultInformationControl.IInformationPresenter presenter)
Creates a default information control with the given shell as parent.

Method Summary

void	addDisposeListener(DisposeListener listener) Adds the given listener to the list of dispose listeners.
void	addFocusListener(FocusListener listener) Adds the given listener to the list of focus listeners.
Point	computeSizeHint() Computes and returns a proposal for the size of this information control depending on the information to present.
void	dispose() Disposes this information control.
boolean	hasContents() Returns whether this information control has contents to be displayed.
boolean	isFocusControl() Returns whether this information control has the focus.
void	removeDisposeListener(DisposeListener listener) Removes the given listeners from the list of dispose listeners.
void	removeFocusListener(FocusListener listener) Removes the given listeners from the list of focus listeners.
void	setBackgroundColor(Color background) Sets the background color of this information control.
void	setFocus() Sets the keyboard focus to this information control.
void	setForegroundColor(Color foreground) Sets the foreground color of this information control.
void	setInformation(String content) Sets the information to be presented in this information control.
void	setLocation(Point location) Sets the location of this information control.
void	setSize(int width, int height) Sets the size of this information control.
void	setSizeConstraints(int maxWidth, int maxHeight) Sets the information control's size constraints.
void	setVisible(boolean visible) Controls the visibility of this information control.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultInformationControl

public DefaultInformationControl(Shell parent,
                                 int style,
                                 DefaultInformationControl.IInformationPresenter presenter)

Creates a default information control with the given shell as parent. The given information presenter is used to process the information to be displayed. The given styles are applied to the created styled text widget.

Parameters:

parent - the parent shell

presenter - the presenter to be used

style - the additional styles for the styled text widget

DefaultInformationControl

public DefaultInformationControl(Shell parent)

Creates a default information control with the given shell as parent. No information presenter is used to process the information to be displayed. No additional styles are applied to the styled text widget.

Parameters:

parent - the parent shell

DefaultInformationControl

public DefaultInformationControl(Shell parent,
                                 DefaultInformationControl.IInformationPresenter presenter)

Creates a default information control with the given shell as parent. The given information presenter is used to process the information to be displayed. No additional styles are applied to the styled text widget.

Parameters:

parent - the parent shell

presenter - the presenter to be used

Method Detail

setInformation

public void setInformation(String content)

Description copied from interface: IInformationControl

Sets the information to be presented in this information control.

Specified by:

setInformation in interface IInformationControl

Parameters:

content - the information to be presented

setVisible

public void setVisible(boolean visible)

Description copied from interface: IInformationControl

Controls the visibility of this information control.

Specified by:

setVisible in interface IInformationControl

Parameters:

visible - true if the control should be visible

dispose

public void dispose()

Description copied from interface: IInformationControl

Disposes this information control.

Specified by:

dispose in interface IInformationControl

setSize

public void setSize(int width,
                    int height)

Description copied from interface: IInformationControl

Sets the size of this information control.

Specified by:

setSize in interface IInformationControl

Parameters:

width - the width of the control

height - the height of the control

setLocation

public void setLocation(Point location)

Description copied from interface: IInformationControl

Sets the location of this information control.

Specified by:

setLocation in interface IInformationControl

Parameters:

location - the location

setSizeConstraints

public void setSizeConstraints(int maxWidth,
                               int maxHeight)

Description copied from interface: IInformationControl

Sets the information control's size constraints. A constraint value of -1 indicates no constraint. This method is called before computeSizeHint is called.

Specified by:

setSizeConstraints in interface IInformationControl

Parameters:

maxWidth - the maximal width of the control to present the information, or -1 for not constraint

maxHeight - the maximal height of the control to present the information, or -1 for not constraint

computeSizeHint

public Point computeSizeHint()

Description copied from interface: IInformationControl

Computes and returns a proposal for the size of this information control depending on the information to present. The method tries to honor known size constraints but might returns a size that exceeds them.

Specified by:

computeSizeHint in interface IInformationControl

Returns:

the computed size hint

addDisposeListener

public void addDisposeListener(DisposeListener listener)

Description copied from interface: IInformationControl

Adds the given listener to the list of dispose listeners. If the listener is already registered it is not registered again.

Specified by:

addDisposeListener in interface IInformationControl

Parameters:

listener - the listener to be added

removeDisposeListener

public void removeDisposeListener(DisposeListener listener)

Description copied from interface: IInformationControl

Removes the given listeners from the list of dispose listeners. If the listener is not registered this call has no affect.

Specified by:

removeDisposeListener in interface IInformationControl

Parameters:

listener - the listener to be removed

setForegroundColor

public void setForegroundColor(Color foreground)

Description copied from interface: IInformationControl

Sets the foreground color of this information control.

Specified by:

setForegroundColor in interface IInformationControl

Parameters:

foreground - the foreground color of this information control

setBackgroundColor

public void setBackgroundColor(Color background)

Description copied from interface: IInformationControl

Sets the background color of this information control.

Specified by:

setBackgroundColor in interface IInformationControl

Parameters:

background - the background color of this information control

isFocusControl

public boolean isFocusControl()

Description copied from interface: IInformationControl

Returns whether this information control has the focus.

Specified by:

isFocusControl in interface IInformationControl

Returns:

true when the information control has the focus otherwise false

setFocus

public void setFocus()

Description copied from interface: IInformationControl

Sets the keyboard focus to this information control.

Specified by:

setFocus in interface IInformationControl

addFocusListener

public void addFocusListener(FocusListener listener)

Description copied from interface: IInformationControl

Adds the given listener to the list of focus listeners. If the listener is already registered it is not registered again.

Specified by:

addFocusListener in interface IInformationControl

Parameters:

listener - the listener to be added

removeFocusListener

public void removeFocusListener(FocusListener listener)

Description copied from interface: IInformationControl

Removes the given listeners from the list of focus listeners. If the listener is not registered this call has no affect.

Specified by:

removeFocusListener in interface IInformationControl

Parameters:

listener - the listener to be removed

hasContents

public boolean hasContents()

Description copied from interface: IInformationControlExtension

Returns whether this information control has contents to be displayed.

Specified by:

hasContents in interface IInformationControlExtension

Returns:

true if there is contents to be displayed.