IProgressDialog::SetCancelMsg-Methode (shlobj_core.h)
Legt eine Meldung fest, die angezeigt wird, wenn der Benutzer den Vorgang abbricht.
Syntax
HRESULT SetCancelMsg(
[in] PCWSTR pwzCancelMsg,
LPCVOID pvResevered
);
Parameter
[in] pwzCancelMsg
Typ: PCWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die anzuzeigende Nachricht enthält.
pvResevered
Typ: LPCVOID
Reserviert. Auf NULL festgelegt.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Obwohl der Benutzer auf Abbrechen klickt, kann die Anwendung IProgressDialog::StopProgressDialog nicht sofort aufrufen, um das Dialogfeld zu schließen. Die Anwendung muss warten, bis sie das nächste Mal IProgressDialog::HasUserCancelled aufruft , um festzustellen, dass der Benutzer den Vorgang abgebrochen hat. Da diese Verzögerung erheblich sein kann, gibt das Dialogfeld "Fortschritt" dem Benutzer sofortiges Feedback, indem die Textzeilen 1 und 2 gelöscht und die Meldung "Abbrechen" in Zeile 3 angezeigt wird. Die Meldung soll den Benutzer darüber informieren, dass die Verzögerung normal ist und dass das Statusdialogfeld in Kürze geschlossen wird. Es ist in der Regel auf etwa "Bitte warten, während ..." festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h |
| DLL | Shell32.dll (Version 5.0 oder höher) |