FMX.Controls.TPlacement

提供: RAD Studio API Documentation
移動先: 案内検索

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 };

プロパティ

種類 可視性 ソース ユニット
enum public
FMX.Controls.pas
FMX.Controls.hpp
FMX.Controls FMX.Controls


説明

TPlacement は、ある点に対してポップアップ コンポーネントがどう配置されるかを定義します。

ポップアップ コンポーネントは、TPopup コントロールと TCustomPopupForm フォームのどちらでもかまいません。ポップアップ コンポーネントは、ScreenPlacementRectPlacementRectanglePlacementTarget のプロパティが示す四角形、画面、マウス(ポインティング デバイス)位置のいずれかを基準として、相対的な位置に配置することができます。

TPlacement の取り得る値は以下のとおりです。

意味

Bottom

TPopup は、PlacementRectangle の下端から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。TCustomPopupForm フォームが画面に収まらない場合には、PlacementRectangle の上に配置されます。
オフセットが指定されていない場合には、TPopup の左上の角が PlacementRectangle の左下の角と揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTargetPlacementRectangle も指定されていない場合には、TPopup は画面の左上の角に対する相対位置に配置されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。

Top

TPopup は、PlacementRectangle の上端から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の左下の角が PlacementRectangle の左上の角と揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTargetPlacementRectangle も指定されていない場合には、TPopup は画面の左上の角に対する相対位置に配置されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。

Left

TPopup は、PlacementRectangle の左端から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の右上の角が PlacementRectangle の左上の角と揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTargetPlacementRectangle も指定されていない場合には、TPopup は画面の左上の角に対する相対位置に配置されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。

Right

TPopup は、PlacementRectangle の右端から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の左上の角が PlacementRectangle の右上の角と揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTargetPlacementRectangle も指定されていない場合には、TPopup は画面の左上の角に対する相対位置に配置されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。

Center

TPopup は、PlacementRectangle の中央から、指定された縦方向横方向のオフセットだけずらした場所に配置されます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTargetPlacementRectangle も指定されていない場合には、TPopup の中央が画面の左上の角になるよう配置されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。

BottomCenter

TPopup は、PlacementRectangle の下辺の中央から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の上辺が PlacementRectangle の下辺と中央で揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTarget が指定されていない場合には、Bottom と同じ結果になります。画面の端で TPopup が隠れる場合でも、再配置は行われません。

TopCenter

TPopup は、PlacementRectangle の上辺の中央から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の下辺が PlacementRectangle の上辺と中央で揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTarget が指定されていない場合には、Top と同じ結果になります。画面の端で TPopup が隠れる場合でも、再配置は行われません。

LeftCenter

TPopup は、PlacementRectangle の左辺の中央から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の右辺が PlacementRectangle の左辺と中央で揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTarget が指定されていない場合には、Left と同じ結果になります。画面の端で TPopup が隠れる場合でも、再配置は行われません。

RightCenter

TPopup は、PlacementRectangle の右辺の中央から、指定された縦方向横方向のオフセットだけずらした場所に、PlacementRectangle の外に向かって配置されます。オフセットが指定されていない場合には、TPopup の左辺が PlacementRectangle の右辺と中央で揃えられます。PlacementRectangle が空の場合には、TPopupPlacementTarget に対する相対位置に配置されます。PlacementTarget が指定されていない場合には、Right と同じ結果になります。画面の端で TPopup が隠れる場合でも、再配置は行われません。

Absolute

TPopup は、画面の左上の角を起点として、TPopup.PlacementRectangle の左上の角に配置されます。TPopup のその他の配置プロパティは無視されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。

Mouse

TPopup はマウスの位置を起点として配置されます。TPopup の左上の角がマウスの位置と揃えられます。TPopup のその他の配置プロパティは無視されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。Size によって TCustomPopupForm フォームのサイズが決まります。

MouseCenter

TPopup はマウスの位置を起点として配置されます。マウスの位置が TPopup の上辺の中央になります。TPopup のその他の配置プロパティは無視されます。画面の端で TPopup が隠れる場合でも、再配置は行われません。Size によって TCustomPopupForm フォームのサイズが決まります。

次の図は、値が TopCenter であるときの様子を示しています。

画面上の配置の基準となる四角形

この図における ScreenPlacementRect は、[Show popup]ボタンの明るい赤紫色の四角形です。

関連項目