ISystemBackdropController.SetTarget Méthode

Définition

Espace de noms:

Microsoft.UI.Composition.SystemBackdrops

Surcharges

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

SetTarget(WindowId, CompositionTarget)

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

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

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.

Attributs

DefaultOverloadAttribute OverloadAttribute

Exemples

Cet exemple montre comment dessiner le matériau Mica 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::MicaController micaController = winrt::MicaController();
    return micaController.SetTarget(windowId, compositionTarget);
}

Remarques

Utilisez cette méthode pour connecter à ISystemBackdropController 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 un contrôleur d’arrière-plan système au spécifié 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

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.

Attributs

OverloadAttribute

Remarques

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

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