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

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
(Метка: замена)
Строка 3: Строка 3:
 
Delphi
 
Delphi
  
<code lang="Delphi">TfgControl = class (TComponent, IInterfaceComponentReference, IInterface)</code>
+
<syntaxhighlight lang="Delphi">TfgControl = class (TComponent, IInterfaceComponentReference, IInterface)</syntaxhighlight>
 
 
== Описание ==
 
 
 
Описание отсутствует.
 
 
 
== Конструкторы ==
 
 
 
{| class="wikitable sortable"
 
|-
 
| <code>constructor</code> || <code>Create(AOwner: [[TComponent]])</code>
 
 
 
|}
 
 
 
== Методы ==
 
 
 
{| class="wikitable sortable"
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">AfterConstruction()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">BeforeDestruction()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">IsLoading()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">IsCreating()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">IsDestroying()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">InsertControl(const AChild: [[FGX.Control.TfgControl|TfgControl]])</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">RemoveControl(const AChild: [[FGX.Control.TfgControl|TfgControl]])</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">DeleteControls()</code>
 
Удаляет все дочерние объекты.
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">HasParent()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">IsChild(const AChild: [[FGX.Control.TfgControl|TfgControl]])</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">GetParentComponent()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">BringToFront()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">SendToBack()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">HitTestPoint(const ALocalPoint: [[TPointF]])</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">ControlAtPoint(const ALocalPoint: [[TPointF]]; const AIgnoreStored: [[Boolean]])</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">Invalidate()</code>
 
Выполнить полную перерисовку формы.
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">Clone(const AStoreEvents: [[Boolean]])</code>
 
Делает копию текущего контрола на основании "published" свойств.
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">GetFormPosition()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">GetFormBounds()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">MeasureSize(const AWidthSpec: [[.TfgMeasuringSpecification|TfgMeasuringSpecification]]; const AWidth: [[Single]]; const AHeightSpec: [[.TfgMeasuringSpecification|TfgMeasuringSpecification]]; const AHeight: [[Single]])</code>
 
Выполняет рассчет размера контрола на основании входящих данных. Спецификации '' AWidthSpec '' и '' AHeightSpec '' указывают, как нужно использовать ширину '' AWidth '' и высоту '' AHeight '' при вычислении размера контрола.
 
 
 
- финальный вычисляемый размер никак не ограничен сверху. При использовании этой спецификации переданный размер в '' AWidth '' или '' AHeight '' будет проигнорирован.
 
 
 
- означает, что финальный вычисляемый размер ограничен сверху соответствующим значением ширины '' AWidth '' или высоты '' AHeight '' .
 
 
 
- означает, что финальный вычисляемый размер зафиксирован сверху соответствующим значением ширины '' AWidth '' или высоты '' AHeight '' .
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">LocalToForm(const ALocalPoint: [[TPointF]])</code>
 
Конвертирует локальные координаты в рамках контрола в систему координат формы.
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">CanRealign()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">Realign()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">BeginUpdate()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">EndUpdate()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">IsUpdating()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">SetFocus()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">ResetFocus()</code>
 
 
 
|-
 
| <code lang="Delphi">function</code> || <code lang="Delphi">IsFocused()</code>
 
 
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">SubscribeOnNotification(const AObserver: [[.IFGXNotificationObserver|IFGXNotificationObserver]]; const ANotificationType: [[.TfgNotificationType|TfgNotificationType]])</code>
 
Подисывает наблюдателя '' AObserver '' на получение уведомлений типа '' ANotificationType '' .
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">UnsubscribeOnNotification(const AObserver: [[.IFGXNotificationObserver|IFGXNotificationObserver]]; const ANotificationType: [[.TfgNotificationType|TfgNotificationType]])</code>
 
Отписывает наблюдателя '' AObserver '' на получение уведомлений типа '' ANotificationType '' . Если подписчик не был ранее подписан, метод тогда ничего не делает.
 
|-
 
| <code lang="Delphi">procedure</code> || <code lang="Delphi">Notify(const ANotificationType: [[.TfgNotificationType|TfgNotificationType]])</code>
 
Уведомляет всех подписчиков, что произошло событие с типом '' 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>
 
 
 
|}
 
 
 
== События ==
 
 
 
{| class="wikitable sortable"
 
|-
 
| <code>event</code> || <code>OnTap: [[TNotifyEvent]]</code>
 
 
 
|-
 
| <code>event</code> || <code>OnLongTap: [[TfgLongTapEvent]]</code>
 
 
 
|-
 
| <code>event</code> || <code>OnDestroy: [[TNotifyEvent]]</code>
 
Вызывается перед удалением контрола. А именно перед вызовом деструктора.
 
|-
 
| <code>event</code> || <code>OnResized: [[TfgResizedEvent]]</code>
 
Вызывается когда контрол изменил свой размерм.
 
|-
 
| <code>event</code> || <code>OnPositionChanged: [[TfgPositionChangedEvent]]</code>
 
Вызывается когда контрол поменял свою позицию.
 
|-
 
| <code>event</code> || <code>OnPaint: [[TfgPaintEvent]]</code>
 
Вызывается после отрисовки нативного контрола. Служит для выполнения пользовательской отрисовки поверх контрола.
 
|-
 
| <code>event</code> || <code>OnTouch: [[Boolean]]</code>
 
Вызывается в момент касания пользователем экрана устройства.
 
|-
 
| <code>event</code> || <code>OnEnter: [[TNotifyEvent]]</code>
 
 
 
|-
 
| <code>event</code> || <code>OnExit: [[TNotifyEvent]]</code>
 
 
 
|}
 
 
 
== Константы ==
 
 
 
{| class="wikitable sortable"
 
|-
 
| <code>const</code> || <code>DefaultAlignWithMargins: [[Boolean]]</code>
 
 
 
|-
 
| <code>const</code> || <code>DefaultOpacity: [[Integer]]</code>
 
 
 
|-
 
| <code>const</code> || <code>DefaultVisible: [[Boolean]]</code>
 
 
 
|-
 
| <code>const</code> || <code>DefaultHitTest: [[Boolean]]</code>
 
 
 
|-
 
| <code>const</code> || <code>DefaultStored: [[Boolean]]</code>
 
 
 
|-
 
| <code>const</code> || <code>DefaultLocked: [[Boolean]]</code>
 
 
 
|-
 
| <code>const</code> || <code>DefaultPositionMode: [[.TfgPositionMode|TfgPositionMode]]</code>
 
 
 
|}
 

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

Delphi

TfgControl = class (TComponent, IInterfaceComponentReference, IInterface)