Interfaccia IScanProfile
L'interfaccia IScanProfile rappresenta un singolo profilo di analisi e consente alle applicazioni di impostare e ottenere le proprietà del profilo.
Membri
L'interfaccia IScanProfile eredita dall'interfaccia IDispatch . IScanProfile include anche questi tipi di membri:
Metodi
L'interfaccia IScanProfile include questi metodi.
| Metodo | Descrizione |
|---|---|
| GetAllPropIDs | Ottiene tutti gli ID delle proprietà disponibili in un profilo. |
| GetDeviceID | Restituisce l'ID del dispositivo. |
| GetGUID | Restituisce il GUID del profilo. |
| GetItem | Ottiene il GUID della categoria dell'elemento WIA 2.0 associato al profilo. |
| GetName | Ottiene il nome descrittivo del profilo. |
| GetNumPropIDS | Ottiene il numero di ID proprietà in un profilo. |
| Getproperty | Ottiene il valore delle proprietà figlio specificate nell'elemento <Properties> di un profilo di analisi. |
| IsDefault | Ottiene un valore che indica se il profilo è il profilo di analisi predefinito di un dispositivo IWiaItem2 associato. |
| RemoveProperty | Rimuove un elenco specificato di proprietà figlio nell'elemento <Properties> di un profilo di analisi. |
| Salva | Salva le modifiche a un profilo su disco. |
| SetItem | Imposta il GUID della categoria dell'elemento WIA 2.0 associato al profilo. |
| SetName | Imposta il nome descrittivo del profilo. |
| SetProperty | Imposta il valore delle proprietà figlio specificate nell'elemento <Properties> di un profilo di analisi. |
Commenti
Qualsiasi dispositivo IWiaItem2 può avere un profilo di analisi. Tuttavia, gli elementi IWiaItem2 di tipi WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_ROOT non possono avere profili.
Se un profilo di analisi viene salvato usando il metodo IScanProfile::Save , viene archiviato come file XML in %USERPROFILE%\Dati applicazione\Microsoft\Document Center\UserScanProfiles.
Per creare un'istanza di un oggetto IScanProfile , usare il metodo IScanProfileMgr::CreateProfile . Per ottenere un riferimento a un profilo di analisi già salvato su disco, usare il metodo IScanProfileMgr::OpenProfile .
Tutti i profili di analisi hanno gli elementi seguenti: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>e <Properties>. Il profilo predefinito di un dispositivo ha anche un <Default> elemento.
Non è possibile modificare gli <ProfileGUID> elementi e <DeviceID> dopo la creazione del profilo. I valori dell'elemento e l'elemento <ProfileName><WiaItem> possono essere modificati dopo la creazione del profilo. L'elemento <Default> può essere aggiunto o eliminato. Questa operazione può essere eseguita programmatamente con i metodi IScanProfile::SetName, IScanProfile::SetItem e IScanProfileMgr::SetDefault. Queste proprietà possono essere modificate anche dagli utenti tramite il metodo IScanProfileUI::ScanProfileDialog .
L'elemento <Properties> contiene <Property> elementi figlio. Usare queste proprietà per aggiungere qualsiasi elemento o proprietà del dispositivo WIA 2.0 al profilo. Puoi anche sviluppare i tuoi figli di acquistion <Property> di immagini. Ciò rende estendibile lo schema del profilo di analisi. Per altre informazioni sull'estensione dello schema, vedere Definizione di proprietà personalizzate, IScanProfile::GetProperty e IScanProfile::SetProperty.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| IDL |
|
Vedi anche