Drop-in popup component that shows a floating form anchored to a placement control or rectangle, with configurable size, placement, and paint events.
API unit family: TMSFNCPopup
Inherits from: TTMSFNCCustomPopup
Syntax
TTMSFNCPopup = class(TTMSFNCCustomPopup)
Properties
| Name |
Description |
| ContentControl |
The control hosted inside the popup form as its primary visual content. (inherited from TTMSFNCCustomPopup) |
| DragWithParent |
When True, the popup moves with its parent form when the parent is dragged. (inherited from TTMSFNCCustomPopup) |
| DropDownHeight |
The preferred height of the popup form in pixels. Use 0 to size automatically. (inherited from TTMSFNCCustomPopup) |
| DropDownWidth |
The preferred width of the popup form in pixels. Use 0 to size automatically. (inherited from TTMSFNCCustomPopup) |
| FillColor |
The background fill color of the popup form. Defaults to gcNull (transparent). (inherited from TTMSFNCCustomPopup) |
| FocusedControl |
The control that receives focus when the popup opens. (inherited from TTMSFNCCustomPopup) |
| HorizontalOffset |
The horizontal pixel offset applied after placement calculations. (inherited from TTMSFNCCustomPopup) |
| IsOpen |
When True, the popup form is currently visible. (inherited from TTMSFNCCustomPopup) |
| ModalResult |
The modal result value set when the popup is closed from within a modal session. (inherited from TTMSFNCCustomPopup) |
| Placement |
The placement strategy used to position the popup relative to the placement control or rectangle. (inherited from TTMSFNCCustomPopup) |
| PlacementControl |
The control used as the anchor for popup placement calculations. (inherited from TTMSFNCCustomPopup) |
| PlacementRectangle |
The rectangle used as the placement anchor when no PlacementControl is set. (inherited from TTMSFNCCustomPopup) |
| PopupForm |
Provides direct access to the underlying popup form instance. (inherited from TTMSFNCCustomPopup) |
| PopupFormSize |
The explicit width and height of the popup form when shown. (inherited from TTMSFNCCustomPopup) |
| StaysOpen |
When True, the popup remains open when the user clicks outside it. (inherited from TTMSFNCCustomPopup) |
| StrokeColor |
The border stroke color of the popup form. Defaults to gcNull (no border). (inherited from TTMSFNCCustomPopup) |
| Transparent |
When True, the popup form background is transparent. Defaults to False. Available on FMX only. (inherited from TTMSFNCCustomPopup) |
| Version |
The component version string. (inherited from TTMSFNCCustomPopup) |
| VerticalOffset |
The vertical pixel offset applied after placement calculations. (inherited from TTMSFNCCustomPopup) |
Methods
| Name |
Description |
| HasPopupForm |
Returns True when the popup form has been created and is available. (inherited from TTMSFNCCustomPopup) |
| PointInPopup |
Returns True when the given screen point falls within the bounds of the open popup form. (inherited from TTMSFNCCustomPopup) |
| Popup |
Shows or hides the popup form. |
| PopupModal |
Opens the popup as a modal dialog and returns the modal result when the popup closes. |
Events
| Name |
Description |
| OnClosePopup |
Fires when the popup form closes. (inherited from TTMSFNCCustomPopup) |
| OnPopup |
Fires when the popup form becomes visible. (inherited from TTMSFNCCustomPopup) |
| OnPopupPaint |
Fires to allow custom painting over the popup form background. (inherited from TTMSFNCCustomPopup) |
| OnPopupShown |
Fires after the popup form is fully shown and positioned. (inherited from TTMSFNCCustomPopup) |