IScanProfile-Schnittstelle

Die IScanProfile-Schnittstelle stellt ein einzelnes Scanprofil dar und ermöglicht Anwendungen das Festlegen und Erhalten der Eigenschaften des Profils.

Members

Die IScanProfile-Schnittstelle erbt von der IDispatch-Schnittstelle. IScanProfile verfügt auch über diese Typen von Membern:

Methoden

Die IScanProfile-Schnittstelle verfügt über diese Methoden.

Methode BESCHREIBUNG
GetAllPropIDs Ruft alle verfügbaren Eigenschaften-IDs in einem Profil ab.
GetDeviceID Gibt die ID des Geräts zurück.
GetGUID Gibt die GUID des Profils zurück.
GetItem Ruft die GUID der Kategorie des WIA 2.0-Elements ab, dem das Profil zugeordnet ist.
GetName Ruft den Angezeigten Namen des Profils ab.
GetNumPropIDS Ruft die Anzahl der Eigenschaften-IDs in einem Profil ab.
GetProperty Ruft den Wert der angegebenen untergeordneten Eigenschaften im <Properties> -Element eines Scanprofils ab.
IsDefault Ruft einen Wert ab, der angibt, ob das Profil das Standardscanprofil eines zugeordneten IWiaItem2-Geräts ist.
RemoveProperty Entfernt eine angegebene Liste untergeordneter Eigenschaften im <Properties> -Element eines Scanprofils.
Speichern Speichert Änderungen an einem Profil auf dem Datenträger.
SetItem Legt die GUID der Kategorie des WIA 2.0-Elements fest, dem das Profil zugeordnet ist.
SetName Legt den Angezeigten Namen des Profils fest.
Setproperty Legt den Wert der angegebenen untergeordneten Eigenschaften im <Properties> -Element eines Scanprofils fest.

Bemerkungen

Jedes IWiaItem2-Gerät kann über ein Überprüfungsprofil verfügen. IWiaItem2-Elemente der Typen WIA _ CATEGORY FINISHED FILE und _ _ WIA CATEGORY ROOT können jedoch _ keine Profile _ haben.

Wenn ein Überprüfungsprofil mit der IScanProfile::Save-Methode gespeichert wird, wird es als XML-Datei unter %USERPROFILE% \ Application Data Microsoft Document Center \ \ \ UserScanProfiles gespeichert.

Verwenden Sie zum Erstellen einer Instanz eines IScanProfile-Objekts die IScanProfileMgr::CreateProfile-Methode. Verwenden Sie die IScanProfileMgr::OpenProfile-Methode, um einen Verweis auf ein Scanprofil zu erhalten, das bereits auf dem Datenträger gespeichert wurde.

Alle Scanprofile verfügen über die folgenden Elemente: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem> , und <Properties> . Das Standardprofil eines Geräts verfügt auch über ein <Default> -Element.

Die <ProfileGUID> Elemente und können nach dem Erstellen des <DeviceID> Profils nicht mehr geändert werden. Die Werte des Elements und des Elements können nach dem Erstellen <ProfileName> <WiaItem> des Profils geändert werden. Das <Default> Element kann hinzugefügt oder gelöscht werden. Dies kann programmgesteuert mit den Methoden IScanProfile::SetName, IScanProfile::SetItemund IScanProfileMgr::SetDefault erfolgen. Diese Eigenschaften können auch von Benutzern über die IScanProfileUI::ScanProfileDialog-Methode geändert werden.

Das <Properties> -Element enthält <Property> die unteren Elemente. Verwenden Sie diese, um dem Profil ein beliebiges WIA 2.0-Element oder eine Geräteeigenschaft hinzuzufügen. Sie können auch eigene bilderringtion children <Property> entwickeln. Dadurch ist das Scanprofilschema erweiterbar. (Weitere Informationen zum Erweitern des Schemas finden Sie unter Definierenvon benutzerdefinierten Eigenschaften, IScanProfile::GetPropertyund IScanProfile::SetProperty.)

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
IDL
Scanprofiles.idl

Weitere Informationen

IDispatch

Scan Profile Schema