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