VarArrayCreate

Cria uma matriz de variantes.

Estrutura

VarArrayCreate(const Bounds: matriz de inteiros; VarType: inteiro): Variant;

Parâmetros

Valor de retorno

Descrição

A função VarArrayCreate cria uma matriz de Variant com os limites especificados por Bounds e o tipo de elemento especificado por VarType.

O parâmetro «Bounds» deve conter um número par de valores, sendo que cada par de valores especifica os limites superior e inferior de uma dimensão da matriz.

O tipo de elemento da matriz, definido pelo parâmetro VarType, deve ser um dos códigos de tipo TVarData e não pode incluir os bits varArray ou varByRef. O tipo do elemento não pode ser varString. Para criar uma matriz de cadeias de caracteres do tipo Variant, utilize o código do tipo varOleStr. Se o tipo do elemento for varVariant, os elementos da matriz são, por sua vez, Variants e podem, por sua vez, conter matrizes de Variants.

Nota

As matrizes de variantes com o tipo de elemento varByte são o método preferido para a transmissão de dados binários entre controladores e servidores de OLE Automation. Essas matrizes não estão sujeitas a qualquer conversão dos seus dados e podem ser acedidas de forma eficiente através das rotinas VarArrayLock e VarArrayUnlock.

O VarType tem os seguintes códigos:

0: varEmpty: uma variante não atribuída

1: varNull: uma variante nula

2: varSmallint: um inteiro assinado de 16 bits

3: varInteger: um inteiro assinado de 32 bits

4: varSingle: um valor de ponto flutuante de precisão simples

5: varDouble: um valor de ponto flutuante de precisão dupla

6: varCurrency: um valor de ponto flutuante de moeda

7: varDate: um valor de data/hora

8: varOLEStr: uma referência a uma cadeia Unicode

9: varDispatch: uma referência a um objeto Automation

10: varError: um código de erro do sistema operativo

11: varBoolean: um valor booleano

12: varVariant: uma variante de 16 bytes

12: varUnknown: uma referência a um objeto COM desconhecido

17: varByte: um inteiro sem sinal de 8 bits

72: varStrArg

256: varString: uma referência a uma cadeia ANSI

257: varAny: um ponteiro, utilizado para passar para funções Corba

4095: varTypeMask: uma máscara de bits para extrair códigos de tipo de variantes

8192: varArray: bit que indica uma matriz de variantes

16384: varByRef: bit que indica que a variante contém uma referência, não um valor |