Data.DB.TFMTBCDField.Create

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

constructor Create(AOwner: TComponent); override;

C++

__fastcall virtual TFMTBCDField(System::Classes::TComponent* AOwner);

Properties

Type Visibility Source Unit Parent
constructor public
Data.DB.pas
Data.DB.hpp
Data.DB TFMTBCDField

Description

Create creates an instance of TFMTBCDField.

Most applications do not explicitly create instances of TFMTBCDField. Instead, the field components are created automatically, as persistent field components defined in the Fields editor at design time or as dynamic field components created automatically by the dataset.

The AOwner parameter specifies the component, typically a dataset, that becomes the new field's Owner. The Owner is responsible for freeing the component.

In the rare cases when you must create a persistent field component at runtime, call Create to create and initialize an instance of TFMTBCDField. After instantiating a TFMTBCDField, associate it with a specific field by setting its FieldName property to the name of the field. Give the TFMTBCDField a unique identifier in the Name property. Establish where the field appears in the collection of fields by providing an ordinal number in the Index property. Associate the TFMTBCDField with a dataset component by setting its DataSet property to the name of the dataset component. Specify the precision of the TFMTBCDField by setting the Precision property.

The example below creates a TFMTBCDField object for a field named Amount accessed through a TSQLQuery named SQLQuery1.



var
T: TFMTBCDField;
begin
SQLQuery1.Close;
T := TFMTBCDField.Create(SQLQuery1);
T.FieldName := 'Amount';
T.Name := SQLQuery1.Name + T.FieldName;
T.Index := SQLQuery1.FieldCount;
T.DataSet := SQLQuery1;
T.Precision := 20;
SQLQuery1.FieldDefs.UpDate;
SQLQuery1.Open;
end;



SQLQuery1->Close();
TFMTBCDField *T = new TFMTBCDField(SQLQuery1);
T->FieldName = "Amount";
T->Name = SQLQuery1->Name + T->FieldName;
T->Index = SQLQuery1->FieldCount;
T->DataSet = SQLQuery1;
T->Precision = 20;
SQLQuery1->FieldDefs->UpDate();
SQLQuery1->Open();



See Also