VarArrayCreate

Erstellt ein Variant-Array.

Aufbau

VarArrayCreate(const Bounds: Array von Integer; VarType: Integer): Variant;

Parameter

Rückgabewert

Beschreibung

VarArrayCreate erstellt ein Variant-Array mit den durch Bounds angegebenen Grenzen und dem durch VarType angegebenen Elementtyp.

Der Parameter „Bounds“ muss eine gerade Anzahl von Werten enthalten, wobei jedes Wertepaar die obere und untere Grenze einer Dimension des Arrays angibt.

Der Elementtyp des Arrays, der durch den Parameter „VarType“ angegeben wird, muss einer der TVarData-Typcodes sein und darf nicht die Bits „varArray“ oder „varByRef“ enthalten. Der Elementtyp darf nicht „varString“ sein. Um ein Variant-Array aus Zeichenfolgen zu erstellen, verwenden Sie den Code vom Typ varOleStr. Wenn der Elementtyp „varVariant“ ist, sind die Elemente des Arrays selbst Varianten und können ihrerseits wiederum Variant-Arrays enthalten.

Hinweis

Varianten-Arrays mit dem Elementtyp „varByte“ sind die bevorzugte Methode zur Übertragung von Binärdaten zwischen OLE-Automation-Controllern und -Servern. Bei solchen Arrays findet keine Übersetzung der Daten statt, und der Zugriff darauf ist mithilfe der Routinen VarArrayLock und VarArrayUnlock effizient möglich.

VarType verfügt über die folgenden Codes:

0: varEmpty: eine nicht zugewiesene Variante

1: varNull: eine Null-Variante

2: varSmallint: eine vorzeichenbehaftete 16-Bit-Ganzzahl

3: varInteger: eine vorzeichenbehaftete 32-Bit-Ganzzahl

4: varSingle: ein Gleitkommawert einfacher Genauigkeit

5: varDouble: ein Gleitkommawert doppelter Genauigkeit

6: varCurrency: ein Gleitkommawert für Währungsdaten

7: varDate: ein Datums-/Zeitwert

8: varOLEStr: eine Referenz auf eine Unicode-Zeichenkette

9: varDispatch: eine Referenz auf ein Automation-Objekt

10: varError: ein Betriebssystem-Fehlercode

11: varBoolean: ein Boolescher Wert

12: varVariant: eine 16-Byte-Variant

12: varUnknown: eine Referenz auf ein unbekanntes COM-Objekt

17: varByte: eine 8-Bit-Ganzzahl ohne Vorzeichen

72: varStrArg

256: varString: eine Referenz auf eine ANSI-Zeichenkette

257: varAny: ein Zeiger, der zur Übergabe an Corba-Funktionen verwendet wird

4095: varTypeMask: eine Bitmaske zum Extrahieren von Typcodes aus Varianten

8192: varArray: Bit, das ein Varianten-Array anzeigt

16384: varByRef: Bit, das angibt, dass die Variante eine Referenz und keinen Wert enthält |