DM_GETTEXTPTR

Far Manager

DM_GETTEXTPTR

The DM_GETTEXTPTR message is sent to the dialog manager to retrieve the text of an edit string or the caption of a dialog item. Unlike the DM_GETTEXT message, this one works with a string pointer.

Param1

The ID of the dialog item for which you want to retrieve the text.

Param2

Pointer to destination string that receives the text.
If Param2 is NULL this is yet another way to get the size of the text (see DM_GETTEXTLENGTH).

Return

Size of the specified dialog item string NOT including the terminating character '\0'.

Controls

ControlDescription
All String data is returned for edit lines, captions for any other items. Everything contained in FarDialogItem.Data or FarDialogItem.PtrData.

Remarks

The DM_GETTEXTPTR message in FAR versions up to 1.70 beta 3 returned the string length INCLUDING the terminating character.

Example

See also: