Vcl.Forms.TForm.PopupMode

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property PopupMode;

C++

__property PopupMode = {default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
Vcl.Forms.pas
Vcl.Forms.hpp
Vcl.Forms TForm

Beschreibung

Steuert, wie sich das Formular der obersten Ebene hinsichtlich des Windows-Stils WS_POPUP verhält.

Vcl.Forms.TForm.PopupMode erbt von Vcl.Forms.TCustomForm.PopupMode. Der folgende Inhalt bezieht sich auf Vcl.Forms.TCustomForm.PopupMode.

Steuert, wie sich das Formular der obersten Ebene hinsichtlich des Windows-Stils WS_POPUP verhält.

Die Eigenschaft PopupMode steuert, wie sich das Formular der obersten Obene hinsichtlich des Windows-Stils WS_POPUP verhält. Ein Fenster mit dem Stil WS_POPUP steht in der Z-Reihenfolge immer über seinem "Eigentümer". Sie können die Eigenschaft PopupMode in Verbindung mit der Eigenschaft PopupParent verwenden, um den Anschein einer "hängenden" Anwendung zu vermeiden. Dies kann von einem modalen Dialogfeld verursacht werden, das hinter einem anderen Formular auf dem Bildschirm sichtbar ist.

Hinweis: Die Verwendung der Eigenschaft PopupMode entspricht der Angabe von fsStayOnTop für die Eigenschaft FormStyle, bietet jedoch eine bessere Kontrolle über die einzelnen Ebenen.

Die Eigenschaft PopupMode wird beim Aufruf der Methode ShowModal automatisch auf pmAuto gesetzt. Dies verursacht aber eine Neuerstellung des Fenster-Handle, was in der Regel nicht wünschenswert ist. Um die Neuerstellung von Fenster-Handles zu vermeiden, muss die Eigenschaft PopupMode vor dem Aufruf der Methode ShowModal explizit auf pmAuto gesetzt werden (z.B. zur Entwurfszeit).

Setzen Sie die Eigenschaft PopupMode auf pmExplicit für nicht modale Entwurfsfenster, z.B. für Tool-Paletten und andere frei platzierbare Tool-Fenster. Dadurch verbleiben die Fenster immer vor dem Hauptformular. Bei einem gedockt zusammengesetzten Entwurf (d.h. das Fenster ist an das Hauptformular angedockt) bleibt das Entwurfsfenster vor dem Designer.

Hinweis: Bei nicht zusammengesetzten Fenstern bleibt das Entwurfsfenster über dem Hauptformular, wodurch andere Formulare der obersten Ebene das Entwurfsfenster verdecken können.

Setzen Sie die Eigenschaft PopupMode auf pmNone, falls das Popupfenster das Verhalten vor Delphi 8 aufweisen soll (mit Ausnahme des oben erwähnten ShowModal).

Wenn Sie die Eigenschaft PopupParent auf ein explizites TCustomForm-Objekt setzen, können Sie die Z-Reihenfolge Ihrer Formulare festlegen und eine "gestapelte" Darstellung erstellen, die vom Anwender nicht geändert werden kann. Wenn die Eigenschaft PopupMode pmExplicit und PopupParent nil ist, dann wird Application.MainForm implizit als PopupParent verwendet. Wenn kein Application.MainForm zugewiesen ist, dann wird Application.Handle als PopupParent verwendet. Falls die Eigenschaft PopupMode auf pmAuto gesetzt ist, wird Screen.ActiveForm als PopupParent verwendet.