ISystemBackdropController 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

Menyediakan metode untuk menyambungkan pengontrol latar belakang sistem ke jendela.

public interface class ISystemBackdropController : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
struct ISystemBackdropController : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
public interface ISystemBackdropController : System.IDisposable

Public Interface ISystemBackdropController
Implements IDisposable

Turunan: Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.ISystemBackdropControllerWithTargets

Microsoft.UI.Composition.SystemBackdrops.MicaController

Atribut: ContractVersionAttribute GuidAttribute

Penerapan: IClosable IDisposable

Contoh

Contoh ini menunjukkan cara menggambar materi Windows 11 Mica baru di jendela aplikasi Win32 menggunakan C++/WinRT.

bool SetupBackdrop(winrt::Microsoft::UI::WindowId windowId, winrt::Windows::UI::Composition::CompositionTarget compositionTarget)
{
    winrt::Microsoft::UI::Composition::SystemBackdrops::MicaController micaController = winrt::MicaController();
    return micaController.SetTarget(windowId, compositionTarget);
}

Keterangan

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

Anda dapat menggambar materi di bagian belakang konten Anda dengan membuat yang sesuai ISystemBackdropController dan menyediakan jendela dan CompositionTarget Anda ke metode SetTarget pengontrol. Jika SetTarget berhasil dan mengembalikan true, pengontrol menangani semua penanganan material, termasuk penyajian fallback dan semua kebijakan sistem. Jika SetTarget gagal dan kembali false, itu berarti pengontrol tidak dapat mengatur bahan yang diinginkan sebagai latar belakang sistem, dan tidak ada perubahan yang dilakukan pada CompositionTarget.

Bahan digambar menggunakan WINDOWS.UI.Composition API, sehingga CompositionTarget diperlukan di mana materi akan digambar paling belakang di belakang konten aplikasi lainnya. Konten aplikasi apa pun yang memiliki transparansi akan ditampilkan ke materi yang dipilih.

Metode

Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola.
SetTarget(CoreWindow, CompositionTarget)	Menyambungkan pengontrol latar belakang sistem ke yang ditentukan `CoreWindow`.
SetTarget(WindowId, CompositionTarget)	Menyambungkan pengontrol latar belakang sistem ke `HWND` atau `AppWindow` dengan WindowId yang ditentukan.

Berlaku untuk

Bagikan melalui