GlgTooltipFormatter

Tooltip formatter interface. More...

Detailed Description

Tooltip formatter interface.

A tooltip formatter is used to supply custom tooltip strings and is installed via SetTooltipFormatter.

Public Member Functions
String	GetString (GlgObject viewport, GlgObject glg_object, GlgObject tooltip_obj, int root_x, int root_y)
	Tooltip formatting method. More...

Member Function Documentation

GetString()

String GetString	(	GlgObject	viewport,
		GlgObject	glg_object,
		GlgObject	tooltip_obj,
		int	root_x,
		int	root_y
	)

Tooltip formatting method.

This method is invoked to get the text to be displayed in a tooltip. It can query an object's properties and display them in the tooltip. The returned string will be used as the tooltip text.

If the GlgTooltipFormatterOnErase global configuration resource is set to 1, the method will also be invoked with null parameters when the tooltip is erased.

Parameters

viewport	The viewport object for which tooltips are enabled via the ProcessMouse property.
glg_object	The object that owns the TooltipString resource.
tooltip_obj	The TooltipString object (S data object).
root_x	The x coordinate of the cursor relatively to the device screen.
root_y	The y coordinate of the cursor relatively to the device screen.

Returns

• a string to be displayed in the tooltip
• null to use the default tooltip
• an empty string to skip displaying the tooltip.