Erweiterungen des Eigenschaftenblatts

Das Kontextmenüelement "Eigenschaften" bietet Zugriff auf Eigenschaftsblätter von Scannern oder Kameras in der Systemsteuerung "Scanner und Kameras" für Geräte (Stammelemente) oder im Arbeitsplatz-Ordner.

Erweiterungen von Eigenschaftsblättern für Kameras und Scanner können auch eine Benutzeroberfläche für bestimmte Bilderfassungssitzungen bereitstellen, das heißt, nicht-root-IWiaItem-Objekte (siehe die Microsoft Windows SDK-Dokumentation), die aktiv sind, wenn der Benutzer den Standard-Scandialog verwendet. Auf diese Erweiterungen wird über einen Link zu erweiterten Eigenschaften oder erweiterten Einstellungen im Dialogfeld "Bilderfassung" zugegriffen. Wenn eine Aktion aus dem Kontextmenü für eine Eigenschaft ausgewählt wird, erstellt WIA das Eigenschaftenblatt mithilfe der vom Anbieter bereitgestellten Implementierung der IShellExtInit - und IShellPropSheetExt-Schnittstellen (siehe Windows SDK-Dokumentation).

Für Eigenschaftenblatt- und Kontextmenü-UI-Erweiterungen verwendet die IDataObject-Schnittstelle (die in der Windows SDK-Dokumentation beschrieben wird), die die ausgewählten Elemente beschreibt, entweder das WIAItemNames-Format oder das WIAItemPointer-Format. Diese Formate und deren Formatnamen werden in wiadevd.h definiert.

Das WIAItemNames-Format, dessen Formatname CFSTR_WIAITEMNAMES ist, gibt einen HGLOBAL-Wert zurück, der auf eine doppelt-nullterminierte Liste von IWiaItem-Bezeichnern verweist. Jeder Bezeichner hat das Format <Geräte-ID>::<vollständiger Pfadname>. Bei Stammelementen ist der vollständige Pfadnamenteil leer.

Das WIAItemPointer-Format wird in Versionen von Microsoft Windows XP und höher unterstützt. Der Formatname ist CFSTR_WIAITEMPTR. Das WIAItemPointer-Format gibt eine STGMEDIUM-Struktur (deklariert in der Windows SDK-Dokumentation) zurück, deren Tymed-Element auf TYMED_ISTREAM festgelegt ist. Dieses Format kann verwendet werden, wenn der Benutzer nur ein einzelnes Element auswählt. Das Eigenschaftenblatt oder die Kontexterweiterung kann CoUnmarshalInterface für das in der STGMEDIUM-Struktur gespeicherte IStream-Objekt aufrufen, um eine IWiaItem-Schnittstelle abzurufen. (In der Windows SDK-Dokumentation finden Sie Beschreibungen der CoUnmarshalInterface-Funktion und der IStream - und IWiaItem-Schnittstellen .) Mit diesem Format kann jede Seite auf dem Eigenschaftenblatt eine ordnungsgemäß gemarstische IWiaItem-Schnittstelle freigeben, die bei Scans wichtig ist.