ISystemBackdropControllerWithTargets Antarmuka

Referensi

Definisi

Ruang nama:: Microsoft.UI.Composition.SystemBackdrops

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.

Edit

Memperluas antarmuka ISystemBackdropController dengan kemampuan untuk mengelola target backdrop sistem, konfigurasinya, dan perubahan statusnya.

public interface class ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65537)]
/// [Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
struct ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65537)]
[Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
public interface ISystemBackdropControllerWithTargets : ISystemBackdropController, System.IDisposable

Public Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController

Turunan: Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

Atribut: ContractVersionAttribute GuidAttribute

Penerapan: ISystemBackdropController IClosable IDisposable

Keterangan

Latar belakang sistem pada dasarnya adalah CompositionBrush yang mendefinisikan bahan UI seperti Acrylic atau Mica. Kuas ini digambar oleh komppositori sistem. Pengontrol backdrop sistem adalah objek yang merangkum penyajian material backdrop sistem serta penanganan kebijakan sistem untuk materi yang diberikan. Setiap bahan memiliki pengontrolnya sendiri.

Antarmuka menyediakan ISystemBackdropControllerWithTargets kontrol yang lebih terperinci dari target ICompositionSupportsSystemBackdrop . Target dapat ditambahkan dan dihapus kapan saja. Semua target harus berbagi Compositor yang sama. Menambahkan target yang mengharapkan yang berbeda Compositor akan menyebabkan pengecualian argumen yang tidak valid dilemparkan dan target baru tidak akan ditambahkan.

Antarmuka ISystemBackdropController tidak menyediakan mekanisme bagi Anda untuk memberikan informasi kebijakan materi khusus aplikasi, dan sebaliknya memerlukan objek jendela aplikasi. Sebaliknya, ISystemBackdropControllerWithTargets antarmuka memerlukan objek SystemBackdropConfiguration yang memungkinkan Anda menentukan kebijakan materi khusus aplikasi Anda sendiri.

Pengontrol backdrop sistem hanya akan merender bahan jika telah disediakan SystemBackdropConfiguration objek bersama dengan setidaknya satu target. Jika tidak, itu tidak akan merender apa pun. Menghapus target akan membuatnya berhenti merender bahan. Menghapus semua target akan menonaktifkan pengontrol hingga setidaknya satu target ditambahkan.

Properti

State

Mendapatkan status pengontrol latar belakang sistem saat ini.

Metode

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Menambahkan target backdrop sistem yang ditentukan untuk menggambar bahan.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
RemoveAllSystemBackdropTargets()	Menghapus semua target latar belakang sistem.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Menghapus target latar belakang sistem yang ditentukan.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	Mengatur kebijakan khusus aplikasi yang akan diterapkan ke pengontrol backdrop sistem.
SetTarget(CoreWindow, CompositionTarget)	Menyambungkan pengontrol backdrop sistem ke yang ditentukan `CoreWindow`. (Diperoleh dari ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	Menyambungkan pengontrol backdrop sistem ke `HWND` atau `AppWindow` dengan WindowId yang ditentukan. (Diperoleh dari ISystemBackdropController)

Acara

StateChanged

Terjadi ketika status backdrop sistem telah berubah.

Berlaku untuk

Bagikan melalui