System.VarConv.VarAsConvert

Übergeordnet: System.VarConv

Delphi

function VarAsConvert(const AValue: Variant): Variant; overload;
function VarAsConvert(const AValue: Variant; const AType: TConvType): Variant;

C++

extern DELPHI_PACKAGE System::Variant __fastcall VarAsConvert(const System::Variant &AValue)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.VarConv.pas System.VarConv.hpp	System.VarConv	System.VarConv

Beschreibung

Wandelt eine beliebige Variante in eine benutzerdefinierte Variante um, die eine Maßangabe repräsentiert.

VarAsConvert wandelt die in AValue angegebene Variante in eine benutzerdefinierte VarConvert-Variante um.

In der ersten Syntax wird AValue als numerischer Anteil (Anzahl der Einheiten) interpretiert, während AType die Art der Einheiten bezeichnet.

In der zweiten Syntax sollte AValue eine Variante sein, die in eine benutzerdefinierte VarConv-Variante zerlegt werden kann (z.B. eine Variante mit dem String-Wert "1,5 Kilometer").

Wenn VarAsConvert die Umwandlung nicht durchführen kann, wird eine EInvalidCast-Exception ausgelöst.

Benutzerdefinierte VarConvert-Varianten stellen Maßangaben dar (d.h. Einheiten und deren Anzahl). Die Einheiten müssen registriert sein (wie z.B. die Einheiten, die in der Unit ConvUtils deklariert sind). VarConv-Varianten unterstützen den Negationsoperator. VarConv-Varianten mit reellen Zahlen erlauben die Verwendung von Additions-, Subtraktions-, Multiplikations-, Divisions- und Vergleichsoperatoren. Additions-, Subtraktions-, Divisions- und Vergleichsoperatoren können auch auf zwei VarConv-Varianten angewendet werden.

Benutzerdefinierte VarConv-Varianten unterstützen außerdem die folgenden Eigenschaften:

Value ist der numerische Anteil (die Anzahl der Einheiten). (Lesen/Schreiben)
Type ist der Typ der Einheiten. (Nur Lesen)
TypeName ist der Name der Einheiten. (Nur Lesen)
Family ist die Umwandlungsfamilie der Einheiten. (Nur Lesen)
FamilyName ist der Name der Umwandlungsfamilie. (Nur Lesen)

Abhängig von Family verfügt jede Variante über eine Reihe von Umwandlungseigenschaften, deren Namen die Form As<Einheit> haben, wobei <Einheit> der Name einer anderen Einheit in derselben Umwandlungsfamilie ist.