FGX.Forms.TfgForm: различия между версиями
Admin (обсуждение | вклад) (summary) (Метка: замена) |
Admin (обсуждение | вклад) (summary) |
||
(не показано 7 промежуточных версий этого же участника) | |||
Строка 6: | Строка 6: | ||
<syntaxhighlight lang="Delphi">TfgForm = class (TfgCustomForm)</syntaxhighlight> | <syntaxhighlight lang="Delphi">TfgForm = class (TfgCustomForm)</syntaxhighlight> | ||
− | <p class="class-inheritance"><span class="type-border">[[System.Classes.TComponent|TComponent]]</span> -> <span class="type-border">[[FGX. | + | <p class="class-inheritance"><span class="type-border">[[System.Classes.TComponent|TComponent]]</span> -> <span class="type-border">[[FGX.Controls.TfgControl|TfgControl]]</span> -> <span class="type-border">[[FGX.Layout.TfgCustomLayout|TfgCustomLayout]]</span> -> <span class="type-border">[[FGX.Forms.TfgCustomForm|TfgCustomForm]]</span> -> <span class="type-border">[[FGX.Forms.TfgForm|TfgForm]]</span></p> |
+ | |||
+ | == Описание == | ||
+ | |||
+ | <span style="color:gray">Описание отсутствует.</span> | ||
+ | == Свойства == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>CloseOnHardwareBack: [[Boolean]]</code> | ||
+ | |||
+ | <p>По умолчанию форма закрывается, если пользователь нажимает на кнопку <i>vkHardwareBack</i> . Однако, если разработчик сам хочет принимать решение о закрытии формы, то он может отключить закрытие формы по кнопке назад при помощи этого свойства.</p><div class="info">Встраиваемая форма (у которой <i>Parent <> nil</i> ) не закрывается по кнопке назад.</div><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.CloseOnHardwareBack|CloseOnHardwareBack]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LayoutDirection: [[FGX.Controls.Types.TfgControlLayoutDirection|TfgControlLayoutDirection]]</code> | ||
+ | <p>Направление выравнивания контролов на форме для LTR and RTL языков. В зависимости от выбранного значения, при выравнивании положение контролов может быть зеркально отражено относительно вертикальной оси.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.LayoutDirection|LayoutDirection]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SystemStatusBar: [[FGX.Forms.Types.TfgSystemStatusBar|TfgSystemStatusBar]]</code> | ||
+ | <p>Настройки системного статуса бара.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.SystemStatusBar|SystemStatusBar]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FullScreen: [[Boolean]]</code> | ||
+ | <p>Будет ли растянута форма по размеру экрана или нет. Если нет, то форме можно задать любую позицию и размер.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.FullScreen|FullScreen]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Toolbar: [[FGX.Forms.Types.IFGXToolBar|IFGXToolBar]]</code> | ||
+ | <p>Это свойство позволяет встроить выбранный тулбар в форму на низком уровне.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.Toolbar|Toolbar]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Transparent: [[Boolean]]</code> | ||
+ | <p>Позволяет отключить отображение заднего фона, сделав форму полностью прозрачной.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.Transparent|Transparent]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ThemeName: [[TfgThemeName|TfgThemeName]]</code> | ||
+ | |||
+ | <p>Название темы, которая будет использоваться для всех вложеннх компонентов.</p><div class="info">Если значение не указано, то по умолчанию используется тема "Theme".</div><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.ThemeName|ThemeName]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>DefaultCloseAction: [[FGX.Controls.TfgFormCloseAction|TfgFormCloseAction]]</code> | ||
+ | |||
+ | <p>Действие по-умолчанию, которое происходит с формой, когда она закрывается с помощью <i>Close</i> .</p><div class="info">На решение о действии с формой так же можно повлиять с помощью события <i>OnClose</i> .</div><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.DefaultCloseAction|DefaultCloseAction]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>AlignmentChildren: [[FGX.Layout.Types.TfgChildrenAlignment|TfgChildrenAlignment]]</code> | ||
+ | |||
+ | <p>Задает правила выравнивания дочерних контролов.</p><div class="info">Влияет только на дочерние контролы, которые используют режим относительного позиционирования <i>PositionMode = TfgPositionMode.Relative</i> .</div><small style="color: red"><small>Описание взято от [[FGX.Layout.TfgCustomLayout.AlignmentChildren|AlignmentChildren]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>BackgroundName: [[TfgAssetName|TfgAssetName]]</code> | ||
+ | <p>Настройки отображения заднего фона контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.BackgroundName|BackgroundName]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Position: [[FGX.Controls.Types.TfgPosition|TfgPosition]]</code> | ||
+ | <p>Позиция контрола в локальных логических координатах родителя <i>Parent</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Position|Position]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Padding: [[FGX.Layout.Types.TfgPadding|TfgPadding]]</code> | ||
+ | |||
+ | <p>Внутренние отступы, учитывающиеся при выравнивании дочерних контролов.</p><div class="info">Влияет только на дочерние контролы, которые используют режим относительного позиционирования <i>PositionMode = TfgPositionMode.Relative</i> .</div><small style="color: red"><small>Описание взято от [[FGX.Layout.TfgCustomLayout.Padding|Padding]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[FGX.Controls.Types.TfgSize|TfgSize]]</code> | ||
+ | <p>Размер контрола в логических координатах.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Size|Size]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>GestureKinds: [[FGX.Controls.TfgGestureKinds|TfgGestureKinds]]</code> | ||
+ | <p>Виды поддерживаемых жестов.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.GestureKinds|GestureKinds]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>HitTest: [[Boolean]]</code> | ||
+ | <span style="color:gray">Описание отсутствует.</span> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Opacity: [[Single]]</code> | ||
+ | <p>Прозрачность контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Opacity|Opacity]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Visible: [[Boolean]]</code> | ||
+ | <p>Видимость контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Visible|Visible]].</small></small> | ||
+ | |} | ||
+ | |||
+ | == События == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCreate: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда форма создана и полностью загружена.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnCreate|OnCreate]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnKey: [[TfgKeyEvent|TfgKeyEvent]]</code> | ||
+ | <p>Срабатывает, когда ни один компонент формы не обработал событие кнопки.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnKey|OnKey]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnShow: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда форма отображается на экране.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnShow|OnShow]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnHide: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда форма скрывается с экрана.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnHide|OnHide]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnClose: [[TfgCloseEvent|TfgCloseEvent]]</code> | ||
+ | <p>Срабатывает, когда форма закрывается с помощью метода <i>Close</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnClose|OnClose]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnInterfaceOrientationChanged: [[TfgInterfaceOrientationChangedEvent|TfgInterfaceOrientationChangedEvent]]</code> | ||
+ | <p>Срабатывает, когда приложение меняет свою ориентацию на экране.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnInterfaceOrientationChanged|OnInterfaceOrientationChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnVirtualKeyboardBeginFrameChanging: [[TfgVirtualKeyboardBeginFrameChangingEvent|TfgVirtualKeyboardBeginFrameChangingEvent]]</code> | ||
+ | |||
+ | <p>Срабатывает до начала анимации изменения размера или положения виртуальной клавиатуры. Содержит конечное положение виртуальной клавиатуры и значение длительности анимации, в течении которого клавиатура займет конечное положение. Переданные параметры анимации можно использовать для анимированного перестроения UI при изменении области расположения виртуальной клавиатуры.</p><div class="info">Не вызывается, если форма скрыта.</div><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnVirtualKeyboardBeginFrameChanging|OnVirtualKeyboardBeginFrameChanging]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnVirtualKeyboardFrameChanged: [[TfgVirtualKeyboardFrameChangedEvent|TfgVirtualKeyboardFrameChangedEvent]]</code> | ||
+ | |||
+ | <p>Срабатывает, когда виртуальная клавиатура меняет своё положение на экране.</p><div class="info">Не вызывается, если форма скрыта.</div><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnVirtualKeyboardFrameChanged|OnVirtualKeyboardFrameChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSafeAreaChanged: [[TfgSafeAreaChangedEvent|TfgSafeAreaChangedEvent]]</code> | ||
+ | <p>Изменились отступы с краев экрана, в которых не рекомендуется размещать визуальные компоненты, чтобы они не пересекались с системными элементами пользовательского интерфейса. Гарантируется, что при первом отображении формы, данный метод будет вызван, не зависимо от того, были ли изменены размеры областей или нет.</p><small style="color: red"><small>Описание взято от [[FGX.Forms.TfgCustomForm.OnSafeAreaChanged|OnSafeAreaChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnDestroy: [[TNotifyEvent]]</code> | ||
+ | <p>Вызывается перед удалением контрола. А именно перед вызовом деструктора.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnDestroy|OnDestroy]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnResized: [[TfgResizedEvent|TfgResizedEvent]]</code> | ||
+ | <p>Вызывается когда контрол изменил свой размерм.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnResized|OnResized]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnLongTap: [[TfgLongTapEvent|TfgLongTapEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnLongTap|OnLongTap]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnZoom: [[TfgZoomEvent|TfgZoomEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь опускает два пальца на экран и начинает их сводить/разводить.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnZoom|OnZoom]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPositionChanged: [[TfgPositionChangedEvent|TfgPositionChangedEvent]]</code> | ||
+ | <p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnPositionChanged|OnPositionChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[TfgTouchEvent|TfgTouchEvent]]</code> | ||
+ | <p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTouch|OnTouch]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTap: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTap|OnTap]].</small></small> | ||
+ | |} |
Текущая версия на 17:19, 23 декабря 2022
Delphi
TfgForm = class (TfgCustomForm)
TComponent -> TfgControl -> TfgCustomLayout -> TfgCustomForm -> TfgForm
Описание
Описание отсутствует.
Свойства
property
|
CloseOnHardwareBack: Boolean
По умолчанию форма закрывается, если пользователь нажимает на кнопку vkHardwareBack . Однако, если разработчик сам хочет принимать решение о закрытии формы, то он может отключить закрытие формы по кнопке назад при помощи этого свойства. Встраиваемая форма (у которой Parent <> nil ) не закрывается по кнопке назад. Описание взято от CloseOnHardwareBack.
|
property
|
LayoutDirection: TfgControlLayoutDirection
Направление выравнивания контролов на форме для LTR and RTL языков. В зависимости от выбранного значения, при выравнивании положение контролов может быть зеркально отражено относительно вертикальной оси. Описание взято от LayoutDirection. |
property
|
SystemStatusBar: TfgSystemStatusBar
Настройки системного статуса бара. Описание взято от SystemStatusBar. |
property
|
FullScreen: Boolean
Будет ли растянута форма по размеру экрана или нет. Если нет, то форме можно задать любую позицию и размер. Описание взято от FullScreen. |
property
|
Toolbar: IFGXToolBar
Это свойство позволяет встроить выбранный тулбар в форму на низком уровне. Описание взято от Toolbar. |
property
|
Transparent: Boolean
Позволяет отключить отображение заднего фона, сделав форму полностью прозрачной. Описание взято от Transparent. |
property
|
ThemeName: TfgThemeName
Название темы, которая будет использоваться для всех вложеннх компонентов. Если значение не указано, то по умолчанию используется тема "Theme". Описание взято от ThemeName.
|
property
|
DefaultCloseAction: TfgFormCloseAction
Действие по-умолчанию, которое происходит с формой, когда она закрывается с помощью Close . На решение о действии с формой так же можно повлиять с помощью события OnClose . Описание взято от DefaultCloseAction.
|
property
|
AlignmentChildren: TfgChildrenAlignment
Задает правила выравнивания дочерних контролов. Влияет только на дочерние контролы, которые используют режим относительного позиционирования PositionMode = TfgPositionMode.Relative . Описание взято от AlignmentChildren.
|
property
|
BackgroundName: TfgAssetName
Настройки отображения заднего фона контрола. Описание взято от BackgroundName. |
property
|
Position: TfgPosition
Позиция контрола в локальных логических координатах родителя Parent . Описание взято от Position. |
property
|
Padding: TfgPadding
Внутренние отступы, учитывающиеся при выравнивании дочерних контролов. Влияет только на дочерние контролы, которые используют режим относительного позиционирования PositionMode = TfgPositionMode.Relative . Описание взято от Padding.
|
property
|
Size: TfgSize
Размер контрола в логических координатах. Описание взято от Size. |
property
|
GestureKinds: TfgGestureKinds
Виды поддерживаемых жестов. Описание взято от GestureKinds. |
property
|
HitTest: Boolean
Описание отсутствует. |
property
|
Opacity: Single
Прозрачность контрола. Описание взято от Opacity. |
property
|
Visible: Boolean
Видимость контрола. Описание взято от Visible. |
События
event
|
OnCreate: TNotifyEvent
Срабатывает, когда форма создана и полностью загружена. Описание взято от OnCreate. |
event
|
OnKey: TfgKeyEvent
Срабатывает, когда ни один компонент формы не обработал событие кнопки. Описание взято от OnKey. |
event
|
OnShow: TNotifyEvent
Срабатывает, когда форма отображается на экране. Описание взято от OnShow. |
event
|
OnHide: TNotifyEvent
Срабатывает, когда форма скрывается с экрана. Описание взято от OnHide. |
event
|
OnClose: TfgCloseEvent
Срабатывает, когда форма закрывается с помощью метода Close . Описание взято от OnClose. |
event
|
OnInterfaceOrientationChanged: TfgInterfaceOrientationChangedEvent
Срабатывает, когда приложение меняет свою ориентацию на экране. Описание взято от OnInterfaceOrientationChanged. |
event
|
OnVirtualKeyboardBeginFrameChanging: TfgVirtualKeyboardBeginFrameChangingEvent
Срабатывает до начала анимации изменения размера или положения виртуальной клавиатуры. Содержит конечное положение виртуальной клавиатуры и значение длительности анимации, в течении которого клавиатура займет конечное положение. Переданные параметры анимации можно использовать для анимированного перестроения UI при изменении области расположения виртуальной клавиатуры. Не вызывается, если форма скрыта. Описание взято от OnVirtualKeyboardBeginFrameChanging.
|
event
|
OnVirtualKeyboardFrameChanged: TfgVirtualKeyboardFrameChangedEvent
Срабатывает, когда виртуальная клавиатура меняет своё положение на экране. Не вызывается, если форма скрыта. Описание взято от OnVirtualKeyboardFrameChanged.
|
event
|
OnSafeAreaChanged: TfgSafeAreaChangedEvent
Изменились отступы с краев экрана, в которых не рекомендуется размещать визуальные компоненты, чтобы они не пересекались с системными элементами пользовательского интерфейса. Гарантируется, что при первом отображении формы, данный метод будет вызван, не зависимо от того, были ли изменены размеры областей или нет. Описание взято от OnSafeAreaChanged. |
event
|
OnDestroy: TNotifyEvent
Вызывается перед удалением контрола. А именно перед вызовом деструктора. Описание взято от OnDestroy. |
event
|
OnResized: TfgResizedEvent
Вызывается когда контрол изменил свой размерм. Описание взято от OnResized. |
event
|
OnLongTap: TfgLongTapEvent
Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану. Описание взято от OnLongTap. |
event
|
OnZoom: TfgZoomEvent
Срабатывает, когда пользователь опускает два пальца на экран и начинает их сводить/разводить. Описание взято от OnZoom. |
event
|
OnPositionChanged: TfgPositionChangedEvent
Вызывается когда контрол поменял свою позицию. Описание взято от OnPositionChanged. |
event
|
OnTouch: TfgTouchEvent
Вызывается в момент касания пользователем экрана устройства. Описание взято от OnTouch. |
event
|
OnTap: TNotifyEvent
Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану. Описание взято от OnTap. |