Bahasa

ISystemBackdropController Antarmuka

Definisi

Ruang nama:
Microsoft.UI.Composition.SystemBackdrops
Edit

Menyediakan metode untuk menyambungkan pengontrol backdrop 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
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

Backdrop sistem pada dasarnya adalah CompositionBrush yang mendefinisikan bahan UI seperti Acrylic atau Mica. Kuas ini digambar oleh komposit 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.

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 rendering fallback dan semua kebijakan sistem. Jika SetTarget gagal dan mengembalikan false, itu berarti pengontrol tidak dapat mengatur materi yang diinginkan sebagai backdrop sistem, dan tidak ada perubahan yang dilakukan pada CompositionTarget.

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

Metode

Nama Deskripsi
Dispose()

Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
SetTarget(CoreWindow, CompositionTarget)

Menyambungkan pengontrol backdrop sistem ke yang ditentukan CoreWindow.
SetTarget(WindowId, CompositionTarget)

Menyambungkan pengontrol backdrop sistem ke HWND atau AppWindow dengan WindowId yang ditentukan.

Berlaku untuk