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 */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.VarConv.pas System.VarConv.hpp |
System.VarConv | System.VarConv |
Description
Renvoie un variant personnalisé qui représente une mesure.
Appelez VarConvertCreate pour créer un variant dont la valeur est une mesure.
Dans la première syntaxe, AType indique les unités de mesure et AValue est le nombre de ces unités. AType doit représenter une unité de conversion recensée.
Dans la seconde syntaxe, AValue est une chaîne qui peut être convertie par la fonction TryStrToConvUnit. Par exemple, '1.5 litres'.
Si l'analyse de la chaîne ne conduit pas à une mesure, VarConvertCreate 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.