# DM_SETTEXTPTR

The DM_SETTEXTPTR message is sent to the dialog manager to set a new string value for an edit line or a new caption for an item. Unlike the DM_SETTEXT message, this message works with a string pointer.

### Param1

The ID of the dialog item for which the text should be changed.

### Param2

Pointer to the string containing the new text. If this parameter is equal to `NULL` the message does nothing.

### Return

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

### Controls

Control | Description
--- | ---
All | All dialog items

### Remarks

1. For DI_COMBOBOX items affects only the edit line (has no effect for items with the DIF_DROPDOWNLIST flag set).
2. The DM_SETTEXTPTR message in FAR versions prior to 1.70 beta 4 returned the string length INCLUDING the terminating NULL character.

### Example

See also:
DialogEx | DM_SETTEXT