Tooltip.property

Description

Settings for tooltips for a column or control.

Applies to

Button, Column, Computed Field, Graph, GroupBox, InkPicture, Line, OLE, Blob OLE, Oval, Picture, Rectangle, Report, RoundRectangle, and Text controls

Syntax

PowerBuilder dot notation:

dw_control.Object.controlname.Tooltip.property

Describe and Modify argument:

"controlname.Tooltip.property { = ' value ' }"

SyntaxFromSql:

Column ( Tooltip.property = value )
Text ( Tooltip.property = value )

Parameter

Description

controlname

The control whose Tooltip properties you want to get or set.

When generating DataWindow syntax with SyntaxFromSql, the Tooltip settings apply to all columns or all text controls.

property

A property that applies to the tooltip of a control, as listed in the Property table below.

value

Values for the properties are shown below. Value can be a quoted DataWindow expression.

Property for Tooltip

Value

Backcolor

(exp) A long specifying the color (the red, green, and blue values) to be used for the background color of the tooltip box.

Delay.initial

(exp) An integer specifying the time in milliseconds before the tooltip box displays (minimum zero, maximum 32767). Default value is 0.

Delay.visible

(exp) An integer specifying the time in milliseconds that the tootip box remains visible (minimum zero, maximum 32767). Default value is 32000.

Enabled

(exp) Whether the tooltip is enabled. Values are:

  • Yes – The tooltip is enabled.

  • No – (Default) The tooltip is disabled.

HasCloseButton

Reserved for future use only

Icon

(exp) A string for the icon to display to the left of the title in the tooltip box. The default is for no icon to display. Three stock icons are available for display in the tooltip box: Info, Warning, and Error.

  • 0 – None

  • 1 – Info

  • 2 – Warning

  • 3 – Error

Isbubble

(exp) Whether the tooltip box displays as a basic rectangle or a callout bubble.

Values are:

  • 0 – Displays the standard tooltip shape.

  • 1 – Displays the tooltip as a rounded callout bubble.

MaxWidth

Reserved for future use only

Position

Reserved for future use only

Tip

(exp) A string specifying the text for the tooltip. If you use an expression, make sure the result is converted to a string.

Title

(exp) A string specifying the tooltip box title. If you use an expression, make sure the result is converted to a string.

Textcolor

(exp) A long expression specifying the color (the red, green, and blue values) to be used as the control’s tooltip color.

Usage


In the painter

Select the control and set the value on the Tooltip tab of the Properties view.

Not available for columns or controls in RichText, Graph, or OLE DataWindow objects. If you want to add a tooltip to an InkPicture in a DataWindow, that InkPicture must not be enabled.

Examples

Example 1

dw_1.Object.oval_1.Tooltip.Color = RGB(255, 0, 128)

ls_data = dw_1.Describe("oval_1.Tooltip.Color")

dw_1.Modify("emp_name.Tooltip.Color='11665407'")

SQLCA.SyntaxFromSQL(sql_syntax, &
   "Style(...) Column(Tooltip.Delay.Visible=15 ...) &
    ...",    ls_Errors)

SQLCA.SyntaxFromSQL(sql_syntax, &
  "Style(...) Column(Tooltip.TextColor=11665407 ...)"&
  , ls_Errors)