FlyoutBase.ShouldConstrainToRootBounds Properti

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml.Controls.Primitives

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mendapatkan atau menetapkan nilai yang menunjukkan apakah flyout harus ditampilkan dalam batas akar 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

Nilai Properti

Boolean

bool

true jika flyout harus ditampilkan dalam batas-batas akar XAML; jika tidak, salah.

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1903 (diperkenalkan dalam 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v8.0)

Contoh

Dalam contoh ini, flyout tidak dibatasi untuk batas akar secara default. Oleh karena itu, permintaan untuk menempatkan flyout di bawah tombol dihormati selama ada ruang untuk itu di layar. Flyout ditampilkan di luar jendela aplikasi.

<Button Content="Button"
        VerticalAlignment="Bottom" HorizontalAlignment="Center">
    <Button.Flyout>
        <Flyout Placement="Bottom">
            <TextBlock Text="Flyout content" />
        </Flyout>
    </Button.Flyout>
</Button>

Dalam contoh ini, ShouldConstrainToRootBounds diatur ke true, sehingga flyout dibatasi ke batas akar. Oleh karena itu, permintaan untuk menempatkan flyout di bawah tombol tidak dihormati, dan flyout ditampilkan di dalam jendela aplikasi di atas tombol.

<Button Content="Button"
        VerticalAlignment="Bottom" HorizontalAlignment="Center">
    <Button.Flyout>
        <Flyout Placement="Bottom"
                ShouldConstrainToRootBounds="True">
            <TextBlock Text="Flyout content" />
        </Flyout>
    </Button.Flyout>
</Button>

Keterangan

Nilai default tergantung pada jenis turunannya. Untuk Flyout, defaultnya adalah true. Untuk MenuFlyout dan CommandBarFlyout, defaultnya adalah false.

Properti ini hanya berlaku untuk aplikasi yang berjalan di desktop. Untuk memeriksa apakah flyout benar-benar dibatasi ke batas akar, periksa properti IsConstrainedToRootBounds .

Dalam aplikasi yang berjalan di desktop, ketika properti ini benar, flyout ditampilkan dalam handel jendela XAML utama (HWND). Ketika properti ini salah, flyout ditampilkan di HWND tingkat atasnya sendiri. Dalam hal ini, flyout mungkin diposisikan untuk meluas di luar jendela aplikasi utama.

Saat flyout dengan ShouldConstrainToRootBounds = false pertama kali ditampilkan, flyout ditempatkan di jendelanya sendiri dan ditampilkan dalam konteks tersebut. Setelah ditampilkan, ShouldConstrainToRootBounds tidak dapat diatur kembali ke true.

Akar XAML mungkin coreWindow, pulau XAML, atau AppWindow.

Berlaku untuk