DesktopAcrylicController.SetTarget Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
SetTarget(WindowId, CompositionTarget) |
Подключает этот системный фоновый контроллер к объекту или |
SetTarget(CoreWindow, CompositionTarget) |
Подключает этот системный фоновой контроллер к указанному |
SetTarget(WindowId, CompositionTarget)
Подключает этот системный фоновый контроллер к объекту или AppWindow
с указанным идентификаторомHWND
WindowId.
public:
virtual bool SetTarget(WindowId windowId, CompositionTarget ^ desktopWindowTarget) = SetTarget;
/// [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
.
Реализации
- Атрибуты
Примеры
В этом примере показано, как нарисовать акриловый материал рабочего стола в окне приложения Win32 с помощью C++/WinRT.
bool SetupBackdrop(winrt::Microsoft::UI::WindowId windowId, winrt::Windows::UI::Composition::CompositionTarget compositionTarget)
{
winrt::Microsoft::UI::Composition::SystemBackdrops::DesktopAcrylicController desktopAcrylicController = winrt::DesktopAcrylicController();
return desktopAcrylicController.SetTarget(windowId, compositionTarget);
}
Комментарии
Используйте этот метод для подключения DesktopAcrylicController
к Win32 HWND
или AppWindow.
Этот метод должен вызываться в потоке с DispatcherQueue.
При использовании в приложении Win32 акрил рабочего стола для работы требует, чтобы атрибут окна DWM DWMWA_USE_HOSTBACKDROPBRUSH был задан на верхнем уровне hWnd
.
См. также раздел
Применяется к
SetTarget(CoreWindow, CompositionTarget)
Подключает этот системный фоновой контроллер к указанному CoreWindow
объекту .
public:
virtual bool SetTarget(CoreWindow ^ coreWindow, CompositionTarget ^ compositionTarget) = SetTarget;
/// [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
.
Реализации
- Атрибуты
Комментарии
Используйте этот метод для подключения DesktopAcrylicController
к CoreWindow.
Этот метод должен вызываться в потоке с DispatcherQueue.