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