Metodo IExplorerBrowser::FillFromObject (shobjidl_core.h)

Articolo
03/15/2023

Crea una cartella dei risultati e la riempie con elementi.

Sintassi

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

Parametri

[in] punk

Tipo: IUnknown*

Puntatore dell'interfaccia nell'oggetto di origine che riempie IResultsFolder. Questo può essere un IDataObject o qualsiasi oggetto che può essere usato con INamespaceWalk.

[in] dwFlags

Tipo: EXPLORER_BROWSER_FILL_FLAGS

Uno dei valori EXPLORER_BROWSER_FILL_FLAGS .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'oggetto passato tramite il puntatore dell'interfaccia riempie IResultsFolder.

Il parametro dwFlags può essere uno dei EXPLORER_BROWSER_FILL_FLAGS o uno dei flag definiti nel parametro wFlags di BrowseObject, ad eccezione dei flag che indicano la navigazione.

Il parametro punk può essere qualsiasi oggetto che INamespaceWalk può utilizzare. Se viene chiamato con EBF_SELECTFROMDATAOBJECT, punk deve essere un IDataObject e lo spazio dei nomi verrà camminato a livello padre dell'oggetto dati, inclusi tutti gli elementi peer, ma selezionando solo quelli contenuti nell'oggetto dati. Questo flag viene usato più comunemente quando FOLDERSETTINGS è abilitato FWF_CHECKSELECT , consentendo la selezione di un set di elementi compilati nell'oggetto dati.

Nota Se un puntatore a un elenco di identificatori di elemento (PIDL) nell'oggetto dati è completo, la cartella padre non può essere eseguita correttamente, perché gli elementi della cartella desktop verranno aggiunti all'elenco.

Questo metodo può essere chiamato più volte, con ogni chiamata successiva aggiungendo elementi aggiuntivi alla visualizzazione. IExplorerBrowser::RemoveAll può essere chiamato per cancellare il contenuto della cartella dei risultati. Questa funzione deve essere chiamata con EBF_NODROPTARGET per impedire agli utenti di trascinare nuovi elementi nella visualizzazione, a meno che non sia desiderato. È consigliabile anche impostare EBO_NAVIGATEONCE in modo che il browser rimanga in ResultsFolder, impedendo all'utente di passare a una cartella che può essere rappresentata nell'oggetto dati.

Per modificare direttamente gli elementi nella cartella dei risultati, chiamare IExplorerBrowser::GetCurrentView per ottenere la visualizzazione da ExplorerBrowser e quindi chiedere la visualizzazione per la cartella dei risultati usando GetFolder. L'uso della cartella risultati ottenuta consente la manipolazione dei dati nella cartella con maggiore flessibilità rispetto ai metodi forniti da IExplorerBrowser .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

FOLDERFLAGS

IExplorerBrowser