IDWriteTextAnalyzer1 ::GetBaseline, méthode (dwrite_1.h)

Article
02/26/2024

Récupère la base de référence donnée à partir de la police.

Syntaxe

HRESULT GetBaseline(
                 IDWriteFontFace        *fontFace,
                 DWRITE_BASELINE        baseline,
                 BOOL                   isVertical,
                 BOOL                   isSimulationAllowed,
                 DWRITE_SCRIPT_ANALYSIS scriptAnalysis,
  [in, optional] WCHAR const            *localeName,
  [out]          INT32                  *baselineCoordinate,
  [out]          BOOL                   *exists
);

Paramètres

fontFace

Type : IDWriteFontFace*

Face de police à lire.

baseline

Type : DWRITE_BASELINE

Valeur de type DWRITE_BASELINE qui spécifie la base de référence d’intérêt.

isVertical

Type : BOOL

Indique si la ligne de base est verticale ou horizontale.

isSimulationAllowed

Type : BOOL

Si elle est manquante dans la police, simulez la ligne de base.

scriptAnalysis

Type : DWRITE_SCRIPT_ANALYSIS

Résultat de l’analyse de script à partir d’AnalyzeScript.

Note Vous pouvez passer une structure d’analyse de script vide, comme ceci DWRITE_SCRIPT_ANALYSIS scriptAnalysis = {};, et cette méthode retourne la base de référence par défaut.

[in, optional] localeName

Type : const WCHAR*

Langue de l’exécution.

[out] baselineCoordinate

Type : INT32*

Valeur de coordonnée de base dans les unités de conception.

[out] exists

Type : BOOL*

Indique si la ligne de base retournée existe dans la police.

Valeur retournée

Type : HRESULT

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

Remarques

Si la ligne de base n’existe pas dans la police, elle n’est pas considérée comme une erreur, mais la fonction retourne exists = false. Vous pouvez ensuite utiliser l’heuristique pour calculer la base manquante ou, si l’indicateur simulationAllowed a la valeur true, la fonction calcule une approximation raisonnable pour vous.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite_1.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteTextAnalyzer1

Partager via