IProgressDialog::StartProgressDialog-Methode (shlobj_core.h)

Artikel
03/02/2024

Startet das Statusdialogfeld.

Syntax

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

Parameter

[in] hwndParent

Typ: HWND

Ein Handle für das übergeordnete Fenster des Dialogfelds.

punkEnableModless

Typ: IUnknown*

Reserviert. Auf NULL festgelegt.

dwFlags

Art: DWORD

Flags, die den Vorgang des Statusdialogfelds steuern. Eine Kombination der folgenden Werte:

PROGDLG_NORMAL

Normales Statusverhalten im Dialogfeld.

PROGDLG_MODAL

Das Statusdialogfeld ist dem von hwndParent angegebenen Fenster modal. Standardmäßig ist ein Statusdialogfeld moduslos.

PROGDLG_AUTOTIME

Schätzen Sie automatisch die verbleibende Zeit, und zeigen Sie die Schätzung in Zeile 3 an. Wenn dieses Flag festgelegt ist, kann IProgressDialog::SetLine nur zum Anzeigen von Text in den Zeilen 1 und 2 verwendet werden.

PROGDLG_NOTIME

Zeigen Sie den Text "Verbleibende Zeit" nicht an.

PROGDLG_NOMINIMIZE

Zeigen Sie keine Schaltfläche zum Minimieren auf der Untertitel leiste des Dialogfelds an.

PROGDLG_NOPROGRESSBAR

Zeigen Sie keine Statusanzeige an. In der Regel kann eine Anwendung quantitativ bestimmen, wie viel des Vorgangs verbleibt, und diesen Wert in regelmäßigen Abständen an IProgressDialog::SetProgress übergeben. Das Statusdialogfeld verwendet diese Informationen, um die Statusanzeige zu aktualisieren. Dieses Flag wird in der Regel festgelegt, wenn die aufrufende Anwendung auf den Abschluss eines Vorgangs warten muss, aber keine quantitativen Informationen enthält, die sie zum Aktualisieren des Dialogfelds verwenden kann.

PROGDLG_MARQUEEPROGRESS

Windows Vista und höher. Legt die Statusanzeige auf den Festrahmenmodus fest. Dies bewirkt, dass die Statusanzeige horizontal scrollt, ähnlich wie bei einer Festrahmenanzeige. Verwenden Sie dies, wenn Sie angeben möchten, dass Fortschritte erzielt werden, die für den Vorgang erforderliche Zeit jedoch unbekannt ist.

PROGDLG_NOCANCEL

Windows Vista und höher. Die Schaltfläche "Abbrechen" wird nicht angezeigt. Der Vorgang kann nicht abgebrochen werden. Verwenden Sie dies nur, wenn dies unbedingt erforderlich ist.

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.

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)

Weitere Informationen

IProgressDialog

Freigeben über