PtGenListCreateTextBalloon()

Create a popup balloon for a list item

Synopsis:

PtWidget_t *PtGenListCreateTextBalloon(
                PtWidget_t *widget,
                PtWidget_t *parent,
                const PhArea_t *area,
                const char *string,
                int column,
                const char *font);

Description:

This function creates a PtLabel widget to be used as a popup balloon for a list item. The arguments are as follows:

widget
A pointer to the PtGenList widget.
parent
A pointer to the widget's parent window.
area
A pointer to a PhArea_t structure to use as the Pt_ARG_AREA resource for the balloon.
string
The string to display in the balloon.
column
The number of the column to extract from the string (see below).
font
The font to use for the label. If this is NULL, use the same font as the PtGenList widget.

The string consists of columns separated by tab characters. The column argument selects a column, with 0 or a negative number indicating the column at the beginning of the string, 1 indicating the characters after the first tab, and so on. For example, if column is 1 and string is "One\tTwo\tThree", the label contains the string "Two".

Returns:

A pointer to the PtLabel widget.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhArea_t in the Photon Library Reference