FlyoutBase.ShouldConstrainToRootBounds プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ポップアップを XAML ルートの境界内に表示するかどうかを示す値を取得または設定します。
public:
property bool ShouldConstrainToRootBounds { bool get(); void set(bool value); };
bool ShouldConstrainToRootBounds();
void ShouldConstrainToRootBounds(bool value);
public bool ShouldConstrainToRootBounds { get; set; }
var boolean = flyoutBase.shouldConstrainToRootBounds;
flyoutBase.shouldConstrainToRootBounds = boolean;
Public Property ShouldConstrainToRootBounds As Boolean
プロパティ値
bool
XAML ルートの境界内にポップアップを表示する必要がある場合は true。それ以外の場合は false。
Windows の要件
デバイス ファミリ |
Windows 10, version 1903 (10.0.18362.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v8.0 で導入)
|
例
この例では、ポップアップは既定ではルート境界に制限されません。 したがって、ポップアップをボタンの下に配置する要求は、ディスプレイに空きがある限り受け入れられます。 ポップアップはアプリ ウィンドウの外側に表示されます。
<Button Content="Button"
VerticalAlignment="Bottom" HorizontalAlignment="Center">
<Button.Flyout>
<Flyout Placement="Bottom">
<TextBlock Text="Flyout content" />
</Flyout>
</Button.Flyout>
</Button>
![閉じたアプリ バー コントロール](windows.ui.xaml.controls.primitives/images/flyout-not-constrained.png?view=winrt-26100)
この例では、 ShouldConstrainToRootBounds が true に設定されているため、ポップアップはルート境界に制限されます。 そのため、ボタンの下にポップアップを配置する要求は受け付けられません。ポップアップはボタンの上のアプリ ウィンドウ内に表示されます。
<Button Content="Button"
VerticalAlignment="Bottom" HorizontalAlignment="Center">
<Button.Flyout>
<Flyout Placement="Bottom"
ShouldConstrainToRootBounds="True">
<TextBlock Text="Flyout content" />
</Flyout>
</Button.Flyout>
</Button>
![閉じたアプリ バー コントロール](windows.ui.xaml.controls.primitives/images/flyout-constrained.png?view=winrt-26100)
注釈
既定値は、派生型によって異なります。
ポップアップの場合、既定値は ですtrue
。
MenuFlyout と CommandBarFlyout の場合、既定値は ですfalse
。
このプロパティは、デスクトップで実行されているアプリにのみ適用されます。 ポップアップが実際にルート境界に制約されているかどうかをチェックするには、IsConstrainedToRootBounds プロパティをチェックします。
デスクトップ上で実行されているアプリで、このプロパティが true の場合、ポップアップは メイン XAML ウィンドウ ハンドル (HWND) 内に表示されます。 このプロパティが false の場合、ポップアップは独自の最上位レベル HWND に表示されます。 この場合、ポップアップは、メイン アプリ ウィンドウを超えて拡張するように配置される場合があります。
のポップアップ ShouldConstrainToRootBounds = false
が最初に表示されると、ポップアップは独自のウィンドウに配置され、そのコンテキストに表示されます。 表示された後は、 ShouldConstrainToRootBounds
true に戻すことはできません。
XAML ルートは、CoreWindow、XAML アイランド、または AppWindow のいずれかです。