DesktopAcrylicController.SetTarget Méthode

Définition

Espace de noms:

Microsoft.UI.Composition.SystemBackdrops

Surcharges

SetTarget(WindowId, CompositionTarget)	Connecte ce contrôleur d’arrière-plan système à un HWND ou AppWindow avec le WindowId spécifié.
SetTarget(CoreWindow, CompositionTarget)	Connecte ce contrôleur de fond système au spécifié CoreWindow.

SetTarget(WindowId, CompositionTarget)

Connecte ce contrôleur d’arrière-plan système à un HWND ou AppWindow avec le WindowId spécifié.

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

Paramètres

windowId

WindowId

Identificateur auquel le HWND ou AppWindow doit se connecter.

desktopWindowTarget

CompositionTarget

Cible de composition à laquelle se connecter.

Retours

Boolean

bool

true si le contrôleur a été en mesure de configurer le matériel comme toile de fond du système; sinon, false.

Implémente

SetTarget(WindowId, CompositionTarget)

Attributs

DefaultOverloadAttribute OverloadAttribute

Exemples

Cet exemple montre comment dessiner le matériau acrylique de bureau dans une fenêtre d’application Win32 à l’aide de 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);
}

Remarques

Utilisez cette méthode pour connecter à DesktopAcrylicController un Win32 HWND ou à un AppWindow.

Cette méthode doit être appelée sur un thread avec dispatcherQueue.

Lorsqu’il est utilisé dans une application Win32, l’acrylique de bureau nécessite que l’attribut de fenêtre DWM DWMWA_USE_HOSTBACKDROPBRUSH soit défini au niveau hWnd supérieur pour fonctionner.

Voir aussi

• Gérer les fenêtres d’application

SetTarget(CoreWindow, CompositionTarget)

Connecte ce contrôleur de fond système au spécifié 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

Paramètres

coreWindow

CoreWindow

CoreWindow auquel se connecter.

compositionTarget

CompositionTarget

Cible de composition à laquelle se connecter.

Retours

Boolean

bool

true si le contrôleur a été en mesure de configurer le matériel comme toile de fond du système; sinon, false.

Implémente

SetTarget(CoreWindow, CompositionTarget)

Attributs

OverloadAttribute

Remarques

Utilisez cette méthode pour connecter à DesktopAcrylicController un CoreWindow.

Cette méthode doit être appelée sur un thread avec dispatcherQueue.