Méthode IExplorerBrowser ::FillFromObject (shobjidl_core.h)

  • Article

Crée un dossier de résultats et le remplit d’éléments.

Syntaxe

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

Paramètres

[in] punk

Type : IUnknown*

Pointeur d’interface sur l’objet source qui remplira le IResultsFolder. Il peut s’agir d’un IDataObject ou de n’importe quel objet qui peut être utilisé avec INamespaceWalk.

[in] dwFlags

Type : EXPLORER_BROWSER_FILL_FLAGS

Une des valeurs EXPLORER_BROWSER_FILL_FLAGS .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’objet transmis via le pointeur d’interface punk remplit IResultsFolder.

Le paramètre dwFlags peut être l’un des EXPLORER_BROWSER_FILL_FLAGS ou l’un des indicateurs définis dans le paramètre wFlags de BrowseObject, à l’exception des indicateurs qui indiquent la navigation.

Le paramètre punk peut être n’importe quel objet que INamespaceWalk peut consommer. S’il est appelé avec EBF_SELECTFROMDATAOBJECT, punk doit être un IDataObject et l’espace de noms sera parcouru au niveau parent de l’objet de données, y compris tous les éléments homologues, mais en sélectionnant uniquement ceux contenus dans l’objet de données. Cet indicateur est le plus couramment utilisé lorsque FOLDERSETTINGSa FWF_CHECKSELECT activé, ce qui permet case activée sélection d’un ensemble d’éléments compilés dans l’objet de données.

Note Si un pointeur vers une liste d’identificateurs d’élément (PIDL) dans l’objet de données est complet, le dossier parent ne peut pas être correctement parcouru, car des éléments de dossier de bureau sont ajoutés à la liste.
 
Cette méthode peut être appelée plusieurs fois, chaque appel successif ajoutant des éléments supplémentaires à la vue. IExplorerBrowser ::RemoveAll peut être appelé pour effacer le contenu du dossier des résultats. Cette fonction doit être appelée avec EBF_NODROPTARGET pour empêcher les utilisateurs de faire glisser de nouveaux éléments dans l’affichage, sauf si cela est souhaité. Il est également recommandé de définir EBO_NAVIGATEONCE afin que le navigateur reste dans le ResultsFolder, ce qui empêche l’utilisateur de naviguer vers un dossier qui peut être représenté dans l’objet de données.

Pour manipuler directement des éléments dans le dossier de résultats, appelez IExplorerBrowser ::GetCurrentView pour obtenir l’affichage à partir d’ExplorerBrowser, puis demandez à la vue le dossier de résultats à l’aide de GetFolder. L’utilisation du dossier des résultats obtenus permet de manipuler les données dans le dossier avec plus de flexibilité qu’avec les méthodes fournies par IExplorerBrowser .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (inclure Shobjidl.h)

Voir aussi

FOLDERFLAGS

IExplorerBrowser