Extensions de feuille de propriétés
L’élément de menu contextuel Propriétés permet d’accéder aux feuilles de propriétés du scanneur ou de l’appareil photo dans le dossier Scanneurs et caméras Panneau de configuration pour les appareils (éléments racine) ou dans le dossier Poste de travail.
Les extensions de feuille de propriétés pour les caméras et les scanneurs peuvent également fournir une interface utilisateur pour des sessions d’acquisition d’images spécifiques, c’est-à-dire des objets IWiaItem non racines (voir la documentation Microsoft Windows SDK), qui sont actifs lorsque l’utilisateur utilise la boîte de dialogue d’analyse par défaut. Ces extensions sont accessibles via un lien de propriétés avancées ou de paramètres avancés dans la boîte de dialogue d’acquisition d’image. Lorsqu’une action est choisie dans le menu contextuel d’une propriété, WIA construit la feuille de propriétés à l’aide de l’implémentation fournie par le fournisseur des interfaces IShellExtInit et IShellPropSheetExt (voir la documentation du Kit de développement logiciel (SDK) Windows.
Pour les extensions d’interface utilisateur de la feuille de propriétés et du menu contextuel, l’interface IDataObject (décrite dans la documentation du Kit de développement logiciel (SDK) Windows) décrivant les éléments sélectionnés utilise soit le format WIAItemNames, soit le format WIAItemPointer. Ces formats et leurs noms de format sont définis dans wiadevd.h.
Le format WIAItemNames, dont le nom de format est CFSTR_WIAITEMNAMES, retourne un HGLOBAL pointant vers une liste à double null d’identificateurs IWiaItem . Chaque identificateur est de la forme <id>::<nom> du chemin d’accès complet de l’appareil. Pour les éléments racines, la partie du nom de chemin d’accès complet est vide.
Le format WIAItemPointer est pris en charge dans les versions de Microsoft Windows XP et versions ultérieures. Le nom du format est CFSTR_WIAITEMPTR. Le format WIAItemPointer renvoie une structure STGMEDIUM (déclarée dans la documentation du SDK Windows) dont le membre lié est défini sur TYMED_ISTREAM. Ce format peut être utilisé lorsque l’utilisateur sélectionne un seul élément. La feuille de propriétés ou l’extension de contexte peut appeler CoUnmarshalInterface sur l’objet IStream stocké dans la structure STGMEDIUM pour récupérer une interface IWiaItem . (Consultez la documentation du Kit de développement logiciel (SDK) Windows pour obtenir des descriptions de la fonction CoUnmarshalInterface et des interfaces IStream et IWiaItem .) À l’aide de ce format, chaque page de la feuille de propriétés peut partager une interface IWiaItem correctement marshalée, ce qui est important pendant les analyses.