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 |
|