Compartilhar via

Método IWiaItem::D eviceDlg (wia_xp.h)

  • Artigo

O método IWiaItem::D eviceDlg é usado por aplicativos para exibir uma caixa de diálogo para o usuário se preparar para a aquisição de imagens.

Sintaxe

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

Parâmetros

[in] hwndParent

Digite: HWND

Identificador da janela pai da caixa de diálogo.

[in] lFlags

Tipo: LONG

Especifica um conjunto de sinalizadores que controlam a operação da caixa de diálogo. Pode ser definido como qualquer um dos seguintes valores:

Sinalizador Significado
0 Comportamento padrão.
WIA_DEVICE_DIALOG_SINGLE_IMAGE Restrinja a seleção de imagem a uma única imagem na caixa de diálogo de aquisição de imagem do dispositivo.
WIA_DEVICE_DIALOG_USE_COMMON_UI Use a interface do usuário do sistema, se disponível, em vez da interface do usuário fornecida pelo fornecedor. Se a interface do usuário do sistema não estiver disponível, a interface do usuário do fornecedor será usada. Se nenhuma interface do usuário estiver disponível, a função retornará E_NOTIMPL.

[in] lIntent

Tipo: LONG

Especifica que tipo de dados a imagem deve representar. Para obter uma lista de valores de intenção de imagem, consulte Constantes de intenção de imagem.

Nota Esse método ignora todas as intenções de imagem WIA_INTENT_IMAGE_*.
 

[out] plItemCount

Tipo: LONG*

Recebe o número de itens na matriz indicada pelo parâmetro ppIWiaItem .

[out] ppIWiaItem

Tipo: IWiaItem***

Recebe o endereço de uma matriz de ponteiros para interfaces IWiaItem .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método exibe uma caixa de diálogo para o usuário que um aplicativo usa para coletar todas as informações necessárias para a aquisição de imagens. Por exemplo, essa caixa de diálogo permite que o usuário selecione imagens para baixar de uma câmera. Ao usar um scanner, ele também é usado para especificar propriedades de verificação de imagem, como brilho e contraste.

Depois que esse método retornar, o aplicativo poderá usar a interface IWiaDataTransfer para adquirir a imagem.

Os aplicativos devem chamar o método IUnknown::Release para cada elemento na matriz de ponteiros de interface que recebem por meio do parâmetro ppIWiaItem . Os aplicativos também devem liberar a matriz usando CoTaskMemFree.

É recomendável que os aplicativos disponibilizem a seleção de dispositivo e imagem por meio de um item de menu chamado De scanner ou câmera no menu Arquivo .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib
DLL Wiaservc.dll