Interface IScanProfile
A interface IScanProfile representa um único perfil de verificação e permite que os aplicativos definam e obtenham as propriedades do perfil.
Membros
A interface IScanProfile herda da interface IDispatch . O IScanProfile também tem esses tipos de membros:
Métodos
A interface IScanProfile tem esses métodos.
| Método | Descrição |
|---|---|
| GetAllPropIDs | Obtém todas as IDs de propriedade disponíveis em um perfil. |
| GetDeviceID | Retorna a ID do dispositivo. |
| GetGUID | Retorna o GUID do perfil. |
| Getitem | Obtém o GUID da categoria do item WIA 2.0 ao qual o perfil está associado. |
| GetName | Obtém o nome amigável do perfil. |
| GetNumPropIDS | Obtém o número de IDs de propriedade em um perfil. |
| GetProperty | Obtém o valor das propriedades filho especificadas no <Properties> elemento de um perfil de verificação. |
| IsDefault | Obtém um valor que indica se o perfil é o perfil de verificação padrão de um dispositivo IWiaItem2 associado. |
| RemoveProperty | Remove uma lista especificada de propriedades filho no <Properties> elemento de um perfil de verificação. |
| Salvar | Salva alterações em um perfil em disco. |
| Setitem | Define o GUID da categoria do item WIA 2.0 ao qual o perfil está associado. |
| Setname | Define o nome amigável do perfil. |
| SetProperty | Define o valor das propriedades filho especificadas no <Properties> elemento de um perfil de verificação. |
Comentários
Qualquer dispositivo IWiaItem2 pode ter um perfil de verificação. No entanto, itens IWiaItem2 de tipos WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_ROOT não podem ter perfis.
Se um perfil de verificação for salvo usando o método IScanProfile::Save , ele será armazenado como um arquivo XML em %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles.
Para criar uma instância de um objeto IScanProfile , use o método IScanProfileMgr::CreateProfile . Para obter uma referência a um perfil de verificação que já foi salvo em disco, use o método IScanProfileMgr::OpenProfile .
Todos os perfis de verificação têm os seguintes elementos: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>e <Properties>. O perfil padrão de um dispositivo também tem um <Default> elemento .
Os <ProfileGUID> elementos e <DeviceID> não podem ser alterados após a criação do perfil. Os valores do <ProfileName> elemento e do <WiaItem> elemento podem ser alterados após a criação do perfil. O <Default> elemento pode ser adicionado ou excluído. Isso pode ser feito programaticamente com os métodos IScanProfile::SetName, IScanProfile::SetItem e IScanProfileMgr::SetDefault . Essas propriedades também podem ser alteradas pelos usuários por meio do método IScanProfileUI::ScanProfileDialog .
O <Properties> elemento contém <Property> filhos. Use-os para adicionar qualquer item ou propriedade de dispositivo WIA 2.0 ao perfil. Você também pode desenvolver seus próprios filhos de acquistão de <Property> imagem. Isso torna o Esquema de Perfil de Verificação extensível. (Para obter mais informações sobre como estender o esquema, consulte Definindo propriedades personalizadas, IScanProfile::GetProperty e IScanProfile::SetProperty.)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| IDL |
|
Confira também