Freigeben über

TDM_UPDATE_ICON Nachricht

  • Artikel

Aktualisiert das Symbol eines Aufgabendialogfelds.

Parameter

wParam [in]

Gibt an, welches Symbolelement aktualisiert werden soll. Dieser Parameter muss einer der folgenden Werte sein:

Wert Bedeutung
TDIE_ICON_MAIN
 Hauptsymbol.
TDIE_ICON_FOOTER
 Fußzeilensymbol.

lParam [in]

Ein Zeiger auf eine anzuzeigende Zeichenfolge (PCWSTR) oder ein Handle auf ein Symbol (HICON). Wenn lParamNULL ist, wird kein Symbol angezeigt, unabhängig vom Wert von wParam.

Wenn der Wert von wParam TDIE_ICON_MAIN ist und das TDF_USE_HICON_MAIN-Flag für den dwFlags-Member der TASKDIALOGCONFIG-Struktur festgelegt ist, die zum Erstellen des Aufgabendialogfelds verwendet wird, muss lParam ein Handle für ein anzuzeigendes Symbol (HICON) enthalten.

Wenn der Wert von wParam TDIE_ICON_FOOTER ist und das TDF_USE_HICON_FOOTER-Flag für den dwFlags-Member der TASKDIALOGCONFIG-Struktur festgelegt ist, die zum Erstellen des Aufgabendialogfelds verwendet wird, muss lParam ein Handle für ein anzuzeigende Symbol (HICON) enthalten.

Wenn die TDF_USE_HICON_MAIN- oder TDF_USE_HICON_FOOTER-Flags nicht für den dwFlags-Member festgelegt sind, muss lParam auf eine MIT NULL endende Unicode-Zeichenfolge (PCWSTR) verweisen, die einen gültigen Ressourcenbezeichner enthält, der über das MAKEINTRESOURCE-Makro übergeben wird. Das Symbol wird basierend auf dem Wert von wParam angezeigt: Wenn der Wert TDIE_ICON_MAIN ist, wird das Symbol in der Kopfzeile angezeigt; Wenn der Wert TDIE_ICON_FOOTER ist, wird das Symbol in der Fußzeile angezeigt. Die Ressource muss entweder aus dem Ressourcenmodul der Anwendung stammen (angegeben im hInstance-Member der TASKDIALOGCONFIG-Struktur ), oder, wenn hInstanceNULL ist, aus dem Ressourcenmodul des Systems (imageres.dll). Verwenden Sie zum Identifizieren einer Systemressource einen gültigen Systembezeichner, der über das MAKEINTRESOURCE-Makro übergeben wird, oder einen der folgenden vordefinierten Werte aus commctrl.h:

Wert Bedeutung
TD_ERROR_ICON
 Ein Stoppzeichensymbol.
TD_WARNING_ICON
 Ein Ausrufezeichensymbol.
TD_INFORMATION_ICON
 Ein Kleinbuchstabe "i" in einem Kreissymbol.
TD_SHIELD_ICON
 Ein Sicherheitsschildsymbol.

Rückgabewert

Der Rückgabewert wird ignoriert.

Bemerkungen

Das Layout des Aufgabendialogfelds mit dem Symbol schlägt möglicherweise fehl, und dies wird möglicherweise nicht im Rückgabewert widergespiegelt. Der Rückgabewert S_OK gibt nur an, dass das Aufgabendialogfeld die Nachricht empfangen und versucht hat, sie zu verarbeiten. Wenn das Layout des Aufgabendialogfelds fehlschlägt, wird der Dialog geschlossen, und bei der registrierten Rückruffunktion wird ein HRESULT-Code zurückgegeben. Weitere Informationen zur Syntax der Rückruffunktion finden Sie unter TaskDialogCallbackProc.

Wenn das Aufgabendialogfeld ohne Fußzeile erstellt wird (d. h., die entsprechenden Fußzeilenmember der TASKDIALOGCONFIG-Struktur , die zum Erstellen des Aufgabendialogfelds verwendet werden, sind NULL), und diese Nachricht wird gesendet, wird dem Aufgabendialogfeld keine Fußzeile hinzugefügt. Dasselbe gilt für das Senden dieser Nachricht, um ein Headersymbol zu aktualisieren, wenn ein Aufgabendialogfeld ohne Header erstellt wird. Um zur Laufzeit eine Kopf- oder Fußzeile hinzuzufügen, verwenden Sie die TDM_NAVIGATE_PAGE Funktionalität.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 [nur Desktop-Apps]
Header
Commctrl.h