UIElement.CompositeMode 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 mengatur properti yang mendeklarasikan komposisi alternatif dan mode blending untuk elemen dalam tata letak dan jendela induknya. Ini relevan untuk elemen yang terlibat dalam UI XAML campuran / Microsoft DirectX.
public:
property ElementCompositeMode CompositeMode { ElementCompositeMode get(); void set(ElementCompositeMode value); };
ElementCompositeMode CompositeMode();
void CompositeMode(ElementCompositeMode value);
public ElementCompositeMode CompositeMode { get; set; }
var elementCompositeMode = uIElement.compositeMode;
uIElement.compositeMode = elementCompositeMode;
Public Property CompositeMode As ElementCompositeMode
<uiElement CompositeMode="elementCompositeModeMemberName" />
Nilai Properti
Nilai enumerasi. Defaultnya adalah Warisan, tetapi lihat Keterangan.
Keterangan
Jika dibiarkan tidak diatur, nilai default CompositeMode adalah ElementCompositeMode.Inherits. Ini berarti bahwa mode komposit mewarisi dari orang tua berturut-turut di pohon visual. Namun, di akar pohon visual XAML adalah objek akhir yang mewakili hWnd yang biasanya tidak diwakili dalam kode pengguna, dan perilaku CompositeMode yang efektif adalah SourceOver. Oleh karena itu, kecuali beberapa elemen dalam rantai secara khusus diatur ke MinBlend, perilaku render elemen XAML semuanya diwarisi untuk menggunakan SourceOver sebagaimana diwarisi dari jendela induk.
Mengatur CompositeMode ke MinBlend berguna untuk UI XAML /Microsoft DirectX campuran karena merupakan informasi yang digunakan oleh lapisan Komposisi Langsung saat menggabungkan sumber UI. Perilaku MinBlend bisa lebih baik untuk situasi seperti overlay teks.
Menetapkan nilai MinBlend biasanya paling relevan untuk elemen SwapChainPanel , sehingga konten yang dihosting mendapatkan perilaku ini. Tetapi untuk beberapa skenario seperti overlay teks juga dapat diatur pada elemen UI tertentu seperti Rectangle, Canvas dan sebagainya.