IExplorerBrowser::FillFromObject-Methode (shobjidl_core.h)

  • Artikel

Erstellt einen Ergebnisordner und füllt ihn mit Elementen.

Syntax

HRESULT FillFromObject(
  [in] IUnknown                    *punk,
  [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags
);

Parameter

[in] punk

Typ: IUnknown*

Ein Schnittstellenzeiger für das Quellobjekt, der den IResultsFolder füllt. Dies kann ein IDataObject oder ein beliebiges Objekt sein, das mit INamespaceWalk verwendet werden kann.

[in] dwFlags

Typ: EXPLORER_BROWSER_FILL_FLAGS

Einer der EXPLORER_BROWSER_FILL_FLAGS Werte.

Rückgabewert

Typ: HRESULT

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

Hinweise

Das über schnittstellenzeiger Punk übergebene Objekt füllt IResultsFolder aus.

Der DwFlags-Parameter kann ein beliebiges der EXPLORER_BROWSER_FILL_FLAGS oder eines der flags sein, die im wFlags-Parameter von BrowseObject definiert sind, mit Ausnahme von Flags, die die Navigation angeben.

Der Parameter punk kann ein beliebiges Objekt sein, das INamespaceWalk verwenden kann. Wenn der Punk mit EBF_SELECTFROMDATAOBJECT aufgerufen wird, muss es sich um ein IDataObject handeln, und der Namespace wird auf der übergeordneten Ebene des Datenobjekts ausgeführt, einschließlich aller Peerelemente, aber nur die im Datenobjekt enthaltenen Elemente. Dieses Flag wird am häufigsten verwendet, wenn FOLDERSETTINGSFWF_CHECKSELECT aktiviert haben, sodass eine Gruppe von Elementen überprüft werden kann, die im Datenobjekt kompiliert wurden.

Hinweis Wenn ein Zeiger auf eine Elementbezeichnerliste (Item Identifier List, PIDL) im Datenobjekt voll qualifiziert ist, kann der übergeordnete Ordner nicht erfolgreich durchlaufen werden, da der Liste Desktopordnerelemente hinzugefügt würden.
 
Diese Methode kann mehrmals aufgerufen werden, wobei jeder aufeinanderfolgende Aufruf der Ansicht zusätzliche Elemente hinzufügt. IExplorerBrowser::RemoveAll kann aufgerufen werden, um den Inhalt des Ergebnisordners zu löschen. Diese Funktion sollte mit EBF_NODROPTARGET aufgerufen werden, um zu verhindern, dass Benutzer neue Elemente in die Ansicht ziehen, sofern dies nicht gewünscht ist. Das Festlegen EBO_NAVIGATEONCE wird ebenfalls empfohlen, damit der Browser im ResultsFolder bleibt, sodass der Benutzer nicht zu einem Ordner navigiert, der möglicherweise im Datenobjekt dargestellt wird.

Um Elemente im Ergebnisordner direkt zu bearbeiten, rufen Sie IExplorerBrowser::GetCurrentView auf, um die Ansicht aus ExplorerBrowser abzurufen, und fragen Sie dann die Ansicht nach dem Ergebnisordner mithilfe von GetFolder. Die Verwendung des Ordners "Abgerufene Ergebnisse" ermöglicht die Bearbeitung der Daten im Ordner mit mehr Flexibilität als mit den Methoden, die IExplorerBrowser bereitstellt.

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)

Weitere Informationen

FOLDERFLAGS

IExplorerBrowser