D2D1_HWND_RENDER_TARGET_PROPERTIES structure (d2d1.h)

Article
02/28/2024

Contient les options HWND, taille des pixels et présentation d’un ID2D1HwndRenderTarget.

Syntaxe

typedef struct D2D1_HWND_RENDER_TARGET_PROPERTIES {
  HWND                 hwnd;
  D2D1_SIZE_U          pixelSize;
  D2D1_PRESENT_OPTIONS presentOptions;
} D2D1_HWND_RENDER_TARGET_PROPERTIES;

Membres

hwnd

Type : HWND

HWND vers lequel la cible de rendu émet la sortie de ses commandes de dessin.

pixelSize

Type : D2D1_SIZE_U

Taille de la cible de rendu, en pixels.

presentOptions

Type : D2D1_PRESENT_OPTIONS

Valeur qui spécifie si la cible de rendu conserve l’image une fois qu’elle est présentée et si la cible de rendu attend que l’appareil s’actualise avant de la présenter.

Remarques

Utilisez cette structure lorsque vous appelez la méthode CreateHwndRenderTarget pour créer un id2D1HwndRenderTarget.

Pour des raisons pratiques, Direct2D fournit la fonction D2D1 ::HwndRenderTargetProperties pour créer de nouvelles structures D2D1_HWND_RENDER_TARGET_PROPERTIES .

Exemples

L’exemple suivant utilise la méthode CreateHwndRenderTarget pour créer un ID2D1HwndRenderTarget. Il utilise la fonction d’assistance D2D1 ::HwndRenderTargetProperties pour créer une structure D2D1_HWND_RENDER_TARGET_PROPERTIES qui contient un handle pour une fenêtre et la taille de la zone de dessin. Étant donné qu’aucune valeur D2D1_PRESENT_OPTIONS n’est spécifiée, la fonction utilise la valeur par défaut , D2D1_PRESENT_OPTIONS_NONE.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

Le code a été omis dans cet exemple.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
En-tête	d2d1.h

Voir aussi

ID2D1HwndRenderTarget

Partager via