IDWriteTextRenderer ::D rawGlyphRun, méthode (dwrite.h)

Article
03/01/2024

IDWriteTextLayout ::Draw appelle cette fonction pour demander au client de restituer une exécution de glyphes.

Syntaxe

HRESULT DrawGlyphRun(
       void                               *clientDrawingContext,
       FLOAT                              baselineOriginX,
       FLOAT                              baselineOriginY,
       DWRITE_MEASURING_MODE              measuringMode,
  [in] DWRITE_GLYPH_RUN const             *glyphRun,
  [in] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
       IUnknown                           *clientDrawingEffect
);

Paramètres

clientDrawingContext

Type : void*

Contexte de dessin défini par l’application passé à IDWriteTextLayout ::D raw.

baselineOriginX

Type : FLOAT

Emplacement des pixels (coordonnée X) à l’origine de base de l’exécution du glyphe.

baselineOriginY

Type : FLOAT

Emplacement des pixels (coordonnée Y) à l’origine de base de l’exécution du glyphe.

measuringMode

Type : DWRITE_MEASURING_MODE

Méthode de mesure des glyphes en cours d’exécution, utilisée avec les autres propriétés pour déterminer le mode de rendu.

[in] glyphRun

Type : const DWRITE_GLYPH_RUN*

Pointeur vers l’exécution du glyphe instance à afficher.

[in] glyphRunDescription

Type : const DWRITE_GLYPH_RUN_DESCRIPTION*

Pointeur vers la description de l’exécution du glyphe instance qui contient les propriétés des caractères associés à cette exécution.

clientDrawingEffect

Type : IUnknown*

Effets de dessin définis par l’application pour le rendu des glyphes. En règle générale, cet argument représente des effets tels que le pinceau de premier plan remplissant l’intérieur du texte.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La fonction IDWriteTextLayout ::D raw appelle cette fonction de rappel avec toutes les informations sur les glyphes à restituer. L’application implémente ce rappel en déléguant principalement l’appel à l’API graphique de la plateforme sous-jacente, comme Direct2D , pour dessiner des glyphes sur le contexte de dessin. Une application qui utilise GDI peut implémenter ce rappel en termes de la méthode IDWriteBitmapRenderTarget ::D rawGlyphRun .

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 Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteTextRenderer

Partager via