TDM_UPDATE_ELEMENT_TEXT message

Updates a text element in a task dialog.

Parameters

wParam [in]

Indicates the element to update. (For an illustration of the elements, see About Task Dialogs.) This parameter must be one of the following values:

Value	Meaning
TDE_CONTENT	Content.
TDE_EXPANDED_INFORMATION	Expanded information.
TDE_FOOTER	Footer text.
TDE_MAIN_INSTRUCTION	Main instruction.

lParam [in]

Pointer to a Unicode string that contains the new text.

Return value

The return value is ignored.

Remarks

To avoid clipping, the new text must be no longer than the existing text. Setting the text to a shorter string does not cause the dialog box to resize.

If the pszExpandedInformation member of the TASKDIALOGCONFIG structure used to create the task dialog was NULL, and you send a TDM_UPDATE_ELEMENT_TEXT message with TDE_EXPANDED_INFORMATION, nothing will happen.

The above also applies to the footer and TDE_FOOTER.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Commctrl.h

See also

TDM_SET_ELEMENT_TEXT