Estensioni foglio proprietà

La voce di menu di scelta rapida Proprietà consente l'accesso ai fogli delle proprietà dello scanner o della fotocamera nella cartella Scanners and Cameras Pannello di controllo per i dispositivi (elementi radice) o la cartella My Computer.

Le estensioni del foglio di proprietà per fotocamere e scanner possono anche fornire un'interfaccia utente per sessioni di acquisizione di immagini specifiche, ovvero oggetti IWiaItem non radice (vedere la documentazione di Microsoft Windows SDK), attiva quando l'utente usa la finestra di dialogo di analisi predefinita. Queste estensioni vengono accessibili tramite un collegamento di proprietà avanzate o impostazioni avanzate nella finestra di dialogo di acquisizione immagini. Quando un'azione viene scelta dal menu di scelta rapida per una proprietà, WIA costruisce il foglio delle proprietà usando l'implementazione fornita dal fornitore dell'interfaccia IShellExtInit e IShellPropSheetExt (vedere la documentazione di Windows SDK).

Per le estensioni dell'interfaccia utente del menu di scelta rapida e del foglio di scelta rapida, l'interfaccia IDataObject (descritta nella documentazione di Windows SDK) che descrive gli elementi selezionati usa il formato WIAItemNames o il formato WIAItemPointer. Questi formati e i relativi nomi di formato sono definiti in wiadevd.h.

Il formato WIAItemNames, il cui nome di formato è CFSTR_WIAITEMNAMES, restituisce un valore HGLOBAL che punta a un elenco con terminazione doppia null degli identificatori IWiaItem . Ogni identificatore è del nome> del dispositivo del modulo<:>:<full path. Per gli elementi radice, la parte del nome del percorso completo è vuota.

Il formato WIAItemPointer è supportato nelle versioni di Microsoft Windows XP e versioni successive. Il nome del formato è CFSTR_WIAITEMPTR. Il formato WIAItemPointer restituisce una struttura STGMEDIUM (dichiarata nella documentazione di Windows SDK) il cui membro tymed è impostato su TYMED_ISTREAM. Questo formato può essere usato quando l'utente seleziona solo un singolo elemento. Il foglio delle proprietà o l'estensione del contesto possono chiamare CoUnmarshalInterface nell'oggetto IStream archiviato nella struttura STGMEDIUM per recuperare un'interfaccia IWiaItem . Vedere la documentazione di Windows SDK per le descrizioni della funzione CoUnmarshalInterface e le interfacce IStream e IWiaItem. Usando questo formato, ogni pagina del foglio delle proprietà può condividere un'interfaccia IWiaItem con marshalling corretto, importante durante le analisi.