TDM_SET_ELEMENT_TEXT message

Updates a text element in a task dialog.

Parameters

wParam [in]

Indicates the element to update. (For an illustration, 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]

The new text to use.

Return value

The return value is ignored.

Remarks

The size or layout of the task dialog may change to accommodate the new text.

Examples

The following example code shows how to set the footer text in the task dialog represented by hwnd.

SendMessage(hwnd, TDM_SET_ELEMENT_TEXT, (WPARAM)TDE_FOOTER, (LPARAM)L"New footer text.");

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_UPDATE_ELEMENT_TEXT