Dela via


Jämförelse av Win32-text-API

För de utvecklare som migrerar sin Win32-programkod visar följande tabell Win32 Text-API:er och den ungefärliga motsvarigheten i DirectWrite.

GDI-textanrop Beskrivning DirectWrite-motsvarighet
AddFontMemResourceEx Lägger till ett inbäddat teckensnitt i systemets teckensnittstabell. CreateCustomFontFileReference + CreateCustomFontCollection
AddFontResource Lägger till en teckensnittsresurs i systemets teckensnittstabell. Det finns ingen motsvarighet. AddFontResource lägger till i systemteckensnittssamlingen som en del av installationssteget för GDI-teckensnitt. DirectWrite fyller i systemteckensnittssamlingen i förväg och övervakar automatiskt uppdateringar av den, så ingen installation behövs någonsin.
AddFontResourceEx Lägger till ett privat eller icke-uppräkningsbart teckensnitt i systemets teckensnittstabell. Samma som ovan
CreateFont Skapar ett logiskt teckensnitt. I stället för logiskt teckensnitt kan program ange en uppsättning teckensnittsegenskaper (till exempel familjenamn, vikt, stil, stretch och storlek) för att skapa en IDWriteTextFormat. Endast appar som kräver uppräkning av teckensnittet får åtkomst till en IDWriteFont- via IDWriteFontCollection.
CreateFontIndirect Skapar ett logiskt teckensnitt från en struktur. Samma som ovan
CreateFontIndirectEx Skapar ett logiskt teckensnitt från en struktur. Samma som ovan
DrawText Ritar formaterad text i en rektangel. IDWriteTextLayout::D raw
DrawTextEx Ritar formaterad text i en rektangel. IDWriteTextLayout::D raw
EnumFontFamExProc En programdefinierad återanropsfunktion som används med EnumFontFamiliesEx för att bearbeta teckensnitt. IDWriteFontCollection-gränssnittet via IDWriteFactory::GetSystemFontCollection
EnumFontFamiliesEx Räknar upp alla teckensnitt i systemet med vissa egenskaper. IDWriteFontCollection-gränssnittet via IDWriteFactory::GetSystemFontCollection
ExtTextOut Ritar en teckensträng. IDWriteTextLayout::D raw eller IDWriteRenderBitmapTarget::D rawGlyphRun
GetAspectRatioFilterEx Hämtar inställningen för filtret för proportioner. Ej tillämpligt
GetCharABCWidths Hämtar bredden på efterföljande tecken från TrueType-teckensnittet. IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsFloat Hämtar bredden på efterföljande tecken från det aktuella teckensnittet. IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsI Hämtar bredden på efterföljande glyphindex eller en matris med glyphindex från TrueType-teckensnittet. IDWriteFontFace::GetDesignGlyphMetrics
GetCharacterPlacement Hämtar information om en teckensträng. IDWriteTextAnalyzer
GetCharWidth32 Hämtar bredden på efterföljande tecken från det aktuella teckensnittet. IDWriteFontFace::GetDesignGlyphMetrics eller IDWriteTextLayout::GetMetrics
GetCharWidthFloat Hämtar bråkbredden för efterföljande tecken från det aktuella teckensnittet. IDWriteFontFace::GetDesignGlyphMetrics eller IDWriteTextLayout::GetMetrics
GetCharWidthI Hämtar bredden på efterföljande glyphindex eller en matris med glyfindex från det aktuella teckensnittet. IDWriteFontFace::GetDesignGlyphMetrics eller IDWriteTextLayout::GetMetrics
GetFontData Hämtar måttdata för ett TrueType-teckensnitt. IDWriteFontFace::TryGetFontTable
GetFontLanguageInfo Returnerar information om det markerade teckensnittet för en visningskontext. Ej tillämpligt
GetFontUnicodeRanges Anger vilka Unicode-tecken som stöds av ett teckensnitt. loop av IDWriteFont::HasCharacter
GetGlyphIndices Översätter en sträng till en matris med glyfindex. IDWriteFontFace::GetGlyphIndices
GetGlyphOutline Hämtar dispositionen eller bitmappen för ett tecken i TrueType-teckensnittet. glyph-mått – IDWriteFontFace::GetDesignGlyphMetrics, faktisk dispositionsinformation –IDwriteFontFace::GetGlyphRunOutline, om du vill ha glyph-bitmappar IDWriteRenderBitmapRenderTarget::D rawGlyphRun
GetKerningPairs Hämtar tecken-kerning-paren för ett teckensnitt. Kerning tillåts via typografiska egenskaper för layouten (DirectWrite gör själva kerning, så det finns ingen metod för att returnera den här informationen).
GetOutlineTextMetrics Hämtar textmått för TrueType-teckensnitt. IDWriteFontFace::GetMetrics
GetRasterizerCaps Anger om TrueType-teckensnitt är installerade. (TrueType-teckensnitt installeras på Windows Vista och Windows 7 som standard.)
GetTabbedTextExtent Beräknar bredden och höjden på en teckensträng, inklusive flikar. IDWriteTextLayout::GetMetrics
GetTextAlign Hämtar textjusteringsinställningen för en enhetskontext. IDWriteTextFormat::GetTextAlignment
GetTextCharacterExtra Hämtar det aktuella interteckenavståndet för en enhetskontext. Ej tillämpligt
GetTextColor Hämtar textfärgen för en enhetskontext. Ej tillämpligt. (DirectWrite är oberoende av rendering och känner därför inte till färgen. Program måste hålla reda på det själva.)
GetTextExtentExPoint Hämtar antalet tecken i en sträng som får plats inom ett blanksteg. IDWriteTextLayout::GetMetrics
GetTextExtentExPointI Hämtar antalet glyphindex som får plats inom ett blanksteg. IDWriteTextLayout::GetMetrics
GetTextExtentPoint32 Beräknar bredden och höjden på en textsträng. IDWriteTextLayout::GetMetrics
GetTextExtentPointI Beräknar bredden och höjden på en matris med glyfindex. IDWriteTextLayout::GetMetrics
GetTextFace Hämtar namnet på teckensnittet som har valts i en enhetskontext. IDWriteFont::GetFaceNames (Returnerar alla namn)
GetTextMetrics Fyller en buffert med måtten för ett teckensnitt. IDWriteFontFace::GetMetrics
PolyTextOut Ritar flera strängar med teckensnitts- och textfärgerna i en enhetskontext. N/A; skapa flera layoutobjekt
RemoveFontMemResourceEx Tar bort ett teckensnitt vars källa har bäddades in i ett dokument från systemets teckensnittstabell. IUnknown::Release på det associerade objektet
RemoveFontResource Tar bort teckensnitten i en fil från systemteckensnittstabellen Ej tillämpligt
RemoveFontResourceEx Tar bort ett privat eller icke-uppräkningsbart teckensnitt från systemets teckensnittstabell. Ej tillämpligt
SetMapperFlags Ändrar algoritmen som används för att mappa logiska teckensnitt till fysiska teckensnitt. Ej tillämpligt
SetTextAlign Anger textjusteringsflaggor för en enhetskontext. IDWriteTextFormat::SetTextAlignment
SetTextCharacterExtra Anger avståndet mellan tecken. Ej tillämpligt
SetTextColor Anger textfärgen för en enhetskontext. Ett program måste ta hand om att ange färgen i något av Draw-anrop.
SetTextJustification Anger hur mycket utrymme systemet ska lägga till i bryttecken i en sträng. Ej tillämpligt. Justering och teckenavstånd stöds inte i den här versionen.
TabbedTextOut Skriver en teckensträng på en plats och expanderar flikar till angivna värden. IDWriteTextLayout::D raw
TextOut Skriver en teckensträng på en plats IDWriteTextLayout::D raw