Share via


FrameworkElement.Margin Properti

Definisi

Mendapatkan atau mengatur margin luar elemen.

public:
 property System::Windows::Thickness Margin { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };
public System.Windows.Thickness Margin { get; set; }
member this.Margin : System.Windows.Thickness with get, set
Public Property Margin As Thickness

Nilai Properti

Menyediakan nilai margin untuk elemen . Nilai default adalah Thickness dengan semua properti sama dengan 0 (nol).

Keterangan

Margin adalah ruang antara elemen ini dan elemen lain yang akan berdingin ketika tata letak membuat antarmuka pengguna (UI). Elemen bersama mungkin merupakan elemen serekan (seperti elemen lain dalam kumpulan kontrol induk umum), atau mungkin juga merupakan induk elemen ini.

Margin ditetapkan sebagai Thickness struktur daripada sebagai angka sehingga margin dapat diatur secara asimetris. Struktur itu Thickness sendiri mendukung konversi jenis string sehingga Anda juga dapat menentukan asimetris Margin dalam sintaks atribut XAML.

Margin bukan nol menerapkan ruang di luar tata letak ActualWidth elemen dan ActualHeight.

Margin bersifat aditif untuk elemen saudara dalam tata letak; misalnya, dua elemen yang berdampingan keduanya dengan margin 30 diatur pada tepi yang berdampingan akan memiliki 60 unit ruang di antaranya.

Elemen yang memiliki margin yang ditetapkan biasanya tidak akan membatasi ukuran yang ditentukan Margin jika ruang persegi panjang yang dialokasikan tidak cukup besar untuk margin ditambah area konten elemen. Area konten elemen akan dibatasi sebagai gantinya ketika tata letak dihitung. Satu-satunya kasus di mana margin akan dibatasi juga adalah jika konten sudah dibatasi hingga nol.

Penggunaan Atribut XAML

<object Margin="left,top,right,bottom"/>  

-atau-

<object Margin="left,top"/>  

-atau-

<object Margin="thicknessReference"/>  

Penggunaan Elemen Properti XAML

<object>  
  <object.Margin>  
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>  
  </object.Margin>  
</object>  

Nilai XAML

kiri, atas, kanan, bawah
Nilai angka antara 0 dan PositiveInfinity yang menentukan empat kemungkinan properti Thickness dimensi struktur.

Penggunaan atribut juga akan menerima nilai singkatan yang berlaku dalam urutan yang disediakan, simetris, dan logis. Misalnya, Margin="20" akan ditafsirkan berarti dengan semua properti diatur Thickness ke 20. Margin="20,50" akan ditafsirkan dengan rata-rata Thickness dengan Left dan Right diatur ke 20, dan Top dan Bottom diatur ke 50.

Unit default untuk Thickness ukuran adalah unit independen perangkat (1/96 inci). Anda juga dapat menentukan unit lain dengan menambahkan string cmjenis unit , , inatau pt ke ukuran apa pun.

Nilai angka yang disediakan sebagai atribut XAML tidak perlu menentukan titik desimal (0 dapat diterima, tidak harus disediakan sebagai 0,0). Untuk informasi selengkapnya tentang penggunaan Extensible Application Markup Language (XAML), lihat Thickness.

ketebalanReferensi
Referensi objek ke yang sudah ada Thickness. Ini mungkin referensi }, , atau } . Untuk informasi selengkapnya tentang penggunaan Extensible Application Markup Language (XAML), lihat Thickness.

Informasi Properti Dependensi

Bidang pengidentifikasi MarginProperty
Properti metadata diatur ke true AffectsMeasure

Berlaku untuk

Lihat juga