Funzione di callback LPFNVIEWCALLBACK (shlobj_core.h)
[Questa interfaccia è supportata tramite Windows XP Service Pack 2 (SP2) e Windows Server 2003. Potrebbe non essere supportato nelle versioni successive di Windows.]
Definisce il prototipo per la funzione di callback utilizzata dall'oggetto visualizzazione cartelle di sistema. Questa funzione duplica essenzialmente la funzionalità di IShellFolderViewCB.
Sintassi
LPFNVIEWCALLBACK Lpfnviewcallback;
HRESULT Lpfnviewcallback(
[in] IShellView *psvOuter,
[in] IShellFolder *psf,
[in] HWND hwndMain,
UINT uMsg,
WPARAM wParam,
LPARAM lParam
)
{...}
Parametri
[in] psvOuter
Tipo: IShellView*
Puntatore all'istanza proprietaria di IShellView, se applicabile. Questo parametro può essere NULL.
[in] psf
Tipo: IShellFolder*
Puntatore all'istanza di IShellFolder a cui si applica il messaggio.
[in] hwndMain
Tipo: HWND
Handle della finestra contenente la visualizzazione che riceve il messaggio.
uMsg
Tipo: UINT
Una delle notifiche seguenti.
SFVM_ADDPROPERTYPAGES
Consente all'oggetto callback di specificare una pagina da aggiungere al foglio proprietà Proprietà dell'oggetto selezionato.
SFVM_BACKGROUNDENUM
Consente all'oggetto callback di richiedere che l'enumerazione venga eseguita in un thread in background.
SFVM_BACKGROUNDENUMDONE
Notifica all'oggetto callback che l'enumerazione in background è stata completata.
SFVM_COLUMNCLICK
Notifica all'oggetto callback che l'utente ha fatto clic su un'intestazione di colonna per ordinare l'elenco di oggetti nella visualizzazione cartelle.
SFVM_DEFITEMCOUNT
Consente all'oggetto callback di specificare il numero di elementi nella visualizzazione cartelle.
SFVM_DEFVIEWMODE
Consente all'oggetto callback di specificare la modalità di visualizzazione.
SFVM_DIDDRAGDROP
Notifica alla funzione di callback che è iniziata un'operazione di trascinamento.
SFVM_FSNOTIFY
Notifica all'oggetto callback che si è verificato un evento che influisce su uno dei relativi elementi.
SFVM_GETANIMATION
Consente all'oggetto callback di specificare che viene visualizzata un'animazione mentre gli elementi vengono enumerati in un thread in background.
SFVM_GETBUTTONINFO
Consente all'oggetto callback di aggiungere pulsanti alla barra degli strumenti.
SFVM_GETBUTTONS
Consente all'oggetto callback di specificare i pulsanti da aggiungere alla barra degli strumenti.
SFVM_GETDETAILSOF
Consente all'oggetto callback di fornire i dettagli per un elemento in una cartella shell. Usare solo se una chiamata a IShellFolder2::GetDetailsOf ha esito negativo e non esiste alcun metodo IShellDetails::GetDetailsOf disponibile per la chiamata.
SFVM_GETHELPTEXT
Consente all'oggetto callback di specificare una stringa di testo della Guida per le voci di menu o i pulsanti della barra degli strumenti.
SFVM_GETHELPTOPIC
Consente all'oggetto callback di specificare un file e un argomento della Guida.
SFVM_GETNOTIFY
Specifica quali eventi genereranno un messaggio di SFVM_FSNOTIFY per un determinato elemento.
SFVM_GETPANE
Consente all'oggetto callback di specificare il riquadro della barra di stato in cui visualizzare le informazioni sull'area Internet.
SFVM_GETSORTDEFAULTS
Consente all'oggetto callback di specificare i parametri di ordinamento predefiniti.
SFVM_GETTOOLTIPTEXT
Consente all'oggetto callback di specificare una stringa di testo della descrizione comando per le voci di menu o i pulsanti della barra degli strumenti.
SFVM_GETZONE
Consente all'oggetto callback di fornire informazioni sulla zona Internet.
SFVM_INITMENUPOPUP
Consente all'oggetto callback di modificare il menu di scelta rapida di un elemento.
SFVM_INVOKECOMMAND
Notifica all'oggetto callback che è stato richiamato uno dei comandi della barra degli strumenti o dei menu.
SFVM_MERGEMENU
Consente all'oggetto callback di unire le voci di menu nei menu di Esplora risorse di Windows.
SFVM_QUERYFSNOTIFY
Consente all'oggetto callback di registrare una cartella in modo che le modifiche apportate alla visualizzazione della cartella genereranno notifiche.
SFVM_SETISFV
Notifica all'oggetto callback del sito del contenitore. Questa operazione viene usata solo quando viene usato IObjectWithSite::SetSite e SHCreateShellFolderViewEx .
SFVM_SIZE
Notifica all'oggetto callback che la visualizzazione cartelle è stata ridimensionata.
SFVM_THISIDLIST
Consente all'oggetto callback di specificare il PIDL della vista. Questa operazione viene usata solo quando IPersistIDList::SetIDList e IPersistFolder2::GetCurFolder non sono riusciti.
SFVM_UNMERGEMENU
Notifica all'oggetto callback che viene rimosso un menu.
SFVM_UPDATESTATUSBAR
Consente all'oggetto callback di richiedere l'aggiornamento della barra di stato.
SFVM_WINDOWCREATED
Notifica all'oggetto callback che viene creata la finestra della visualizzazione cartelle.
wParam
Tipo: WPARAM
Informazioni aggiuntive dipendenti dal valore in uMsg. Per requisiti specifici, vedere le singole pagine di notifica.
lParam
Tipo: LPARAM
Informazioni aggiuntive dipendenti dal valore in uMsg. Per requisiti specifici, vedere le singole pagine di notifica.
Valore restituito
Tipo: HRESULT
Se questa funzione di callback ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlobj_core.h (include Shlobj.h) |