IScanProfile-Schnittstelle
Die IScanProfile-Schnittstelle stellt ein einzelnes Scanprofil dar und ermöglicht es Anwendungen, die Eigenschaften des Profils festzulegen und abzurufen.
Member
Die IScanProfile-Schnittstelle erbt von der IDispatch-Schnittstelle . IScanProfile verfügt auch über die folgenden Membertypen:
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 Anzeigenamen 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 der untergeordneten 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 Anzeigenamen 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 Scanprofil verfügen. IWiaItem2-Elemente von Typen WIA_CATEGORY_FINISHED_FILE und WIA_CATEGORY_ROOT können jedoch keine Profile aufweisen.
Wenn ein Scanprofil mithilfe der IScanProfile::Save-Methode gespeichert wird, wird es als XML-Datei unter %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles gespeichert.
Um eine instance eines IScanProfile-Objekts zu erstellen, verwenden Sie die IScanProfileMgr::CreateProfile-Methode. Verwenden Sie die IScanProfileMgr::OpenProfile-Methode , um einen Verweis auf ein Scanprofil abzurufen, das bereits auf dem Datenträger gespeichert wurde.
Alle Überprüfungsprofile 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 <DeviceID> können nicht geändert werden, nachdem das Profil erstellt wurde. Die Werte des <ProfileName> Elements und des <WiaItem> Elements können geändert werden, nachdem das Profil erstellt wurde. Das <Default> Element kann hinzugefügt oder gelöscht werden. Dies kann programmgesteuert mit den Methoden IScanProfile::SetName, IScanProfile::SetItem und IScanProfileMgr::SetDefault erfolgen. Diese Eigenschaften können auch von Benutzern über die IScanProfileUI::ScanProfileDialog-Methode geändert werden.
Das <Properties> Element enthält <Property> untergeordnete Elemente. Verwenden Sie diese, um dem Profil beliebige WIA 2.0-Elemente oder -Geräteeigenschaften hinzuzufügen. Sie können auch Ihre eigenen Image-Übernahmekinder <Property> entwickeln. Dadurch ist das Scanprofilschema erweiterbar. (Weitere Informationen zum Erweitern des Schemas finden Sie unter Definieren benutzerdefinierter Eigenschaften, IScanProfile::GetProperty und IScanProfile::SetProperty.)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| IDL |
|
Siehe auch