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

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