Compartilhar via

Método Item.GetItemsFromUI

  • Artigo

O método GetItemsFromUI do objeto Item exibe uma caixa de diálogo que permite que um usuário selecione imagens e áudio para transferir de um dispositivo.

Sintaxe

retVal = Item.GetItemsFromUI(
  Flags = 0,
  Intent = 0
)

Parâmetros

Sinalizadores [in]

Tipo: WiaFlag

acima (0)

Padrão. [in] Especifica o comportamento da caixa de diálogo. Os valores válidos para esse parâmetro são os mesmos do parâmetro lFlags do método DeviceDlg .

Intenção [in]

Tipo: WiaIntent

acima (0)

Padrão. [in] Especifica que tipo de dados a imagem se destina a representar. Para obter uma lista de valores de intenção de imagem, consulte Constantes de intenção de imagem.

Valor retornado

Tipo: ICollection

Esse método retorna uma coleção de objetos Item que representam os itens selecionados pelo usuário. Se nenhum item for selecionado, a coleção estará vazia.

Comentários

Para aplicativos do Microsoft Visual Basic, adicione uma referência à "Biblioteca de Tipos de Aquisição de Imagem do Windows 1.01".

Esse método se aplica somente a dispositivos (itens raiz). O método retorna uma coleção de objetos Item que representam as imagens ou clipes de áudio selecionados pelo usuário.

Se nenhum item for selecionado pelo usuário, o método retornará uma coleção vazia.

Exemplos

O exemplo a seguir demonstra o uso do método GetItemsFromUI para permitir que um usuário selecione imagens de uma caixa de diálogo.

<SCRIPT LANGUAGE="VBScript">
Dim objWia
Dim objDeviceInfoCollection
Dim objDeviceInfo
Dim objRootItem
Dim objSelectedItems
 
Set objWIA = CreateObject("Wia.Script")
 
Set objDeviceInfoCollection = objWia.Devices
 
For Each objDeviceInfo In objDeviceInfoCollection
    Set objRootItem = objWia.Create(objDeviceInfo)
    Set objSelectedItems = objRootItem.GetItemsFromUI(0, 0)
    ' Do something with selected items.
Next
</SCRIPT>

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]
DLL
Wiascr.dll (versão 4.90 ou posterior)