DesktopAcrylicController.SetTarget Метод

Определение

Пространство имен:

Microsoft.UI.Composition.SystemBackdrops

Перегрузки

SetTarget(WindowId, CompositionTarget)	Подключает этот системный фоновый контроллер к объекту или AppWindow с указанным идентификаторомHWND WindowId.
SetTarget(CoreWindow, CompositionTarget)	Подключает этот системный фоновой контроллер к указанному CoreWindowобъекту .

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

Целевой объект композиции, к которому необходимо подключиться.

Возвращаемое значение

Boolean

bool

true если контроллер смог настроить материал в качестве системного фона; в противном случае — false.

Реализации

SetTarget(WindowId, CompositionTarget)

Атрибуты

DefaultOverloadAttribute OverloadAttribute

Примеры

В этом примере показано, как нарисовать акриловый материал рабочего стола в окне приложения 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

Целевой объект композиции, к которому необходимо подключиться.

Возвращаемое значение

Boolean

bool

true если контроллер смог настроить материал в качестве системного фона; в противном случае — false.

Реализации

SetTarget(CoreWindow, CompositionTarget)

Атрибуты

OverloadAttribute

Комментарии

Используйте этот метод для подключения DesktopAcrylicController к CoreWindow.

Этот метод должен вызываться в потоке с DispatcherQueue.