IDWriteFactory ::CreateGdiCompatibleTextLayout, méthode (dwrite.h)

Prend une chaîne, un format et les contraintes associées, et produit un objet représentant le résultat, mis en forme pour une résolution d’affichage et un mode de mesure particulier.

Syntaxe

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

Paramètres

[in] string

Type : const WCHAR*

Tableau de caractères qui contient la chaîne à partir de laquelle créer un objet IDWriteTextLayout . Ce tableau doit être de longueur stringLength et peut contenir des caractères NULL incorporés.

stringLength

Type : UINT32

Longueur de la chaîne, en nombre de caractères.

textFormat

Type : IDWriteTextFormat*

Objet de mise en forme de texte à appliquer à la chaîne.

layoutWidth

Type : FLOAT

Largeur de la zone de disposition.

layoutHeight

Type : FLOAT

Hauteur de la zone de disposition.

pixelsPerDip

Type : FLOAT

Nombre de pixels physiques par DIP (pixel indépendant de l’appareil). Par exemple, si le rendu sur un appareil de 96 PPP pixelsPerDip est 1. Si le rendu sur un appareil de 120 ppp pixelsPerDip est de 1,25 (120/96).

[in, optional] transform

Type : const DWRITE_MATRIX*

Transformation facultative appliquée aux glyphes et à leurs positions. Cette transformation est appliquée après que la mise à l’échelle spécifie la taille de police et les pixels par DIP.

useGdiNatural

Type : BOOL

Indique à la disposition du texte d’utiliser les mêmes métriques que le texte À deux niveaux GDI lorsqu’elle est définie sur FALSE. Lorsqu’il est défini sur TRUE, indique à la disposition du texte d’utiliser les mêmes métriques que le texte mesuré par GDI à l’aide d’une police créée avec CLEARTYPE_NATURAL_QUALITY.

[out] textLayout

Type : IDWriteTextLayout**

Lorsque cette méthode est retournée, contient une adresse vers le pointeur de l’objet de disposition de texte résultant.

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 disposition de texte résultante ne doit être utilisée que pour la résolution prévue, et dans les cas où la scalabilité du texte est souhaitée , CreateTextLayout doit être utilisé à la place.

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]
Plateforme cible	Windows
En-tête	dwrite.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteFactory