IFileDialog::SetFolder-Methode (shobjidl_core.h)

  • Artikel

Legt einen Ordner fest, der immer ausgewählt wird, wenn das Dialogfeld geöffnet wird, unabhängig von der vorherigen Benutzeraktion.

Syntax

HRESULT SetFolder(
  [in] IShellItem *psi
);

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf die Schnittstelle, die den Ordner darstellt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Dieser Ordner überschreibt alle Zuletzt verwendeten Ordner. Wenn diese Methode aufgerufen wird, während das Dialogfeld angezeigt wird, führt dies dazu, dass das Dialogfeld zum angegebenen Ordner navigiert.

Im Allgemeinen wird die Verwendung dieser Methode nicht empfohlen. Wenn Sie SetFolder aufrufen, bevor Sie das Dialogfeld anzeigen, wird der letzte Speicherort, an dem der Benutzer gespeichert oder geöffnet hat, nicht angezeigt. Es sei denn, es gibt einen sehr spezifischen Grund für dieses Verhalten, es ist keine gute oder erwartete Benutzererfahrung und sollte daher vermieden werden. In fast allen Instanzen ist IFileDialog::SetDefaultFolder die bessere Methode.

Wenn ab Windows 7 der durch psi angegebene Pfad des Ordners der Standardpfad eines bekannten Ordners ist, wird der aktuelle Pfad des bekannten Ordners im Dialogfeld verwendet. Dieser Pfad ist möglicherweise nicht mit dem in psi angegebenen Pfad identisch. für instance, wenn der bekannte Ordner umgeleitet wurde. Wenn der bekannte Ordner eine Bibliothek (virtuelle Ordner Dokumente, Musik, Bilder und Videos) ist, wird der Pfad der Bibliothek im Dialogfeld verwendet. Wenn die angegebene Bibliothek ausgeblendet ist (standardmäßig ab Windows 8.1), wird der Standardspeicherort der Bibliothek im Dialogfeld verwendet, z. B. der Microsoft OneDrive-Ordner Dokumente für die Dokumentbibliothek. Aufgrund dieser Zuordnungen entspricht der im Dialogfeld verwendete Ordnerspeicherort möglicherweise nicht genau dem, den Sie beim Aufrufen dieser Methode angegeben haben.

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)