VarArrayCreate

Crée un tableau de types Variant.

Structure

VarArrayCreate(const Bounds : tableau d'entiers ; VarType : entier) : Variant ;

Paramètres

Valeur de retour

Description

La fonction VarArrayCreate crée un tableau de types Variant dont les limites sont définies par Bounds et dont le type des éléments est défini par VarType.

Le paramètre « Bounds » doit contenir un nombre pair de valeurs, chaque paire de valeurs définissant les limites supérieure et inférieure d'une dimension du tableau.

Le type d'élément du tableau, défini par le paramètre VarType, doit correspondre à l'un des codes de type TVarData et ne peut pas inclure les bits varArray ou varByRef. Le type d'élément ne peut pas être varString. Pour créer un tableau de chaînes de caractères de type Variant, utilisez le code de type varOleStr. Si le type de l'élément est varVariant, les éléments du tableau sont eux-mêmes des Variants et peuvent à leur tour contenir des tableaux de Variants.

Remarque

Les tableaux de type « varByte » constituent la méthode privilégiée pour transmettre des données binaires entre les contrôleurs et les serveurs OLE Automation. Ces tableaux ne subissent aucune conversion de leurs données et sont accessibles de manière efficace à l'aide des routines VarArrayLock et VarArrayUnlock.

VarType comporte les codes suivants :

0 : varEmpty : une variante non affectée

1 : varNull : une variante nulle

2 : varSmallint : un entier signé de 16 bits

3 : varInteger : un entier signé de 32 bits

4 : varSingle : une valeur à virgule flottante simple précision

5 : varDouble : une valeur à virgule flottante double précision

6 : varCurrency : une valeur à virgule flottante de type monétaire

7 : varDate : une valeur de date/heure

8 : varOLEStr : une référence à une chaîne Unicode

9 : varDispatch : une référence à un objet Automation

10 : varError : un code d'erreur du système d'exploitation

11 : varBoolean : une valeur booléenne

12 : varVariant : un variant de 16 octets

12 : varUnknown : une référence à un objet COM inconnu

17 : varByte : un entier non signé de 8 bits

72 : varStrArg

256 : varString : une référence à une chaîne ANSI

257 : varAny : un pointeur, utilisé pour passer des paramètres aux fonctions Corba

4095 : varTypeMask : un masque de bits permettant d'extraire les codes de type des variants

8192 : varArray : bit indiquant un tableau de variants

16384 : varByRef : bit indiquant que la variante contient une référence, et non une valeur |