# DM_SETTEXT

The DM_SETTEXT message is sent to the dialog manager to set a new string value for an edit line or a new caption for an item.

### Param1

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

### Param2

Pointer to the FarDialogItemData structure that is used to set the dialog item text.
If this parameter is equal to NULL, the message does nothing.

### Return

Size of the new dialog item string NOT including the 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_SETTEXT message in FAR version prior to 1.70 beta 4 returned the string length INCLUDING the terminating NULL character.

### Example

See also:
DialogEx | DM_SETTEXTPTR