RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCustomVariantType Class

TCustomVariantType is the base class for Delphi custom variant types.

Pascal
TCustomVariantType = class(TObject, IInterface);
C++
class TCustomVariantType : public TObject, public IInterface;

Variants

Use TCustomVariantType to define new data types for Delphi Variants. TCustomVariantType descendants do not represent the Variants themselves. Rather, they act as utility classes that the custom Variants call on to perform their operations. 

To create a Variant type,  

1.Map the storage of the Variant's data on to the TVarData record. 

2.Write a method that creates instances of your custom Variant. This fills in the Variant's data as defined in step 1. 

3.Declare a class that descends from TCustomVariantType. 

4.Implement all required behavior (including type conversion rules) in the new class. This involves overriding the appropriate virtual methods (typically BinaryOp, UnaryOp, CompareOp or Compare, Cast, CastTo, Clear, Copy, IsClear, LeftPromotion, and RightPromotion). 

5.In the initialization section of the unit that defines your TCustomVariantType descendant, create an instance of your class. When you instantiate your object, it automatically registers itself with the Variant-handling system so that the new Variant type is enabled. 

6.In the finalization section of the unit that defines your TCustomVariantType descendant, free the instance of your class. This automatically unregisters the Variant type.

Note: C++ can use Custom Variant types, but TCustomVariantType descendants must be implemented in Delphi.
For an example, see the FMTBcd unit, which implements a custom Variant type for binary-coded decimal.
Tip: To create a custom Variant that allows users to call methods or procedures and to get or set property values, use TInvokeableVariantType as a base class instead.
 

 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!