VarArrayCreate

Crea una matriz de variantes.

Estructura

VarArrayCreate(const Bounds: matriz de enteros; VarType: entero): Variant;

Parámetros

Valor devuelto

Descripción

VarArrayCreate crea una matriz de tipos Variant con los límites especificados en Bounds y el tipo de elemento especificado en VarType.

El parámetro «Bounds» debe contener un número par de valores, de modo que cada par de valores especifique los límites superior e inferior de una dimensión de la matriz.

El tipo de elemento de la matriz, especificado por el parámetro VarType, debe ser uno de los códigos de tipo TVarData y no puede incluir los bits varArray ni varByRef. El tipo de elemento no puede ser varString. Para crear una matriz de cadenas de tipo Variant, utiliza el código de tipo varOleStr. Si el tipo del elemento es varVariant, los elementos de la matriz son a su vez objetos Variant y, a su vez, pueden contener matrices de objetos Variant.

Nota

Las matrices de variantes con un tipo de elemento varByte son el método preferido para transmitir datos binarios entre controladores y servidores de OLE Automation. Estos conjuntos no están sujetos a ninguna conversión de datos, y se puede acceder a ellos de forma eficiente mediante las rutinas VarArrayLock y VarArrayUnlock.

VarType tiene los siguientes códigos:

0: varEmpty: una variante sin asignar

1: varNull: una variante nula

2: varSmallint: un entero con signo de 16 bits

3: varInteger: un entero con signo de 32 bits

4: varSingle: un valor de punto flotante de precisión simple

5: varDouble: un valor de punto flotante de doble precisión

6: varCurrency: un valor de punto flotante de tipo moneda

7: varDate: un valor de fecha/hora

8: varOLEStr: una referencia a una cadena Unicode

9: varDispatch: una referencia a un objeto de automatización

10: varError: un código de error del sistema operativo

11: varBoolean: un valor booleano

12: varVariant: una variante de 16 bytes

12: varUnknown: una referencia a un objeto COM desconocido

17: varByte: un entero sin signo de 8 bits

72: varStrArg

256: varString: una referencia a una cadena ANSI

257: varAny: un puntero, utilizado para pasar a funciones Corba

4095: varTypeMask: una máscara de bits para extraer códigos de tipo de variantes

8192: varArray: bit que indica una matriz de variantes

16384: varByRef: bit que indica que la variante contiene una referencia, no un valor |