Comparaison de l’API de texte Win32

Pour les développeurs qui migrent leur code d’application Win32, le tableau suivant répertorie les API texte Win32 et l’équivalent approximatif dans DirectWrite.

Appels de texte GDI	Description	DirectWrite Équivalent
AddFontMemResourceEx	Ajoute une police incorporée à la table de polices système.	CreateCustomFontFileReference + CreateCustomFontCollection
AddFontResource	Ajoute une ressource de police à la table de polices système.	Il n’y a pas d’équivalent. AddFontResource ajoute à la collection de polices système dans le cadre de l’étape d’installation de la police GDI. DirectWrite remplit la collection de polices système à l’avance et surveille automatiquement les mises à jour de celle-ci, de sorte qu’aucune installation n’est nécessaire.
AddFontResourceEx	Ajoute une police privée ou non énumérable à la table de polices système.	Identique à ce qui précède
CreateFont	Crée une police logique.	Au lieu d’une police logique, les applications peuvent spécifier un ensemble de propriétés de police (par exemple le nom de famille, le poids, le style, l’étirement et la taille) pour créer un IDWriteTextFormat. Seules les applications nécessitant l’énumération de la police accèdent à un IDWriteFont par le biais de l’IDWriteFontCollection.
CreateFontIndirect	Crée une police logique à partir d’une structure.	Identique à ce qui précède
CreateFontIndirectEx	Crée une police logique à partir d’une structure.	Identique à ce qui précède
DrawText	Dessine le texte mis en forme dans un rectangle.	IDWriteTextLayout::D raw
DrawTextEx	Dessine le texte mis en forme dans un rectangle.	IDWriteTextLayout::D raw
EnumFontFamExProc	Fonction de rappel définie par l’application utilisée avec EnumFontFamiliesEx pour traiter les polices.	Interface IDWriteFontCollection , via IDWriteFactory::GetSystemFontCollection
EnumFontFamiliesEx	Énumère toutes les polices du système avec certaines caractéristiques.	Interface IDWriteFontCollection , via IDWriteFactory::GetSystemFontCollection
ExtTextOut	Dessine une chaîne de caractères.	IDWriteTextLayout::D raw ou IDWriteRenderBitmapTarget::D rawGlyphRun
GetAspectRatioFilterEx	Obtient le paramètre du filtre de proportions.	N/A
GetCharABCWidths	Obtient les largeurs des caractères consécutifs de la police TrueType.	IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsFloat	Obtient les largeurs des caractères consécutifs de la police actuelle.	IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsI	Obtient les largeurs des index de glyphes consécutifs ou un tableau d’index de glyphes à partir de la police TrueType.	IDWriteFontFace::GetDesignGlyphMetrics
GetCharacterPlacement	Obtient des informations sur une chaîne de caractères.	IDWriteTextAnalyzer
GetCharWidth32	Obtient les largeurs des caractères consécutifs de la police actuelle.	IDWriteFontFace::GetDesignGlyphMetrics ou IDWriteTextLayout::GetMetrics
GetCharWidthFloat	Obtient les largeurs fractionnaires des caractères consécutifs de la police actuelle.	IDWriteFontFace::GetDesignGlyphMetrics ou IDWriteTextLayout::GetMetrics
GetCharWidthI	Obtient les largeurs des index de glyphes consécutifs ou un tableau d’index de glyphes à partir de la police actuelle.	IDWriteFontFace::GetDesignGlyphMetrics ou IDWriteTextLayout::GetMetrics
GetFontData	Obtient les données de métrique pour une police TrueType.	IDWriteFontFace::TryGetFontTable
GetFontLanguageInfo	Retourne des informations sur la police sélectionnée pour un contexte d’affichage.	N/A
GetFontUnicodeRanges	Indique les caractères Unicode pris en charge par une police.	boucle d’IDWriteFont::HasCharacter
GetGlyphIndices	Convertit une chaîne en tableau d’index de glyphes.	IDWriteFontFace::GetGlyphIndices
GetGlyphOutline	Obtient le contour ou la bitmap d’un caractère dans la police TrueType.	Métriques de glyphe -- IDWriteFontFace::GetDesignGlyphMetrics, informations de plan réelles --IDwriteFontFace::GetGlyphRunOutline, si vous voulez des bitmaps de glyphes, IDWriteRenderBitmapRenderTarget::D rawGlyphRun
GetKerningPairs	Obtient les paires de crénage de caractères pour une police.	Crénage autorisé via les propriétés typographiques de la disposition (DirectWrite effectue le crénage lui-même, il n’existe donc aucune méthode pour renvoyer ces informations).
GetOutlineTextMetrics	Obtient des métriques de texte pour les polices TrueType.	IDWriteFontFace::GetMetrics
GetRasterizerCaps	Indique si les polices TrueType sont installées.	(Les polices TrueType sont installées sur Windows Vista et Windows 7 par défaut.)
GetTabbedTextExtent	Calcule la largeur et la hauteur d’une chaîne de caractères, y compris les onglets.	IDWriteTextLayout::GetMetrics
GetTextAlign	Obtient le paramètre d’alignement du texte pour un contexte d’appareil.	IDWriteTextFormat::GetTextAlignment
GetTextCharacterExtra	Obtient l’espacement entre caractères actuel pour un contexte d’appareil.	N/A
GetTextColor	Obtient la couleur du texte d’un contexte d’appareil.	N/A. (DirectWrite est indépendant du rendu et ne connaît donc pas la couleur. Les applications doivent en assurer le suivi elles-mêmes.)
GetTextExtentExPoint	Obtient le nombre de caractères d’une chaîne qui tiennent dans un espace.	IDWriteTextLayout::GetMetrics
GetTextExtentExPointI	Obtient le nombre d’index de glyphes qui vont tenir dans un espace.	IDWriteTextLayout::GetMetrics
GetTextExtentPoint32	Calcule la largeur et la hauteur d’une chaîne de texte.	IDWriteTextLayout::GetMetrics
GetTextExtentPointI	Calcule la largeur et la hauteur d’un tableau d’index de glyphes.	IDWriteTextLayout::GetMetrics
GetTextFace	Obtient le nom de la police sélectionnée dans un contexte d’appareil.	IDWriteFont::GetFaceNames (renvoie tous les noms)
GetTextMetrics	Remplit une mémoire tampon avec les métriques d’une police.	IDWriteFontFace::GetMetrics
PolyTextOut	Dessine plusieurs chaînes à l’aide des couleurs de police et de texte dans un contexte d’appareil.	N/A; créer plusieurs objets de disposition
RemoveFontMemResourceEx	Supprime de la table de polices système une police dont la source a été incorporée dans un document.	IUnknown::Release sur l’objet associé
RemoveFontResource	Supprime les polices d’un fichier de la table de polices système	N/A
RemoveFontResourceEx	Supprime une police privée ou non énumérable de la table de polices système.	N/A
SetMapperFlags	Modifie l’algorithme utilisé pour mapper les polices logiques aux polices physiques.	N/A
SetTextAlign	Définit les indicateurs d’alignement du texte pour un contexte d’appareil.	IDWriteTextFormat::SetTextAlignment
SetTextCharacterExtra	Définit l’espacement entre les caractères.	N/A
SetTextColor	Définit la couleur du texte d’un contexte d’appareil.	Une application doit s’occuper de spécifier la couleur dans l’un des appels Draw .
SetTextJustification	Spécifie la quantité d’espace que le système doit ajouter aux caractères d’arrêt d’une chaîne.	N/A. La justification et l’espacement des caractères ne sont pas pris en charge dans cette version.
TabbedTextOut	Écrit une chaîne de caractères à un emplacement, en développant les onglets aux valeurs spécifiées.	IDWriteTextLayout::D raw
Textout	Écrit une chaîne de caractères à un emplacement	IDWriteTextLayout::D raw