MÉTHODE IDWritePaintReader ::SetCurrentGlyph(UINT32,DWRITE_PAINT_ELEMENT*,UINT32,D2D_RECT_F*,DWRITE_PAINT_ATTRIBUTES*) (dwrite_3.h)

Définit le glyphe actuel et positionne le lecteur sur l’élément de peinture racine de l’arborescence visuelle du glyphe sélectionné.

Syntaxe

HRESULT SetCurrentGlyph(
  UINT32                  glyphIndex,
  DWRITE_PAINT_ELEMENT    *paintElement,
  UINT32                  structSize,
  D2D_RECT_F              *clipBox,
  DWRITE_PAINT_ATTRIBUTES *glyphAttributes
);

Paramètres

glyphIndex

Type : UINT32

Index de glyphe pour obtenir la représentation de glyphe de couleur pour.

paintElement

Type : _Out_writes_bytes_(structSize) DWRITE_PAINT_ELEMENT *

Reçoit des informations sur l’élément de peinture racine de l’arborescence visuelle du glyphe.

structSize

Type : UINT32

Taille de la structure DWRITE_PAINT_ELEMENT , en octets.

clipBox

Type : _Out_ D2D_RECT_F *

Reçoit une zone de glyphe précalculée (en ems) pour le glyphe spécifié, s’il est spécifié par la police. Sinon, la zone de glyphe est définie sur un rectangle vide (tous les zéros). Si une zone d’élément non vide est spécifiée, vous devez couper la représentation du glyphe de couleur dans la zone spécifiée.

glyphAttributes

Type : _Out_opt_ DWRITE_PAINT_ATTRIBUTES * = nullptr

Reçoit des attributs de peinture facultatifs pour le glyphe.

Valeur retournée

Code d’erreur HRESULT standard.

Remarques

Si l’index de glyphe spécifié n’est pas un glyphe de couleur, la méthode réussit, mais le membre paintType de la structure DWRITE_PAINT_ELEMENT est défini sur DWRITE_PAINT_TYPE_NONE. Dans ce cas, vous devez dessiner le glyphe d’entrée en tant que glyphe sans couleur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809 (avec SDK d'application Windows 1.2 ou version ultérieure)
En-tête	dwrite_3.h