IProgressDialog::SetLine-Methode (shlobj_core.h)

Zeigt eine Meldung im Statusdialogfeld an.

Syntax

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

Parameter

dwLineNum

Art: DWORD

Die Zeilennummer, auf der der Text angezeigt werden soll. Derzeit gibt es drei Zeilen: 1, 2 und 3. Wenn das PROGDLG_AUTOTIME-Flag im dwFlags-Parameter enthalten war, als IProgressDialog::StartProgressDialog aufgerufen wurde, können nur die Zeilen 1 und 2 verwendet werden. Die geschätzte Zeit wird in Zeile 3 angezeigt.

[in] pwzString

Typ: PCWSTR

Eine Unicode-Zeichenfolge mit Null-Endung, die den Text enthält.

fCompactPath

Typ: BOOL

TRUE , um Pfadzeichenfolgen zu komprimieren, wenn sie zu groß sind, um in eine Zeile zu passen. Die Pfade werden mit PathCompactPath komprimiert.

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

Diese Funktion wird in der Regel verwendet, um eine Meldung wie "Element XXX wird jetzt verarbeitet" anzuzeigen. Normalerweise werden Nachrichten in den Zeilen 1 und 2 angezeigt, wobei Zeile 3 für die geschätzte Zeit reserviert ist.

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