FrameworkElement.VerticalAlignment Properti

Definisi

Ruang nama:

Microsoft.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. Default adalah Stretch.

Contoh

Dalam contoh ini, nilai Center 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 lain FrameworkElement (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 Stretch situasi tata letak. Stretch adalah default sehingga lebih mudah untuk menggunakan teknik tata letak adaptif dalam kasus di mana tidak ada pengukuran eksplisit. Tetapi jika ada Height dan Width atau kliping, tata letak bertindak seolah-olah nilainya adalah Top untuk VerticalAlignment, biasanya Left untuk HorizontalAlignment (Right untuk info budaya kanan-ke-kiri atau nilai FlowDirection eksplisit). Untuk informasi selengkapnya, lihat Perataan, margin, dan padding.

Kanvas tidak digunakan VerticalAlignment saat menyusun tata letak, karena Canvas 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 nilai Center. Jika elemen UI adalah kontrol, nilainya VerticalAlignment mungkin juga memengaruhi templat visual kontrol.

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

Lihat juga

• Width
• HorizontalAlignment
• Perataan, margin, dan padding