ISystemBackdropController.SetTarget Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
SetTarget(WindowId, CompositionTarget) |
Подключает системный фоновый контроллер к объекту |
SetTarget(CoreWindow, CompositionTarget) |
Подключает системный фоновой контроллер к указанному |
SetTarget(WindowId, CompositionTarget)
Подключает системный фоновый контроллер к объекту HWND
или AppWindow
с указанным идентификатором WindowId.
public:
bool SetTarget(WindowId windowId, CompositionTarget ^ desktopWindowTarget);
/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("SetTargetWithWindowId")]
bool SetTarget(WindowId const& windowId, CompositionTarget const& desktopWindowTarget);
[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("SetTargetWithWindowId")]
public bool SetTarget(WindowId windowId, CompositionTarget desktopWindowTarget);
function setTarget(windowId, desktopWindowTarget)
Public Function SetTarget (windowId As WindowId, desktopWindowTarget As CompositionTarget) As Boolean
Параметры
- windowId
- WindowId
Идентификатор HWND или AppWindow для подключения.
- desktopWindowTarget
- CompositionTarget
Целевой объект композиции для подключения.
Возвращаемое значение
bool
true
если контроллеру удалось настроить материал в качестве системного фона; в противном случае — false
.
- Атрибуты
Примеры
В этом примере показано, как нарисовать материал Mica в окне приложения Win32 с помощью 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);
}
Комментарии
Используйте этот метод для подключения ISystemBackdropController
к Win32 HWND
или AppWindow.
Этот метод должен вызываться в потоке с DispatcherQueue.
При использовании в приложении Win32 для работы акрила рабочего стола требуется, чтобы атрибут окна DWM DWMWA_USE_HOSTBACKDROPBRUSH был задан на верхнем уровне hWnd
.
См. также раздел
Применяется к
SetTarget(CoreWindow, CompositionTarget)
Подключает системный фоновой контроллер к указанному CoreWindow
.
public:
bool SetTarget(CoreWindow ^ coreWindow, CompositionTarget ^ compositionTarget);
/// [Windows.Foundation.Metadata.Overload("SetTargetWithCoreWindow")]
bool SetTarget(CoreWindow const& coreWindow, CompositionTarget const& compositionTarget);
[Windows.Foundation.Metadata.Overload("SetTargetWithCoreWindow")]
public bool SetTarget(CoreWindow coreWindow, CompositionTarget compositionTarget);
function setTarget(coreWindow, compositionTarget)
Public Function SetTarget (coreWindow As CoreWindow, compositionTarget As CompositionTarget) As Boolean
Параметры
- coreWindow
- CoreWindow
Объект , CoreWindow
к которому необходимо подключиться.
- compositionTarget
- CompositionTarget
Целевой объект композиции для подключения.
Возвращаемое значение
bool
true
если контроллеру удалось настроить материал в качестве системного фона; в противном случае — false
.
- Атрибуты
Комментарии
Используйте этот метод для подключения ISystemBackdropController
к CoreWindow.
Этот метод должен вызываться в потоке с DispatcherQueue.