PtMultiTextQuery_t

Structure for getting information about a line or character

Synopsis:

typedef struct
{
    int character_number;
    int line_number;
    PtMultiTextLine_t *line;
    PtMultiTextSegment_t *segment;
    char *character;
} PtMultiTextQuery_t;

Description:

This structure is used to get information about a specified line or character in a PtMultiText widget. You'll use it when getting the value of Pt_ARG_MULTITEXT_QUERY_CHARACTER or Pt_ARG_MULTITEXT_QUERY_LINE. When getting these resources, use the len member of the PtArg_t structure (see the Photon Library Reference) to indicate the character or line to be queried. When you get call PtGetResources(), the members of the PtMultiTextQuery_t structure are filled in:

character_number
The index into the string of the character queried. Characters are numbered from 0.
line_number
The index of the line queried. Lines are numbered from 1.
line
A pointer to the PtMultiTextLine_t structure that describes the line queried or the line that contains the character queried.
segment
A pointer to the PtMultiTextSegment_t structure in effect for the character queried or at the beginning of the line queried.
character
The character queried or the first character of the line queried.

Classification:

Photon

See also:

PtMultiText, PtMultiTextSegment_t, PtMultiTextLine_t