Справочник по компонентам Delphi. Часть 3
Страница 27. Компонент TField

^Ъ) property Alignment: TAlignment;

Содержит способ выравнивания (см. главы 1, 2) компонента и используется визуальными компонентами TDBGrid и TDBEdit.

Содержит значение для TBooleanField. Для TStringField возвращает True, если поле начинается с символов Y,y,T,t (Yes, yes, True, true).

property AsDateTime: TDataTime;

Содержит значение для TDateTimeField или TTimeField. Для TStringField проводит конвертацию.

Содержит значение для TFloatField, TBCDField, TCurrencyField. Для TStringField проводит конвертацию.

Содержит значение для TIntegerField, TSmallintField, TWordField. Для TStringField проводит конвертацию.

Содержит значение для TStringField. Для TBCDField, TFloatField, TCurrencyField, TDateTimeField, TTimeField, TIntegerField, TSmallintField, TWordField проводит конвертацию. Для TBooleanField возвращает True, если текст начинается с символов Y,y,T,t. Для TMemoField, TGraphicField, TBIobField, TBytesField, TVarBytesField используется только для чтения и возвращает строки "Memo", "Graphic", "Blob", "Bytes", "VarBytes".

(Pb) property Calculated: Boolean;

(Ro) property CariModify: Boolean;

Определяет возможность изменения характеристик поля.

Идентифицирует набор данных поля.

Содержит число байт, необходимое для размещения компонента в памяти.

Q property DataType: TFieldType; TFieldType = (ft Unknown, ftString, ftSmallint, ftlnteger, ftWord, ftBoolean, ftFloat, ftCurrency, ftBCD, ftDate, ftTime, ftDateTime, ftBytes, ftVarBytes, ftBlob, ftMemo, ftGraphic) ;

Определяет тип данных поля.

1рЬ) property DisplayLabel: String;

Содержит заголовок поля, используемый компонентом TDBGrid.

Ro) property DisplayName: PString;

Содержит имя поля. Используется аналогично свойствам DisplayLabel или FieldName других компонентов.

Содержит символьное представление значения поля, используемое визуальными компонентами в состоянии Edit.

^b) property DisplayWidth: Integer;

Отражает ширину в символах поля, используемого компонентом TDBGrid.

Служит для создания шаблона, ограни­чивающего данные, выводимые в поле. Маска состоит из трех секции, разделяемых точкой с запятой. Первая содержит тело маски. Вторая содержит символ, определя­ющий, будут ли буквенные символы маски сохраняться как часть данных (0 — не со­храняются, 1 — сохраняются). Третья содержит символ, определяющий пробел для маски.

(Ro) property EditMaskPtr: PString;

Является указателем на строку свойства EditMask.

(Pb) property FieldName: String;

Содержит имя, которое поле имеет в таблице базы данных.

(Re) property FieldNo: Integer;

Порядковый номер компонента в наборе данных.

(Pk) property Index: Integer;

Номер компонента в массиве свойства Fields набора данных. Изменение значения этого свойства приводит к изменению расположения поля в наборе данных.

(Ro) property IsIndexField: Boolean;

В состоянии True означает, что поле индексировано.

(Ro) property IsNull: Boolean;

Находится в состоянии True, если текущее поле пустое.

(Pb) property Readonly: Boolean;

Определяет режим редактирования текущего поля. Значение True определяет режим "Только для чтения".

(№) property Required: Boolean;

В значении True означает, что поле обязательно должно быть не пустым.

Определяет размер поля, размещаемого в наборе данных.

Содержит символьное представление значения текущего поля в режиме Edit, используется визуальными компонентами отображения данных.

(Pb) property Visible: Boolean;

Определяет режим отображения компонента.

(Pb) property OnChange: TFieldNotifyEvent ; TFieldNotifyEvent = procedure(Sender: TField! of object;

Реагирует на изменение значений полей компонента. Если поле связано с визуальным компонентом отображения данных, то обработчик вызывается только при попытке изменить текущую запись.

(Pb) property OnGetText: TFieldGetTextEvent ; TFieldGetTextEvent = procedure(Sender: TField; var Text: String; DisplayText: Boolean) of object;

Обрабатывает обращение к свойствам DisplayText и Text. Обработчик работает с DisplayText при использовании режима просмотра и Text при режиме редак­тирования.

(Pb) property OnSetText: TFieldSetTextEvent; TFieldSetTextEvent = procedure(Sender: TField; const Text: String) of object;

Используется при переопределении зна­чения свойства Text.

(Pb) property OnValidate: TFieldNotifyEvent;

Реагирует на редактирование содер­жимого компонента. Обработчик вызыва­ется для визуальных компонентов отобра­жения данных только при попытке измене­ния записи.

procedure Assign(Source: TPersistent); override;

Копирует данные из одного компонента в другой, при этом должны быть корректно определены свойства DataType и Size. Параметр Source определяет поле — источник данных. Свойство DataSize источника должно иметь значение не больше 255.

procedure AssignValue(const Value: 'TVarRec) ;

Устанавливает значение поля в соответствие с параметром метода Value, используя для преобразования данных свойства AsBoolean, Aslnteger, AsFloat, AsString, в зависимости от типа данных.

Обнуляет набор значений поля.

Устанавливает фокус формы на первый связанный с TField компонент отображения данных.

function GetData(Buffer:Pointer): Boolean

Помещает в буфер данные поля без преобразований. Для определения размера буфера можно использовать свойство DataSize. Возвращает False в случае отсутствия данных.

function IsValidChar(InputChar: Char) : Boolean; virtual

Используется для определения корректности символа, введенного в поле, результат зависит от типа данных поля. Применяется компонентами отображения данных.

procedure SetData(Buffer: Pointer);

Записывает в поле данные из буфера без преобразования. Размер буфера определяется свойством DataSize.