ToolTip Class

ToolTip Class

This Package | All Packages

Component
  |
  +--ToolTip
public final class ToolTip
extends Component
implements IExtenderProvider

Provides tooltips for other controls.

Constructors
Name Description
ToolTip() Creates a ToolTip object.
getToolTip(Control control) Retrieves the current tooltip for the specified control.
setToolTip(Control control, String caption) Sets the tooltip for the specified control.

Methods
Name Description
addRegion(ToolTipRegion region) Adds a tooltip region to the control.
getAutomaticDelay() Retrieves the current value of the AutomaticDelay property.
getAutoPopDelay() Retrieves the current value of the AutoPopDelay property.
getInitialDelay() Retrieves the current value of the InitialDelay property.
getRegion(Control boundControl) Retrieves the region that is bound to the specified control.
getRegions() Retrieves an array of all regions.
getReshowDelay() Retrieves the current value of the ReshowDelay property.
getShowAlways() Retrieves the current ShowAlways value.
removeAllRegions() Removes all tooltip regions from the control.
removeRegion(ToolTipRegion region) Removes a single tooltip region from the control.
setAutomaticDelay(int value) Sets the AutomaticDelay property.
setAutoPopDelay(int value) Sets the AutoPopDelay property.
setInitialDelay(int value) Sets the InitialDelay property.
setRegions(ToolTipRegion[] regions) Sets the regions to display.
setReshowDelay(int value) Sets the ReshowDelay property.
setShowAlways(boolean value) Sets the value of ShowAlways.

Constructors

ToolTip.ToolTip

Syntax
public ToolTip();
Description

Creates a ToolTip object.

ToolTip.getToolTip

Syntax
public String getToolTip( Control control );
Parameters
control
The control to get the tooltip for.
Return Value

Returns the tooltip for the specified control.

Description

Retrieves the current tooltip for the specified control.

See Also
setToolTip

ToolTip.setToolTip

Syntax
public void setToolTip( Control control, String caption );
Parameters
control
The control to set the tooltip for.
caption
The tooltip to display.
Description

Sets the tooltip for the specified control.

See Also
getToolTip

Methods

ToolTip.addRegion

Syntax
public void addRegion( ToolTipRegion region );
Parameters
region
The region to add to the control.
Description

Adds a tooltip region to the control.

See Also
removeRegion, getRegion

ToolTip.getAutomaticDelay

Syntax
public int getAutomaticDelay();
Return Value

Returns current value of the AutomaticDelay property.

Description

Retrieves the current value of the AutomaticDelay property.

See Also
setAutomaticDelay

ToolTip.getAutoPopDelay

Syntax
public int getAutoPopDelay();
Return Value

Returns current value of the AutoPopDelay property.

Description

Retrieves the current value of the AutoPopDelay property.

See Also
setAutoPopDelay

ToolTip.getInitialDelay

Syntax
public int getInitialDelay();
Return Value

Returns current value of the InitialDelay property.

Description

Retrieves the current value of the InitialDelay property.

See Also
setInitialDelay

ToolTip.getRegion

Syntax
public ToolTipRegion getRegion( Control boundControl );
Parameters
boundControl
The control to find the region for.
Return Value

Returns the region that is bound to boundControl.

Description

Retrieves the region that is bound to the specified control.

ToolTip.getRegions

Syntax
public ToolTipRegion[] getRegions();
Return Value

Returns an array of all regions.

Description

Retrieves an array of all regions.

See Also
setRegions

ToolTip.getReshowDelay

Syntax
public int getReshowDelay();
Return Value

Returns the current value of the ReshowDelay property.

Description

Retrieves the current value of the ReshowDelay property.

See Also
setReshowDelay

ToolTip.getShowAlways

Syntax
public boolean getShowAlways();
Return Value

Returns current ShowAlways value.

Description

Retrieves the current ShowAlways value.

See Also
setShowAlways

ToolTip.removeAllRegions

Syntax
public void removeAllRegions();
Description

Removes all tooltip regions from the control.

See Also
removeRegion

ToolTip.removeRegion

Syntax
public void removeRegion( ToolTipRegion region );
Parameters
region
The region to remove.
Description

Removes a single tooltip region from the control.

See Also
removeAllRegions

ToolTip.setAutomaticDelay

Syntax
public void setAutomaticDelay( int value );
Parameters
value
The new value in milliseconds.
Description

Sets the AutomaticDelay property. When the AutomaticDelay property is set, values are given to the AutoPopDelay, InitialDelay, and ReshowDelay based on the AutomaticDelay value. The AutoPopDelay is always set to 10 times the AutomaticDelay; the InitialDelay is set to 1/5 times the AutomaticDelay; and ReshowDelay is set to the same time as the AutomaticDelay.

See Also
getAutomaticDelay, setAutoPopDelay, setInitialDelay, setReshowDelay

ToolTip.setAutoPopDelay

Syntax
public void setAutoPopDelay( int value );
Parameters
value
The new value in milliseconds.
Description

Sets the AutoPopDelay property. This is the length of time the tooltip window remains visible if the pointer is stationary inside a tooltip region.

See Also
getAutomaticDelay, setAutomaticDelay, setInitialDelay, setReshowDelay

ToolTip.setInitialDelay

Syntax
public void setInitialDelay( int value );
Parameters
value
The new value in milliseconds.
Description

Sets the InitialDelay property. This is the length of time the pointer must remain stationary within a tooltip region before the tooltip window appears.

See Also
getAutomaticDelay, setAutomaticDelay, setAutoPopDelay, setReshowDelay

ToolTip.setRegions

Syntax
public void setRegions( ToolTipRegion[] regions );
Parameters
regions
The regions to display.
Description

Sets the regions to display.

See Also
getRegions

ToolTip.setReshowDelay

Syntax
public void setReshowDelay( int value );
Parameters
value
The new value in milliseconds.
Description

Sets the ReshowDelay property. This is the length of time it takes for subsequent tooltip windows to appear as the pointer moves from one tooltip region to another.

See Also
getAutomaticDelay, setAutomaticDelay, setAutoPopDelay, setInitialDelay

ToolTip.setShowAlways

Syntax
public void setShowAlways( boolean value );
Parameters
value
The new value for the ShowAlways property.
Description

Sets the value of ShowAlways. When ShowAlways is set to true, the tooltips are always displayed, even if the parent form is not active.

See Also
getShowAlways