FMX.Controls.TPlacement

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

TPlacement = (Bottom, Top, Left, Right, Center, BottomCenter, TopCenter, LeftCenter, RightCenter, Absolute, Mouse, MouseCenter);

C++

enum class DECLSPEC_DENUM TPlacement : unsigned char { Bottom, Top, Left, Right, Center, BottomCenter, TopCenter, LeftCenter, RightCenter, Absolute, Mouse, MouseCenter, plBottom _DEPRECATED_ATTRIBUTE3("Use TPlacement.Bottom")  = 0, plTop _DEPRECATED_ATTRIBUTE3("Use TPlacement.Top")  = 1, plLeft _DEPRECATED_ATTRIBUTE3("Use TPlacement.Left")  = 2, plRight _DEPRECATED_ATTRIBUTE3("Use TPlacement.Right")  = 3, plCenter _DEPRECATED_ATTRIBUTE3("Use TPlacement.Center")  = 4, plBottomCenter _DEPRECATED_ATTRIBUTE3("Use TPlacement.BottomCenter")  = 5, plTopCenter _DEPRECATED_ATTRIBUTE3("Use TPlacement.TopCenter")  = 6, plLeftCenter _DEPRECATED_ATTRIBUTE3("Use TPlacement.LeftCenter")  = 7, plRightCenter _DEPRECATED_ATTRIBUTE3("Use TPlacement.RightCenter")  = 8,
    plAbsolute _DEPRECATED_ATTRIBUTE3("Use TPlacement.Absolute")  = 9, plMouse _DEPRECATED_ATTRIBUTE3("Use TPlacement.Mouse")  = 10, plMouseCenter _DEPRECATED_ATTRIBUTE3("Use TPlacement.MouseCenter")  = 11 };

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
enum public
FMX.Controls.pas
FMX.Controls.hpp
FMX.Controls FMX.Controls


Beschreibung

TPlacement legt fest, wie eine Popup-Komponente relativ zu einem bestimmten Punkt positioniert wird.

Eine Popup-Komponente kann ein TPopup-Steuerelement oder ein TCustomPopupForm-Formular sein. Eine Popup-Komponente kann relativ zu in den Eigenschaften ScreenPlacementRect, PlacementRectangle und PlacementTarget angegebenen Rechtecken, relativ zum Bildschirm oder relativ zur Mausposition (Zeigegerät) positioniert werden.

TPlacement kann die folgenden Werte annehmen:

Wert Bedeutung

Bottom

TPopup wird unten am PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn ein TCustomPopupForm-Formular nicht auf den Bildschirm passt, dann wird es oben am PlacementRectangle positioniert.
Wenn keine Offsets angegeben sind, dann ist die linke obere Ecke des TPopup die linke untere Ecke des PlacementRectangle. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn weder PlacementTarget noch PlacementRectangle angegeben ist, wird das TPopup relativ zur linken oberen Ecke des Bildschirms positioniert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

Top

TPopup wird oben am PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, dann ist die linke untere Ecke des TPopup die linke obere Ecke des PlacementRectangle. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn weder PlacementTarget noch PlacementRectangle angegeben ist, wird das TPopup relativ zur linken oberen Ecke des Bildschirms positioniert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

Left

TPopup wird links am PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, dann ist die rechte obere Ecke des TPopup die linke obere Ecke des PlacementRectangle. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn weder PlacementTarget noch PlacementRectangle angegeben ist, wird das TPopup relativ zur linken oberen Ecke des Bildschirms positioniert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

Right

TPopup wird rechts am PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, dann ist die linke obere Ecke des TPopup die rechte obere Ecke des PlacementRectangle. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn weder PlacementTarget noch PlacementRectangle angegeben ist, wird das TPopup relativ zur linken oberen Ecke des Bildschirms positioniert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

Center

TPopup wird in der Mitte des PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn weder PlacementTarget noch PlacementRectangle angegeben ist, wird die Mitte des TPopup an der linken oberen Ecke des Bildschirms positioniert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

BottomCenter

TPopup wird in der Mitte des unteren Randes des PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, wird der obere Rand des TPopup über dem unteren Rand des PlacementRectangle zentriert. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn PlacementTarget nicht angegeben ist, wird der gleiche Effekt wie mit Bottom erzielt. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

TopCenter

TPopup wird in der Mitte des oberen Randes des PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, wird der untere Rand des TPopup über dem oberen Rand des PlacementRectangle zentriert. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn PlacementTarget nicht angegeben ist, wird der gleiche Effekt wie mit Top erzielt. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

LeftCenter

TPopup wird in der Mitte des linken Randes des PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, wird der rechte Rand des TPopup über dem linken Rand des PlacementRectangle zentriert. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn PlacementTarget nicht angegeben ist, wird der gleiche Effekt wie mit Left erzielt. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

RightCenter

TPopup wird in der Mitte des rechten Randes des PlacementRectangle mit den angegebenen vertikalen und horizontalen Offsets positioniert und außerhalb des PlacementRectangle ausgerichtet. Wenn keine Offsets angegeben sind, wird der linke Rand des TPopup über dem rechten Rand des PlacementRectangle zentriert. Wenn PlacementRectangle leer ist, wird das TPopup relativ zum PlacementTarget positioniert. Wenn PlacementTarget nicht angegeben ist, wird der gleiche Effekt wie mit Right erzielt. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

Absolut

Das TPopup wird an der linken oberen Ecke des TPopup.PlacementRectangle relativ zur linken oberen Ecke des Bildschirms positioniert. Die übrigen Platzierungseigenschaften des TPopup werden ignoriert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert.

Mouse

Das TPopup wird relativ zur Mauszeigerposition positioniert. Die linke obere Ecke des TPopup ist die Position des Mauszeigers. Die übrigen Platzierungseigenschaften des TPopup werden ignoriert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert. Mit Size wird die Größe eines TCustomPopupForm-Formulars festgelegt.

MouseCenter

Das TPopup wird relativ zur Mauszeigerposition positioniert. Die Position des Mauszeigers ist die Mitte des oberen Randes des TPopup. Die übrigen Platzierungseigenschaften des TPopup werden ignoriert. Wenn die Bildschirmränder das TPopup verdecken, wird es nicht neu positioniert. Mit Size wird die Größe eines TCustomPopupForm-Formulars festgelegt.

Diese Abbildung zeigt ein Beispiel für den Wert TopCenter.

Rechteck für die Platzierung auf dem Bildschirm

In der Abbildung ist ScreenPlacementRect das in der Farbe Fuchsia dargestellte Rechteck der Schaltfläche Show popup.

Siehe auch