System.Variants.VarArrayLock
Delphi
function VarArrayLock(const A: Variant): Pointer;
C++
extern DELPHI_PACKAGE void * __fastcall VarArrayLock(const System::Variant &A);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Variants.pas System.Variants.hpp |
System.Variants | System.Variants |
Description
Verrouille un tableau de variants et renvoie un pointeur sur les données.
VarArrayLock verrouille le tableau variant spécifié et renvoie un pointeur sur les données stockées dans ce tableau. Tant qu'un tableau de variants est verrouillé, il est impossible de le redimensionner et tout appel à la procédure VarArrayRedim échouera. Un tableau verrouillé peut être déverrouillé en utilisant VarArrayUnlock. Une exception EVariantInvalidArgError est déclenchée si le variant spécifié par A n'est pas un tableau.
Le pointeur renvoyé par VarArrayLock pointe sur un tableau d'éléments dans lequel la dimension qui augmente en premier est celle la plus à gauche. En d'autres termes, les dimensions du pointeur de tableau renvoyé sont inversées par rapport aux dimensions du tableau variant.
Après avoir vérifié qu'un tableau de variants possède les limites et les dimensions correctes, vous pouvez utiliser VarArrayLock pour accéder directement aux données du tableau, ce qui apporte également un gain de performances.