FGX.Control.TfgControl: различия между версиями

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
Строка 122: Строка 122:
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">Notify(const ANotificationType: [[.TfgNotificationType|TfgNotificationType]])</code>
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">Notify(const ANotificationType: [[.TfgNotificationType|TfgNotificationType]])</code>
 
Уведомляет всех подписчиков, что произошло событие с типом '' ANotificationType '' .
 
Уведомляет всех подписчиков, что произошло событие с типом '' ANotificationType '' .
 +
|}
 +
 +
== Свойства ==
 +
 +
{| class="wikitable sortable"
 +
|-
 +
| <code>property</code> || <code>Index: [[Integer]]</code>
 +
Порядковый номер контрола в рамках родителя. Отвечает за порядок выравнивания и Z-порядок. 0 - контрол находится позади всех соседних и выравнивается первым.
 +
|-
 +
| <code>property</code> || <code>Form: [[FGX.Control.TfgControl|TfgControl]]</code>
 +
Возвращает ссылку на форму, в которую встроен контрол.
 +
|-
 +
| <code>property</code> || <code>Controls: [[TList<FGX.Control.TfgControl>]]</code>
 +
Вложенные контролы.
 +
|-
 +
| <code>property</code> || <code>ControlsCount: [[Integer]]</code>
 +
Количество вложенных контролов.
 +
|-
 +
| <code>property</code> || <code>BackgroundLink: [[FGX.Assets.TfgAssetLink|TfgAssetLink]]</code>
 +
Связь ресурса заднего фона.
 +
|-
 +
| <code>property</code> || <code>Handle: [[FGX.NativeControl.Factory.TfgNativeControlHandle|TfgNativeControlHandle]]</code>
 +
Хендл с информацией о нативном представлении контрола.
 +
|-
 +
| <code>property</code> || <code>Parent: [[FGX.Control.TfgControl|TfgControl]]</code>
 +
Родитель
 +
|-
 +
| <code>property</code> || <code>Bounds: [[TRectF]]</code>
 +
Местоположение контрола в родительской системе координат.
 +
|-
 +
| <code>property</code> || <code>LocalBounds: [[TRectF]]</code>
 +
Возвращает местоположение контрола в своей системе координат.
 +
|-
 +
| <code>property</code> || <code>Height: [[Single]]</code>
 +
Высота контрола
 +
|-
 +
| <code>property</code> || <code>Width: [[Single]]</code>
 +
Ширина контрола
 +
|-
 +
| <code>property</code> || <code>NaturalSize: [[TSizeF]]</code>
 +
Естественный размер контрола. Каждый контрол может сказать, какой размер ему необходим, чтобы нормально отобразить свое содержимое.
 +
|-
 +
| <code>property</code> || <code>Stored: [[Boolean]]</code>
 +
Нужно ли при серилизации сохранять текущий контрол.
 +
|-
 +
| <code>property</code> || <code>TagObject: [[TObject]]</code>
 +
Место хранения пользовательских данных, ассоциированных с данным контролом.
 +
|-
 +
| <code>property</code> || <code>Locked: [[Boolean]]</code>
 +
Позволяет заблокировать выделение компонента мышкой в дизайн тайме.
 +
|-
 +
| <code>property</code> || <code>Alignment: [[FGX.Control.Types.TfgControlAlignment|TfgControlAlignment]]</code>
 +
Настройки выравнивания контрола в рамках родителя.
 +
|-
 +
| <code>property</code> || <code>PositionMode: [[.TfgPositionMode|TfgPositionMode]]</code>
 +
Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно).
 +
|-
 +
| <code>property</code> || <code>Position: [[FGX.Control.Types.TfgPosition|TfgPosition]]</code>
 +
Позиция контрола в локальных логических координатах родителя '' Parent '' .
 +
|-
 +
| <code>property</code> || <code>RelativePosition: [[FGX.Control.Types.TfgRelativePosition|TfgRelativePosition]]</code>
 +
Относительная позиция контролов относительно родителя. Актуально только для Относительная позиция контролов относительно родителя. Актуально только для .
 +
|-
 +
| <code>property</code> || <code>Size: [[FGX.Control.Types.TfgSize|TfgSize]]</code>
 +
Размер контрола в логических координатах.
 +
|-
 +
| <code>property</code> || <code>Constraints: [[FGX.Control.Types.TfgConstraints|TfgConstraints]]</code>
 +
Ограничение на размеры контрола.
 +
|-
 +
| <code>property</code> || <code>Margins: [[FGX.Control.Types.TfgMargins|TfgMargins]]</code>
 +
Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера.
 +
|-
 +
| <code>property</code> || <code>AlignWithMargins: [[Boolean]]</code>
 +
Нужно ли использовать заданные внешние отступы '' Margins '' .
 +
|-
 +
| <code>property</code> || <code>GestureKinds: [[.TfgGestureKinds|TfgGestureKinds]]</code>
 +
Виды поддерживаемых жестов.
 +
|-
 +
| <code>property</code> || <code>LookupName: [[string]]</code>
 +
Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева.
 +
|-
 +
| <code>property</code> || <code>Opacity: [[Single]]</code>
 +
Прозрачность контрола.
 +
|-
 +
| <code>property</code> || <code>BackgroundName: [[.TfgAssetName|TfgAssetName]]</code>
 +
Настройки отображения заднего фона контрола.
 +
|-
 +
| <code>property</code> || <code>Visible: [[Boolean]]</code>
 +
Видимость контрола.
 +
|-
 +
| <code>property</code> || <code>HitTest: [[Boolean]]</code>
 +
 
|}
 
|}

Версия 04:10, 10 июня 2019

Delphi

TfgControl = class (TComponent, IInterfaceComponentReference, IInterface)

Описание

Описание отсутствует.

Конструкторы

constructor Create(AOwner: TComponent)

Методы

procedure AfterConstruction()
procedure BeforeDestruction()
function IsLoading()
function IsCreating()
function IsDestroying()
procedure InsertControl(const AChild: TfgControl)
procedure RemoveControl(const AChild: TfgControl)
procedure DeleteControls()

Удаляет все дочерние объекты.

function HasParent()
function IsChild(const AChild: TfgControl)
function GetParentComponent()
procedure BringToFront()
procedure SendToBack()
function HitTestPoint(const ALocalPoint: TPointF)
function ControlAtPoint(const ALocalPoint: TPointF; const AIgnoreStored: Boolean)
procedure Invalidate()

Выполнить полную перерисовку формы.

function Clone(const AStoreEvents: Boolean)

Делает копию текущего контрола на основании "published" свойств.

function GetFormPosition()
function GetFormBounds()
function MeasureSize(const AWidthSpec: TfgMeasuringSpecification; const AWidth: Single; const AHeightSpec: TfgMeasuringSpecification; const AHeight: Single)

Выполняет рассчет размера контрола на основании входящих данных. Спецификации AWidthSpec и AHeightSpec указывают, как нужно использовать ширину AWidth и высоту AHeight при вычислении размера контрола.

- финальный вычисляемый размер никак не ограничен сверху. При использовании этой спецификации переданный размер в AWidth или AHeight будет проигнорирован.

- означает, что финальный вычисляемый размер ограничен сверху соответствующим значением ширины AWidth или высоты AHeight .

- означает, что финальный вычисляемый размер зафиксирован сверху соответствующим значением ширины AWidth или высоты AHeight .

function LocalToForm(const ALocalPoint: TPointF)

Конвертирует локальные координаты в рамках контрола в систему координат формы.

function CanRealign()
procedure Realign()
procedure BeginUpdate()
procedure EndUpdate()
function IsUpdating()
procedure SetFocus()
function ResetFocus()
function IsFocused()
procedure SubscribeOnNotification(const AObserver: IFGXNotificationObserver; const ANotificationType: TfgNotificationType)

Подисывает наблюдателя AObserver на получение уведомлений типа ANotificationType .

procedure UnsubscribeOnNotification(const AObserver: IFGXNotificationObserver; const ANotificationType: TfgNotificationType)

Отписывает наблюдателя AObserver на получение уведомлений типа ANotificationType . Если подписчик не был ранее подписан, метод тогда ничего не делает.

procedure Notify(const ANotificationType: TfgNotificationType)

Уведомляет всех подписчиков, что произошло событие с типом ANotificationType .

Свойства

property Index: Integer

Порядковый номер контрола в рамках родителя. Отвечает за порядок выравнивания и Z-порядок. 0 - контрол находится позади всех соседних и выравнивается первым.

property Form: TfgControl

Возвращает ссылку на форму, в которую встроен контрол.

property Controls: [[TList<FGX.Control.TfgControl>]]

Вложенные контролы.

property ControlsCount: Integer

Количество вложенных контролов.

property BackgroundLink: TfgAssetLink

Связь ресурса заднего фона.

property Handle: TfgNativeControlHandle

Хендл с информацией о нативном представлении контрола.

property Parent: TfgControl

Родитель

property Bounds: TRectF

Местоположение контрола в родительской системе координат.

property LocalBounds: TRectF

Возвращает местоположение контрола в своей системе координат.

property Height: Single

Высота контрола

property Width: Single

Ширина контрола

property NaturalSize: TSizeF

Естественный размер контрола. Каждый контрол может сказать, какой размер ему необходим, чтобы нормально отобразить свое содержимое.

property Stored: Boolean

Нужно ли при серилизации сохранять текущий контрол.

property TagObject: TObject

Место хранения пользовательских данных, ассоциированных с данным контролом.

property Locked: Boolean

Позволяет заблокировать выделение компонента мышкой в дизайн тайме.

property Alignment: TfgControlAlignment

Настройки выравнивания контрола в рамках родителя.

property PositionMode: TfgPositionMode

Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно).

property Position: TfgPosition

Позиция контрола в локальных логических координатах родителя Parent .

property RelativePosition: TfgRelativePosition

Относительная позиция контролов относительно родителя. Актуально только для Относительная позиция контролов относительно родителя. Актуально только для .

property Size: TfgSize

Размер контрола в логических координатах.

property Constraints: TfgConstraints

Ограничение на размеры контрола.

property Margins: TfgMargins

Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера.

property AlignWithMargins: Boolean

Нужно ли использовать заданные внешние отступы Margins .

property GestureKinds: TfgGestureKinds

Виды поддерживаемых жестов.

property LookupName: string

Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева.

property Opacity: Single

Прозрачность контрола.

property BackgroundName: TfgAssetName

Настройки отображения заднего фона контрола.

property Visible: Boolean

Видимость контрола.

property HitTest: Boolean