ToolTip Contents

When the user holds the mouse pointer over a widget, the normal VTScada behavior is to display the associated tag's name and description. You can control what text will be displayed for your tag by including a call to WinToolTipCtrl in your tag's Common module.

If your Common module does not include a call to WinTooltipCtrl, then there won't be a tool-tip.

The target for the tool-tip should be the same as the area parameters passed to the Common module. If this point is contained within another object and the container calls this widget's module, then you do not want this tool tip note to display. This is typically indicated by the calling container's widget module adding one additional parameter to the list. By detecting that the number of parameters that the widget is called with is not the same as the number of formal parameters, you can prevent the tool tip note from appearing. This will also prevent the note from appearing during preview and placement which is also desirable.

For example:

  WinTooltipCtrl(Left, Bottom, Right, Top,
                 WTTS_FLAG_TRACKINACTIVE + (PickValid(\NoBalloonTips, 0) ? 0 : WTTS_FLAG_BALLOON),
                 \GetPhrase(\Description), \Name, Invalid,
                 \ShowTip && ! *pNavActive && PickValid(! DisableTooltip, 1),
                 \TipFont\Value);