FrameworkPropertyMetadata.AffectsParentMeasure 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 lulus pengukuran tata letak elemen induknya selama operasi mesin tata letak.
public:
property bool AffectsParentMeasure { bool get(); void set(bool value); };
public bool AffectsParentMeasure { get; set; }
member this.AffectsParentMeasure : bool with get, set
Public Property AffectsParentMeasure As Boolean
Nilai Properti
true jika properti dependensi tempat metadata ini ada berpotensi memengaruhi langkah yang diteruskan secara 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 AffectsParentMeasure diatur ke true akan memulai permintaan yang ditangguhkan untuk membatalkan visual untuk elemen induk. Karena implementasi tingkat kerangka kerja WPF ini sudah ada, Anda biasanya tidak perlu mencari properti dependensi kecuali AffectsParentMeasure Anda mengganti atau memodifikasi perilaku tata letak tingkat kerangka kerja WPF secara substansial.
Umumnya, Anda tidak perlu melaporkan perubahan FrameworkElement properti ke elemen induk menggunakan AffectsParentMeasure karena elemen itu sendiri sudah memiliki miliknya sendiri AffectsMeasure sebagai true. Itu biasanya cukup, karena perubahan pada elemen turunan umumnya memulai lulus ukuran induk jika sesuai.
AffectsParentMeasure 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 properti oleh elemen turunan Paragraph.KeepWithNext membatalkan ukuran induk, karena penspasian paragraf relatif mungkin berubah dan mungkin meningkatkan atau mengurangi ukuran host konten. Oleh karena itu, Paragraph.KeepWithNext properti memiliki metadata di mana AffectsParentMeasure adalah true.
Elemen host konten juga sering mencari perubahan dalam properti dependensi di mana AffectsParentMeasure adalah true, sebagai bagian dari logika penyajian host konten. Misalnya, TextBox elemen harus merespons perubahan tertentu dalam teks yang mungkin mengharuskan kotak pembatas itu TextBox sendiri diubah.
Implementasi kustom OnPropertyChanged mungkin memilih untuk memiliki perilaku serupa untuk perubahan properti dependensi di mana AffectsParentMeasure 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.