System.VarConv.VarConvertCreate
Delphi
function VarConvertCreate(const AValue: Double; const AType: TConvType): Variant;
function VarConvertCreate(const AValue: string): Variant;
C++
extern DELPHI_PACKAGE System::Variant __fastcall VarConvertCreate(const double AValue, const System::Convutils::TConvType AType)/* overload */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.VarConv.pas System.VarConv.hpp |
System.VarConv | System.VarConv |
Beschreibung
Gibt eine benutzerdefinierte Variante zurück, die eine Maßangabe repräsentiert.
Mit VarConvertCreate können Sie eine Variante erstellen, deren Wert eine Maßangabe ist.
In der ersten Syntax bezeichnet AType die Einheiten und AValue deren Anzahl. AType muss eine registrierte Umwandlungseinheit sein.
In der zweiten Syntax ist AValue ein String, der von der Funktion TryStrToConvUnit zerlegt werden kann (z.B. "1,5 Liter").
Kann der String nicht zerlegt werden, löst VarConvertCreate eine EInvalidCast-Exception aus.
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.