Vcl.Forms.TApplication.ModalPopupMode

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property ModalPopupMode: TPopupMode read FModalPopupMode write FModalPopupMode default pmNone;

C++

__property TPopupMode ModalPopupMode = {read=FModalPopupMode, write=FModalPopupMode, default=0};

Properties

Type Visibility Source Unit Parent
property public
Vcl.Forms.pas
Vcl.Forms.hpp
Vcl.Forms TApplication

Description

Controls how the modal form behaves, with respect to Windows' WS_POPUP style.

Use ModalPopupMode to set the way modal forms behave, with respect to Windows' WS_POPUP style. The possible values for ModalPopupMode are given in the table below.

Value Meaning

pmNone

The popup window has the pre-Delphi 8 behavior.

pmAuto

Popup handling is automatic.

pmExplicit

This is used for non-modal design windows, causing the windows to always remain on top of the main form.


Note: When you use a value other than pmNone, you may experience undesired results when you combine a persistent modal form with a parent form that is dynamically created and freed.

See Also