FrameworkPropertyMetadata.AffectsParentArrange Properti
Definisi
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.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti dependensi berpotensi memengaruhi pass pengaturan tata letak elemen induknya selama operasi mesin tata letak.
public:
property bool AffectsParentArrange { bool get(); void set(bool value); };
public bool AffectsParentArrange { get; set; }
member this.AffectsParentArrange : bool with get, set
Public Property AffectsParentArrange As Boolean
Nilai Properti
true jika properti dependensi tempat metadata ini ada berpotensi memengaruhi pass pengaturan khusus pada elemen induknya; jika tidak, false. Defaultnya adalah false.
Pengecualian
Metadata telah diterapkan ke operasi properti dependensi, sehingga metadata disegel dan properti metadata tidak dapat diatur.
Keterangan
FrameworkElement dan FrameworkContentElement menyertakan implementasi OnPropertyChanged yang memantau perubahan nilai efektif pada semua properti dependensi yang ada pada elemen. Sebagai bagian dari logika tersebut, properti dependensi yang mengubah nilai efektif dan memiliki metadata dengan AffectsParentArrange diatur ke true akan memulai permintaan yang ditangguhkan untuk membatalkan visual untuk elemen induk.
Umumnya, Anda tidak perlu melaporkan perubahan FrameworkElement properti ke elemen induk menggunakan AffectsParentArrange karena elemen itu sendiri sudah memiliki miliknya sendiri AffectsArrange sebagai true. Itu biasanya cukup, karena perubahan pada elemen turunan umumnya memulai pengaturan induk jika sesuai.
AffectsParentArrange terkadang digunakan untuk FrameworkContentElement kelas turunan. Dalam hal ini, elemen turunan menetapkan properti, tetapi FrameworkContentElement kelas turunan tidak mengontrol penyajiannya sendiri. Penyajian ditangani oleh FrameworkElement elemen induk yang berfungsi sebagai host konten. Misalnya, perubahan pada nilai FixedPage.Left properti terlampir oleh elemen anak membatalkan pengaturan induk, karena posisi anak dalam induk harus diubah. Oleh karena itu, FixedPage.Left properti terlampir memiliki metadata di mana AffectsParentArrange adalah true. Contoh lain adalah Padding; ketika properti ini berubah, induk mungkin mengubah posisi anak, tergantung pada ruang yang tersedia.
Karena implementasi tingkat kerangka kerja WPF ini sudah ada, Anda biasanya tidak perlu mencari properti dependensi kecuali AffectsParentArrange Anda mengganti atau memodifikasi perilaku tata letak tingkat kerangka kerja WPF secara substansial.
Implementasi kustom OnPropertyChanged mungkin memilih untuk memiliki perilaku serupa untuk perubahan properti dependensi di mana AffectsParentArrange adalah true.
Properti pada kelas turunan PropertyMetadata apa pun biasanya didefinisikan dalam model objek sebagai baca-tulis. Hal ini agar dapat disesuaikan setelah inisialisasi instans. Namun, setelah metadata digunakan sebagai bagian dari panggilan ke Register, , AddOwneratau OverrideMetadata, sistem properti akan menyegel instans metadata dan properti yang menyampaikan spesifikasi metadata sekarang dianggap tidak dapat diubah. Mencoba mengatur properti ini setelah IsSealed ada true pada instans metadata ini akan menimbulkan pengecualian.
Penggunaan Teks XAML
Anggota kelas ini biasanya tidak digunakan dalam XAML.