System.Variants.VarArrayCreate
Delphi
function VarArrayCreate(const Bounds: array of Integer;
AVarType: TVarType): Variant;
C++
extern DELPHI_PACKAGE System::Variant __fastcall VarArrayCreate(const int *Bounds, const int Bounds_High, System::Word AVarType);
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.Variants.pas System.Variants.hpp |
System.Variants | System.Variants |
Beschreibung
Erstellt ein variantes Array.
VarArrayCreate erstellt ein variantes Array mit den in Bounds angegebenen Grenzen und dem in VarType angegebenen Elementtyp.
Der Parameter Bounds muss eine gerade Anzahl von Werten enthalten. Ein Paar gibt jeweils Ober- und Untergrenze einer Dimension im Array an.
Anmerkung: Der Parameter Bounds_size ist der Index des letzten Elements von Bounds. Der Wert ist um eins kleiner als die Gesamtzahl der Werte. Bounds_size muss daher immer eine ungerade Zahl sein.
Der Elementtyp des Arrays wird im Parameter VarType angegeben. Es handelt sich um einen Varianten-Typcode. Zulässig sind die in der Unit System definierten Konstanten. Die Bits varArray und varByRef dürfen nicht enthalten sein. Der Elementtyp darf nicht varString oder ein benutzerdefinierter Variant-Typ sein. Verwenden Sie für ein variantes String-Array den Typcode varOleStr. Ist der Elementtyp varVariant, sind die Elemente im Array ihrerseits Varianten, die wiederum variante Arrays enthalten können.
Wenn VarArrayCreate das Array nicht erstellen kann, wird eine EVariantArrayCreateError-Exception ausgelöst.
Anmerkung: Variante Arrays mit dem Elementtyp varByte stellen die bevorzugte Methode für den Transfer von Binärdaten zwischen OLE-Automatisierungs-Controllern und Servern dar. Da die Daten derartiger Arrays nicht übersetzt werden, können Sie mit den Routinen VarArrayLock und VarArrayUnlock effizient darauf zugreifen.