ISystemBackdropController.SetTarget Método

Definição

Namespace:

Microsoft.UI.Composition.SystemBackdrops

Sobrecargas

SetTarget(WindowId, CompositionTarget)	Conecta um controlador de cenário do sistema a um HWND ou AppWindow com o WindowId especificado.
SetTarget(CoreWindow, CompositionTarget)	Conecta um controlador de cenário do sistema ao especificado CoreWindow.

SetTarget(WindowId, CompositionTarget)

Conecta um controlador de cenário do sistema a um HWND ou AppWindow com o WindowId especificado.

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

Parâmetros

windowId

WindowId

O identificador do HWND ou appWindow ao qual se conectar.

desktopWindowTarget

CompositionTarget

O destino de composição ao qual se conectar.

Retornos

Boolean

bool

true se o controlador foi capaz de configurar o material como um pano de fundo do sistema; caso contrário, false.

Atributos

DefaultOverloadAttribute OverloadAttribute

Exemplos

Este exemplo mostra como desenhar o material Mica em uma janela do aplicativo Win32 usando 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);
}

Comentários

Use esse método para conectar o a ISystemBackdropController um Win32 HWND ou um AppWindow.

Esse método deve ser chamado em um thread com um DispatcherQueue.

Quando usado em um aplicativo Win32, o acrílico da área de trabalho requer que o atributo de janela DWM DWMWA_USE_HOSTBACKDROPBRUSH seja definido no nível hWnd superior para funcionar.

Confira também

• Gerenciar janelas do aplicativo

SetTarget(CoreWindow, CompositionTarget)

Conecta um controlador de cenário do sistema ao especificado 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

Parâmetros

coreWindow

CoreWindow

O CoreWindow ao qual se conectar.

compositionTarget

CompositionTarget

O destino de composição ao qual se conectar.

Retornos

Boolean

bool

true se o controlador foi capaz de configurar o material como um pano de fundo do sistema; caso contrário, false.

Atributos

OverloadAttribute

Comentários

Use esse método para conectar o ISystemBackdropController a um CoreWindow.

Esse método deve ser chamado em um thread com um DispatcherQueue.