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 |
|