Método Wia.Create

O método Create do objeto Wia faz uma conexão com o dispositivo WIA (Aquisição de Imagem do Windows) especificado e retorna um objeto Item que representa o dispositivo.

Sintaxe

retVal = Wia.Create(
  Device
)

Parâmetros

Dispositivo [in]

Tipo: VARIANT*

Especifica o dispositivo WIA ao qual se conectar.

Valor retornado

Tipo: IWiaDispatchItem

Se tiver êxito, esse método retornará um objeto Item que representa um dispositivo de hardware WIA (um item raiz).

Comentários

O parâmetro Device especifica um objeto DeviceInfo passando o próprio objeto, seu índice de um objeto de coleção ou o valor de sua propriedade Id . Passe Nada para exibir uma caixa de diálogo que permite que um usuário selecione um dispositivo.

Exemplos

Os exemplos de VBScript a seguir demonstram o uso do método Create .

O primeiro exemplo passa um objeto DeviceInfo para o método Create . Observe que passar a propriedade de ID do objeto causa exatamente o mesmo comportamento.

<SCRIPT LANGUAGE="VBScript">
Dim objWia
Dim objDeviceInfoCollection
Dim objDeviceInfo
Dim objItem
 
Set objWIA = CreateObject("Wia.Script")
 
Set objDeviceInfoCollection = objWia.Devices
 
For Each objDeviceInfo In objDeviceInfoCollection
    Set objItem = objWia.Create(objDeviceInfo)
Next
</SCRIPT>

No próximo exemplo, o aplicativo de chamada passa o índice do objeto DeviceInfo na coleção para o método Create .

<SCRIPT LANGUAGE = "VBScript">
Dim objWia
Dim objDeviceInfoCollection
Dim objItem
 
Set objWia = CreateObject("Wia.Script")
 
Set objDeviceInfoCollection = objWia.Devices
 
For i = 0 To objDeviceInfoCollection.Count-1
    Set objItem = objWia.Create(i)
Next
</SCRIPT>

O exemplo a seguir passa Nothing para o método Create para exibir uma caixa de diálogo que permite que um usuário selecione um dispositivo.

<SCRIPT LANGUAGE = "VBScript">
Dim objWia
Dim objItem
 
Set objWia = objWia.Create(Nothing)
</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)