Interface IScanProfile
L’interface IScanProfile représente un profil d’analyse unique et permet aux applications de définir et d’obtenir les propriétés du profil.
Membres
L’interface IScanProfile hérite de l’interface IDispatch. IScanProfile a également les types de membres suivants :
Méthodes
L’interface IScanProfile utilise ces méthodes.
| Méthode | Description |
|---|---|
| GetAllPropIDs | Obtient tous les ID de propriété disponibles dans un profil. |
| GetDeviceID | Retourne l’ID de l’appareil. |
| GetGUID | Retourne le GUID du profil. |
| GetItem | Obtient le GUID de la catégorie de l’élément WIA 2.0 auquel le profil est associé. |
| GetName | Obtient le nom convivial du profil. |
| GetNumPropIDS | Obtient le nombre d’ID de propriété dans un profil. |
| Getproperty | Obtient la valeur des propriétés enfants spécifiées dans l’élément <Properties> d’un profil d’analyse. |
| IsDefault | Obtient une valeur qui indique si le profil est le profil d’analyse par défaut d’un appareil IWiaItem2 associé. |
| RemoveProperty | Supprime une liste spécifiée de propriétés enfants dans l’élément <Properties> d’un profil d’analyse. |
| Enregistrer | Enregistre les modifications apportées à un profil sur le disque. |
| SetItem | Définit le GUID de la catégorie d’élément WIA 2.0 auquel le profil est associé. |
| SetName | Définit le nom convivial du profil. |
| setProperty | Définit la valeur des propriétés enfants spécifiées dans l’élément <Properties> d’un profil d’analyse. |
Notes
Tout appareil IWiaItem2 peut avoir un profil d’analyse. Toutefois, les éléments IWiaItem2 de types WIA_CATEGORY_FINISHED_FILE et WIA_CATEGORY_ROOT ne peuvent pas avoir de profils.
Si un profil d’analyse est enregistré à l’aide de la méthode IScanProfile::Save , il est stocké en tant que fichier XML dans %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles.
Pour créer une instance d’un objet IScanProfile, utilisez la méthode IScanProfileMgr::CreateProfile. Pour obtenir une référence à un profil d’analyse qui a déjà été enregistré sur le disque, utilisez la méthode IScanProfileMgr::OpenProfile .
Tous les profils d’analyse ont les éléments suivants : <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>, et <Properties>. Le profil par défaut d’un appareil a également un <Default> élément .
Les <ProfileGUID> éléments et <DeviceID> ne peuvent pas être modifiés après la création du profil. Les valeurs de l’élément <ProfileName> et de l’élément <WiaItem> peuvent être modifiées après la création du profil. L’élément <Default> peut être ajouté ou supprimé. Cela peut être effectué par programmation avec les méthodes IScanProfile::SetName, IScanProfile::SetItem et IScanProfileMgr::SetDefault . Ces propriétés peuvent également être modifiées par les utilisateurs via la méthode IScanProfileUI::ScanProfileDialog .
L’élément <Properties> contient des <Property> enfants. Utilisez-les pour ajouter un élément ou une propriété d’appareil WIA 2.0 au profil. Vous pouvez également développer vos propres enfants d’acquisition d’image <Property> . Cela rend le schéma de profil d’analyse extensible. (Pour plus d’informations sur l’extension du schéma, consultez Définition de propriétés personnalisées, IScanProfile::GetProperty et IScanProfile::SetProperty.)
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
| IDL |
|
Voir aussi