IOperationsProgressDialog::StartProgressDialog-Methode (shobjidl_core.h)

Artikel
08/26/2023

Startet das angegebene Statusdialogfeld.

Syntax

HRESULT StartProgressDialog(
  [in] HWND       hwndOwner,
  [in] OPPROGDLGF flags
);

Parameter

[in] hwndOwner

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in] flags

Art: DWORD

Flags, die den Vorgang anpassen. Beachten Sie, dass diese Flags in Shlobj.h deklariert sind. Eine Kombination der folgenden Werte:

PROGDLG_NORMAL (0x00000000)

Standardmäßiges, normales Statusdialogverhalten.

PROGDLG_MODAL (0x00000001)

Das Dialogfeld ist modal zu seinem hwndOwner. Die Standardeinstellung ist moduslos.

PROGDLG_AUTOTIME (0x00000002)

Aktualisieren Sie den Text "Zeile3" mit der verbleibenden Zeit. Dieses Flag muss nicht implizit festgelegt werden, da von IOperationsProgressDialog::StartProgressDialog gestartete Statusdialoge automatisch die verbleibende Zeit anzeigen.

PROGDLG_NOTIME (0x00000004)

Zeigen Sie die verbleibende Zeit nicht an. Es wird nicht empfohlen, dieses Flag über IOperationsProgressDialog festzulegen, da es dem Zweck des Dialogfelds zuwiderläuft.

PROGDLG_NOMINIMIZE (0x00000008)

Die Schaltfläche "Minimieren" wird nicht angezeigt.

PROGDLG_NOPROGRESSBAR (0x00000010)

Zeigen Sie die Statusanzeige nicht an.

PROGDLG_MARQUEEPROGRESS (0x00000020)

Dieses Flag ist in dieser Methode ungültig. Um die Statusanzeige auf den Festrahmenmodus festzulegen, verwenden Sie die Flags in IOperationsProgressDialog::SetMode.

PROGDLG_NOCANCEL (0x00000040)

Zeigen Sie keine Abbrechen-Schaltfläche an, da der Vorgang nicht abgebrochen werden kann. Verwenden Sie diesen Wert nur, wenn dies absolut erforderlich ist.

OPPROGDLG_DEFAULT (0x00000000)

Windows 7 und höher. Gibt das standardmäßige Verhalten des Normalen Vorgangsstatus im Dialogfeld an.

OPPROGDLG_ENABLEPAUSE (0x00000080)

Zeigt eine Pausenschaltfläche an. Verwenden Sie dies nur in Situationen, in denen der Vorgang angehalten werden kann.

OPPROGDLG_ALLOWUNDO (0x00000100)

Der Vorgang kann über das Dialogfeld rückgängig werden. Die Schaltfläche Beenden wird zu Rückgängig. Wenn sie gedrückt wird, wird die Schaltfläche Rückgängig wieder auf Beenden zurückgesetzt.

OPPROGDLG_DONTDISPLAYSOURCEPATH (0x00000200)

Zeigen Sie den Pfad der Quelldatei nicht im Statusdialogfeld an.

OPPROGDLG_DONTDISPLAYDESTPATH (0x00000400)

Zeigen Sie den Pfad der Zieldatei nicht im Statusdialogfeld an.

OPPROGDLG_NOMULTIDAYESTIMATES (0x00000800)

Windows 7 und höher. Wenn die geschätzte Zeit bis zum Abschluss größer als ein Tag ist, sollten Sie die Zeit nicht anzeigen.

OPPROGDLG_DONTDISPLAYLOCATIONS (0x00001000)

Windows 7 und höher. Zeigen Sie die Position nicht im Statusdialogfeld an.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Statusdialogfeld sollte in einem separaten Thread als der Dateivorgang erstellt werden, über den der Dialog berichte. Wenn das Dialogfeld im selben Thread wie der Dateivorgang ausgeführt wird, werden Statusmeldungen bestenfalls nur gesendet, wenn ressourcen dies zulassen. Statusmeldungen im selben Thread wie der Dateivorgang werden möglicherweise gar nicht gesendet.

Nachdem IOperationsProgressDialog::StartProgressDialog aufgerufen wurde, kann von IProgressDialog, IActionProgressDialog oder IActionProgress nicht mehr auf diese instance des CLSID_ProgressDialog-Objekts zugegriffen werden. Obwohl QueryInterface für den Zugriff auf diese Schnittstellen verwendet werden kann, können die meisten ihrer Methoden nicht aufgerufen werden. IOperationsProgressDialog ist die Schnittstelle, die zum Anzeigen des neuen Statusdialogfelds für windows Vista und höher verwendet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über