TDM _ UPDATE _ ICON-Meldung

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-SYMBOL _ MAIN
Hauptsymbol.
_ _ TDIE-SYMBOLFUßZEILE
Fußzeilensymbol.

lParam [ In]

Ein Zeiger auf eine Zeichenfolge (PCWSTR) oder ein Handle zu einem Symbol (HICON), das angezeigt werden soll. Wenn lParam NULL ist, wird unabhängig vom Wert von wParam kein Symbol angezeigt.

Wenn der Wert von wParam TDIE ICON MAIN ist und das TDF USE HICON MAIN-Flag auf dem _ _ _ _ _ dwFlags-Member der TASKDIALOGCONFIG-Struktur festgelegt ist, die zum Erstellen des Aufgabendialogfelds verwendet wird, muss lParam ein Handle für ein Symbol (HICON) enthalten, um es anzuzeigen.

Wenn der Wert von wParam TDIE ICON FOOTER ist und das _ _ TDF USE HICON FOOTER-Flag auf dem _ _ _ dwFlags-Member der TASKDIALOGCONFIG-Struktur festgelegt ist, die zum Erstellen des Aufgabendialogfelds verwendet wird, muss lParam ein Handle für ein Symbol (HICON) enthalten, um es anzuzeigen.

Wenn die TDF _ USE _ HICON MAIN- oder TDF USE HICON FOOTER-Flags nicht auf dem dwFlags-Member festgelegt sind, muss lParam auf eine mit NULL beendete _ _ _ _ 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 (angegeben im hInstance-Member der TASKDIALOGCONFIG-Struktur) oder , wenn hInstance NULL ist, aus dem Ressourcenmodul (imageres.dll) der Anwendung sein. Um eine Systemressource zu identifizieren, verwenden Sie einen gültigen Systembezeichner, der über das MAKEINTRESOURCE-Makro übergeben wird, oder einen der folgenden vordefinierten Werte aus commctrl.h:

Wert Bedeutung
_TD-FEHLERSYMBOL _
Ein Stoppzeichensymbol.
_TD-WARNUNGSSYMBOL _
Ein Ausrufezeichensymbol.
_TD-INFORMATIONSSYMBOL _
Ein Kleinbuchstabe "i" in einem Kreissymbol.
TD _ _ SHIELD-SYMBOL
Ein Sicherheitsschutzsymbol.

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 an 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ßzeilenmitglieder der TASKDIALOGCONFIG-Struktur, die zum Erstellen des Aufgabendialogfelds verwendet werden, NULL sind) und diese Meldung gesendet wird, wird dem Aufgabendialogfeld keine Fußzeile dynamisch hinzugefügt. Dasselbe gilt für das Senden dieser Nachricht, um ein Headersymbol zu aktualisieren, wenn ein Aufgabendialogfeld ohne Header erstellt wird. Verwenden Sie die TDM NAVIGATE _ _ PAGE-Funktionalität, um zur Laufzeit eine Kopf- oder Fußzeile hinzuzufügen.

Requirements (Anforderungen)

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