FrameworkElement.VerticalAlignment Properti

Definisi

Ruang nama:

Windows.UI.Xaml

Mendapatkan atau mengatur karakteristik perataan vertikal yang diterapkan ke FrameworkElement saat disusun dalam objek induk seperti kontrol panel atau item.

public:
 property VerticalAlignment VerticalAlignment { VerticalAlignment get(); void set(VerticalAlignment value); };

VerticalAlignment VerticalAlignment();

void VerticalAlignment(VerticalAlignment value);

public VerticalAlignment VerticalAlignment { get; set; }

var verticalAlignment = frameworkElement.verticalAlignment;
frameworkElement.verticalAlignment = verticalAlignment;

Public Property VerticalAlignment As VerticalAlignment

<frameworkElement VerticalAlignment="verticalAlignmentMemberName"/>

Nilai Properti

VerticalAlignment

Pengaturan perataan vertikal, sebagai nilai enumerasi. Defaultnya adalah Stretch.

Contoh

Dalam contoh ini, Pusat nilai ditetapkan ke HorizontalAlignment dan VerticalAlignment untuk memosisikan elemen TextBlock di tengah sel Kisi .

<Grid x:Name="LayoutRoot" Background="Coral" Width="300" Height="100">
    <Grid.ColumnDefinitions>
        <ColumnDefinition />
        <ColumnDefinition />
    </Grid.ColumnDefinitions>
    <Grid.RowDefinitions>
        <RowDefinition />
        <RowDefinition />
    </Grid.RowDefinitions>
    <TextBlock Grid.Column="0" Grid.Row="0" Text="First Name" 
        HorizontalAlignment="Center" VerticalAlignment="Center" />
    <TextBlock Grid.Column="0" Grid.Row="1" Text="Last Name" 
        HorizontalAlignment="Center" VerticalAlignment="Center" />
    <TextBox Grid.Column="1" Grid.Row="0" />
    <TextBox Grid.Column="1" Grid.Row="1" />

</Grid>

Keterangan

Properti perataan dimaksudkan untuk mengisyaratkan tata letak yang diinginkan ke kontainer tata letak adaptif. Mereka biasanya diatur pada anak-anak FrameworkElement dan ditafsirkan oleh induk kontainer FrameworkElement lain (biasanya kelas turunan ContentControl atau kelas turunan Panel , atau mungkin penyaji). Mengatur properti perataan pada elemen turunan tidak menjamin bahwa apa pun terjadi; perilaku tergantung pada komposisi tata letak dan elemen induk yang terlibat.

Ketika properti Tinggi dan Lebar secara eksplisit diatur atau dihitung pada objek, pengukuran tersebut lebih penting untuk logika tata letak umum, dan dapat membatalkan efek pengaturan VerticalAlignment ke Stretch. Properti batasan tata letak (seperti MaxHeight) juga memengaruhi ukuran tata letak maksimum atau minimum untuk situasi tata letak Stretch . Stretch adalah default sehingga lebih mudah untuk menggunakan teknik tata letak adaptif dalam kasus di mana tidak ada pengukuran eksplisit. Tetapi jika ada Tinggi dan Lebar atau kliping, tata letak bertindak seolah-olah nilainya adalah Atas untuk VerticalAlignment, biasanya Kiri untuk HorizontalAlignment (Kanan untuk info budaya kanan-ke-kiri atau nilai FlowDirection eksplisit). Untuk informasi selengkapnya, lihat Perataan, margin, dan padding.

Kanvas tidak menggunakan VerticalAlignment saat menyusun tata letak, karena Kanvas didasarkan pada posisi absolut. Secara umum, nilai VerticalAlignment berpotensi diperlakukan secara berbeda oleh objek apa pun yang mampu memiliki satu atau beberapa objek FrameworkElement sebagai konten anak. Setiap objek induk tersebut dapat memiliki logika tata letaknya sendiri.

Setiap elemen UI XAML mungkin menerapkan properti ini secara berbeda berdasarkan setter Gaya untuk gaya implisit. "Nilai default" yang jelas untuk VerticalAlignment di setiap elemen UI dapat berbeda. Misalnya, kontrol Tombol dimulai dengan pusat nilai. Jika elemen UI adalah kontrol, nilai VerticalAlignment mungkin juga memengaruhi templat visual kontrol.

Dalam kontrol konten, templat kontrol sering menggunakan ekspresi ekstensi markup {TemplateBinding} untuk mengikat properti VerticalContentAlignment ke properti VerticalAlignment pada beberapa elemen dalam templatnya, seperti penyaji atau elemen yang digunakan sebagai area konten.

Lihat juga

• Width
• HorizontalAlignment
• Perataan, margin, dan padding