[Previous] [Contents] [Index] [Next]

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
Pointer to the PtGenList widget.
parent
Pointer to the widget's parent window.
area
Pt_ARG_AREA resource for the balloon.
string
String for the balloon.
column
Number of the column to extract from the string (see below).
font
Font for the label. If this is NULL, the font used for the PtGenList widget is used.

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 will contain the string "Two".

Returns:

A pointer to the PtLabel widget.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

[Previous] [Contents] [Index] [Next]