Win32 Text API összehasonlítása
Azoknak a fejlesztőknek, akik a Win32-alkalmazáskódjukat migrálják, az alábbi táblázat a Win32 Text API-kat és a DirectWrite hozzávetőleges megfelelőit sorolja fel.
| GDI-szöveges hívások | Leírás | DirectWrite-ekvivalens |
|---|---|---|
| AddFontMemResourceEx | Beágyazott betűtípust ad hozzá a rendszer betűtípustáblához. | CreateCustomFontFileReference + CreateCustomFontCollection |
| AddFontResource | Hozzáad egy betűtípus-erőforrást a rendszer betűtípustáblához. | Nincs egyenértékű. AddFontResource a GDI betűtípus-telepítési lépés részeként hozzáadja a rendszer betűtípusgyűjteményéhez. A DirectWrite előre feltölti a rendszer betűtípusgyűjteményét, és automatikusan figyeli annak frissítéseit, így soha nincs szükség telepítésre. |
| AddFontResourceEx | Magánjellegű vagy nem számozható betűtípust ad hozzá a rendszer betűtípustáblához. | Ugyanaz, mint fent |
| CreateFont | Logikai betűtípust hoz létre. | Logikai betűtípus helyett az alkalmazások megadhatnak egy betűtípus-tulajdonságkészletet (például családnevet, súlyt, stílust, nyújtást és méretet) a IDWriteTextFormatlétrehozásához. Csak a betűtípus enumerálását igénylő alkalmazások férnek hozzá egy IDWriteFont az IDWriteFontCollection. |
| CreateFontIndirect | Logikai betűtípust hoz létre egy struktúrából. | Ugyanaz, mint fent |
| CreateFontIndirectEx | Logikai betűtípust hoz létre egy struktúrából. | Ugyanaz, mint fent |
| DrawText | Formázott szöveget rajzol téglalapba. | IDWriteTextLayout::D raw |
| DrawTextEx | Formázott szöveget rajzol téglalapba. | IDWriteTextLayout::D raw |
| EnumFontFamExProc | Az EnumFontFamiliesExalkalmazás által definiált visszahívási függvény a betűtípusok feldolgozásához. | IDWriteFontCollection felületet IDWriteFactory::GetSystemFontCollection |
| EnumFontFamiliesEx | Enumerálja a rendszer összes betűtípusát bizonyos jellemzőkkel. | IDWriteFontCollection felületet IDWriteFactory::GetSystemFontCollection |
| ExtTextOut | Karaktersztring rajzolása. | IDWriteTextLayout::D raw vagy IDWriteRenderBitmapTarget::D rawGlyphRun |
| GetAspectRatioFilterEx | Lekéri az oldalarány-szűrő beállításait. | N/A |
| GetCharABCWidths | Lekéri az egymást követő karakterek szélességét a TrueType betűtípusból. | IDWriteFontFace::GetDesignGlyphMetrics |
| GetCharABCWidthsFloat | Lekéri az egymást követő karakterek szélességét az aktuális betűtípusból. | IDWriteFontFace::GetDesignGlyphMetrics |
| GetCharABCWidthsI | Lekéri az egymást követő karakterjelindexek vagy a karakterjelindexek tömbjének szélességét a TrueType betűtípusból. | IDWriteFontFace::GetDesignGlyphMetrics |
| GetCharacterPlacement | Információt kap egy karaktersorozatról. | IDWriteTextAnalyzer |
| GetCharWidth32 | Lekéri az egymást követő karakterek szélességét az aktuális betűtípusból. | IDWriteFontFace::GetDesignGlyphMetrics vagy IDWriteTextLayout::GetMetrics |
| GetCharWidthFloat | Lekéri az egymást követő karakterek törtszélességeit az aktuális betűtípusból. | IDWriteFontFace::GetDesignGlyphMetrics vagy IDWriteTextLayout::GetMetrics |
| GetCharWidthI | Lekéri az egymást követő karakterjelindexek vagy a karakterjelindexek tömbjének szélességét az aktuális betűtípusból. | IDWriteFontFace::GetDesignGlyphMetrics vagy IDWriteTextLayout::GetMetrics |
| GetFontData | Metrikaadatokat kér le Egy TrueType betűtípushoz. | IDWriteFontFace::TryGetFontTable |
| GetFontLanguageInfo | A megjelenítési környezethez kijelölt betűtípussal kapcsolatos információkat adja vissza. | N/A |
| GetFontUnicodeRanges | Azt jelzi, hogy a betűtípus mely Unicode-karaktereket támogatja. | IDWriteFont::HasCharacter |
| GetGlyphIndices | Egy sztringet glyph-indexek tömbjeként fordít le. | IDWriteFontFace::GetGlyphIndices |
| GetGlyphOutline | Lekéri egy karakter körvonalát vagy bitképét a TrueType betűtípusban. | glyph metrics -- IDWriteFontFace::GetDesignGlyphMetrics, tényleges szerkezeti információk --IDwriteFontFace::GetGlyphRunOutline, ha glyph bitképeket szeretne, IDWriteRenderBitmapRenderTarget::D rawGlyphRun |
| GetKerningPairs | Lekéri a betűtípus karakterszegélyes párjait. | Az elrendezés tipográfiai tulajdonságain keresztül engedélyezett kerning (a DirectWrite nem kerning magát, ezért nincs mód az információk visszaadására). |
| GetOutlineTextMetrics | Lekéri a TrueType betűtípusok szöveges metrikáit. | IDWriteFontFace::GetMetrics |
| GetRasterizerCaps | Azt jelzi, hogy telepítve vannak-e a TrueType betűtípusok. | (A TrueType betűtípusok alapértelmezés szerint Windows Vista és Windows 7 rendszeren vannak telepítve.) |
| GetTabbedTextExtent | Kiszámítja egy karaktersztring szélességét és magasságát, beleértve a lapokat is. | IDWriteTextLayout::GetMetrics |
| GetTextAlign | Lekéri az eszközkörnyezet szövegigazítási beállítását. | IDWriteTextFormat::GetTextAlignment |
| GetTextCharacterExtra | Lekéri az eszközkörnyezet aktuális karakterközi térközét. | N/A |
| GetTextColor | Lekéri az eszközkörnyezet szövegszínét. | N/A. (A DirectWrite független a renderelésétől, ezért nem ismeri a színt. Az alkalmazásoknak maguknak kell nyomon követniük.) |
| GetTextExtentExPoint | A szóközön belül elférő sztringben lévő karakterek számát adja meg. | IDWriteTextLayout::GetMetrics |
| GetTextExtentExPointI | Lekéri a térbe illeszkedő karakterjelindexek számát. | IDWriteTextLayout::GetMetrics |
| GetTextExtentPoint32 | Kiszámítja egy szövegsztring szélességét és magasságát. | IDWriteTextLayout::GetMetrics |
| GetTextExtentPointI | Kiszámítja a glyph indexek tömbjének szélességét és magasságát. | IDWriteTextLayout::GetMetrics |
| GetTextFace | Lekéri az eszközkörnyezetbe kijelölt betűtípus nevét. | IDWriteFont::GetFaceNames (Az összes nevet visszaadja) |
| GetTextMetrics | Egy puffer kitöltése a betűtípus metrikáival. | IDWriteFontFace::GetMetrics |
| PolyTextOut | Több sztringet rajzol az eszközkörnyezet betűtípusával és szövegszínével. | N/A; több elrendezési objektum létrehozása |
| RemoveFontMemResourceEx | Eltávolít egy betűtípust, amelynek forrását egy dokumentumba ágyazták be a rendszer betűtípustáblájából. | IUnknown::Release a társított objektumon |
| RemoveFontResource | A fájl betűtípusainak eltávolítása a rendszer betűtípustáblájából | N/A |
| RemoveFontResourceEx | Eltávolít egy privát vagy nem számozható betűtípust a rendszer betűtípustáblájából. | N/A |
| SetMapperFlags | Módosítja a logikai betűtípusok fizikai betűtípusokra való leképezéséhez használt algoritmust. | N/A |
| SetTextAlign | Beállítja az eszközkörnyezet szövegigazítási jelzőit. | IDWriteTextFormat::SetTextAlignment |
| SetTextCharacterExtra | Beállítja a karakterközi térközt. | N/A |
| SetTextColor | Beállítja az eszközkörnyezet szövegszínét. | Az alkalmazásnak gondoskodnia kell a szín megadásáról az egyik Rajz hívásokban. |
| SetTextJustification | Megadja, hogy a rendszer mennyi területet adjon hozzá a sztring töréskaraktereihez. | N/A. Az indoklás és a karakterköz ebben a kiadásban nem támogatott. |
| TabbedTextOut | Karaktersztringet ír egy helyre, és kibontja a lapokat a megadott értékekre. | IDWriteTextLayout::D raw |
| TextOut | Karaktersztring írása egy helyen | IDWriteTextLayout::D raw |