System.VarConv.VarAsConvert
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 */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.VarConv.pas System.VarConv.hpp |
System.VarConv | System.VarConv |
Description
Transtype un variant quelconque en un variant personnalisé représentant une mesure.
La fonction VarAsConvert convertit le variant spécifié par AValue en un variant VarConvert personnalisé.
Dans la première syntaxe, AValue est interprété comme la partie numérique (le nombre d'unités) et AType identifie les unités.
Dans la seconde syntaxe, AValue doit être un variant qui peut être converti en un variant VarConv personnalisé (par exemple, un variant dont la valeur est une chaîne telle que '1.5 miles').
Si la fonction VarAsConvert ne peut pas effectuer la conversion, elle déclenche une exception EInvalidCast.
Les variants VarConvert personnalisés représentent des mesures (c'est-à-dire un type d'unités de mesure et le nombre de ces unités). Les unités doivent être des unités de mesure recensées, comme celles utilisées par l'unité ConvUtils. Vous pouvez utiliser l'opérateur de négation sur des variants VarConv, ainsi que l'addition, la soustraction, la multiplication, la division et les opérateurs de comparaison entre un variant VarConv et un nombre réel. Vous pouvez utiliser l'addition, la soustraction, la division et les opérateurs de comparaison entre deux variants VarConv.
Les variants VarConv personnalisés supportent également les propriétés suivantes :
- Value est la partie numérique (le nombre d'unités). (lecture-écriture)
- Type représente les unités. (lecture seule)
- TypeName est le nom des unités. (lecture seule)
- Family est la famille de conversion des unités (la chose mesurée). (lecture seule)
- FamilyName est le nom de la famille de conversion. (lecture seule)
Selon la famille, chaque variant a un ensemble de propriétés de conversion avec des noms de la forme As<Unité>, où <Unité> est le nom d'un autre type d'unité de la même famille de conversion.