API:Data.DB.TTimeField.Create
Delphi
constructor Create(AOwner: TComponent); override;
C++
__fastcall virtual TTimeField(System::Classes::TComponent* AOwner);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| constructor | public | Data.DB.pas Data.DB.hpp |
Data.DB | TTimeField |
Beschreibung
Erstellt und initialisiert ein TDateTimeField-Objekt.
Data.DB.TTimeField.Create erbt von Data.DB.TDateTimeField.Create. Der folgende Inhalt bezieht sich auf Data.DB.TDateTimeField.Create.
Erstellt und initialisiert ein TDateTimeField-Objekt.
Die meisten Anwendungen erzeugen keine expliziten Instanzen von TDateTimeField. Vielmehr werden die Feldomponenten automatisch erzeugt, und zwar entweder als vom Felder-Editor beim Entwurf definierte persistente Feldkomponenten oder als von der Datenmenge automatisch erzeugte dynamische Feldkomponenten.
Create setzt die Eigenschaft DataType auf ftDateTime. Der Parameter AOwner gibt den Eigentümer der Komponente an (meist eine Datenmenge). Der Eigentümer ist für die Freigabe der Komponente verantwortlich.
In den seltenen Fällen, für die das Erzeugen einer persistenten Feldkomponente zur Laufzeit erforderlich ist, rufen Sie Create auf, wenn Sie eine Instanz von TDateTimeField erstellen und initialisieren wollen. Verknüpfen Sie das Objekt nach der Instantiierung mit einem bestimmten Feld, indem Sie der Eigenschaft FieldName den gewünschten Feldnamen zuweisen. Weisen Sie der Eigenschaft Name einen eindeutigen Bezeichner für die Feldkomponente zu. Der Eigenschaft Index weisen Sie die Position des Feldes in der Feldkollektion der Datenmenge zu. Weisen Sie der Eigenschaft DataSet den Namen der Datenmengenkomponente zu. Optional können Sie der Eigenschaft DisplayFormat das gewünschte Datums-/Zeitformat zuweisen.
Das folgende Beispiel erzeugt ein TDateTimeField-Objekt für ein Feld mit dem Namen CheckOut, auf das mit der TClientDataSet-Komponente ClientDataSet1 zugegriffen werden kann.
var
T: TDateTimeField;
begin
ClientDataSet1.Close;
T := TDateTimeField.Create(ClientDataSet1);
T.FieldName := 'CheckOut';
T.Name := ClientDataSet1.Name + T.FieldName;
T.Index := ClientDataSet1.FieldCount;
T.DataSet := ClientDataSet1;
T.DisplayFormat := 'mm/dd/yyyy hh:nn:ss ampm';
ClientDataSet1.FieldDefs.UpDate;
ClientDataSet1.Open;
end;
ClientDataSet1->Close();
TDateTimeField *T = new TDateTimeField(ClientDataSet1);
T->FieldName = "CheckOut";
T->Name = ClientDataSet1->Name + T->FieldName;
T->Index = ClientDataSet1->FieldCount;
T->DataSet = ClientDataSet1;
T->DisplayFormat = "mm//dd//yyyy hh:nn:ss ampm";
ClientDataSet1->FieldDefs->UpDate();
ClientDataSet1->Open();