Table of Contents

TTMSFNCCustomControlBase Class

Intermediate base class that maps framework event dispatch to the shared handler methods.

API unit family: TMSFNCCustomControl Inherits from: TTMSFNCCustomControlBaseCommon

Syntax

TTMSFNCCustomControlBase = class(TTMSFNCCustomControlBaseCommon)

Properties

Name Description
AllowFocus When True (default) the control can receive keyboard focus. Set to False to prevent focus. (inherited from TTMSFNCCustomControlBaseCommon)
ControlAlignment Framework-neutral alignment that positions the control relative to its parent. Defaults to caNone (manual placement). (inherited from TTMSFNCCustomControlBaseCommon)
DesigntimeFormPixelsPerInch Pixels-per-inch value of the form as recorded at design time. Used internally to compute DPI scaling at runtime. (inherited from TTMSFNCCustomControlBaseCommon)
HitTest When True (default) the control participates in mouse hit-testing and receives mouse events.
Left Horizontal position of the control's left edge in pixels, relative to its parent. FMX only — use standard Left on other frameworks.
LocalRect The usable client area of the control as a floating-point rectangle with origin (0, 0).
PaintScaleFactor DPI scale factor applied during painting. Use ScalePaintValue to convert pixel sizes in custom drawing code. (inherited from TTMSFNCCustomControlBaseCommon)
ResourceScaleFactor DPI scale factor applied when loading image resources (bitmaps). Use ScaleResourceValue to convert pixel sizes for resource loading. (inherited from TTMSFNCCustomControlBaseCommon)
Stored When True (default) the control's state is included when saving form/frame data. Set to False to exclude it.
Top Vertical position of the control's top edge in pixels, relative to its parent. FMX only — use standard Top on other frameworks.

Methods

Name Description
BeginUpdate Suspends visual updates for the web control implementation so multiple property changes can be applied without intermediate repaints.
CanFocus Returns True when the control is able to receive keyboard focus.
DragDrop Called by the framework when a drag-and-drop operation completes over the control. Dispatches to HandleDragDrop for cross-framework processing.
EndUpdate Re-enables visual updates for the web control implementation after a BeginUpdate call and triggers a repaint.
GetControlMargins Returns the four margin values of the control. (inherited from TTMSFNCCustomControlBaseCommon)
Invalidate Schedules a full repaint of the control on the next paint cycle.
ScalePaintValue Scales an integer value by the current paint DPI factor, returning the scaled integer. (inherited from TTMSFNCCustomControlBaseCommon)
ScaleResourceValue Scales an integer value by the current resource DPI factor, returning the scaled integer. (inherited from TTMSFNCCustomControlBaseCommon)
SetControlMargins Sets the four margin values of the control in one call. (inherited from TTMSFNCCustomControlBaseCommon)