Поделиться через

Сравнение API текста Win32

Для тех разработчиков, которые переносят код приложения Win32, в следующей таблице перечислены API-интерфейсы Текста Win32 и приблизительный эквивалент в DirectWrite.

Вызовы текста GDI Описание Эквивалент DirectWrite
AddFontMemResourceEx Добавляет внедренный шрифт в таблицу системных шрифтов. CreateCustomFontFileReference + CreateCustomFontCollection
AddFontResource Добавляет ресурс шрифта в таблицу системных шрифтов. Нет эквивалента. AddFontResource добавляет в системную коллекцию шрифтов в рамках этапа установки шрифта GDI. DirectWrite заполняет коллекцию системных шрифтов заранее и автоматически отслеживает обновления, поэтому установка не требуется.
AddFontResourceEx Добавляет в таблицу системных шрифтов частный или непеременимый шрифт. То же, что и выше
CreateFont Создает логический шрифт. Вместо логического шрифта приложения могут указывать набор свойств шрифта (например, имя семейства, вес, стиль, растяжение и размер) для создания IDWriteTextFormat. Только приложения, требующие перечисления шрифта, будут получать доступ к IDWriteFont через IDWriteFontCollection.
CreateFontIndirect Создает логический шрифт из структуры. То же, что и выше
CreateFontIndirectEx Создает логический шрифт из структуры. То же, что и выше
DrawText Рисует форматированный текст в прямоугольнике. IDWriteTextLayout::D raw
DrawTextEx Рисует форматированный текст в прямоугольнике. IDWriteTextLayout::D raw
EnumFontFamExProc Определяемая приложением функция обратного вызова, используемая с EnumFontFamiliesEx для обработки шрифтов. интерфейс IDWriteFontCollection через IDWriteFactory::GetSystemFontCollection
EnumFontFamiliesEx Перечисляет все шрифты в системе с определенными характеристиками. интерфейс IDWriteFontCollection через IDWriteFactory::GetSystemFontCollection
ExtTextOut Рисует символьную строку. IDWriteTextLayout::D rawили idWriteRenderBitmapTarget::D rawGlyphRun
GetAspectRatioFilterEx Возвращает параметр фильтра пропорций. N/A
GetCharABCWidths Возвращает ширину последовательных символов из шрифта TrueType. IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsFloat Возвращает ширину последовательных символов из текущего шрифта. IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsI Получает ширину последовательных индексов глифов или массив индексов глифов из шрифта TrueType. IDWriteFontFace::GetDesignGlyphMetrics
GetCharacterPlacement Возвращает сведения о строке символов. IDWriteTextAnalyzer
GetCharWidth32 Возвращает ширину последовательных символов из текущего шрифта. IDWriteFontFace::GetDesignGlyphMetricsили IDWriteTextLayout::GetMetrics
GetCharWidthFloat Получает дробную ширину последовательных символов из текущего шрифта. IDWriteFontFace::GetDesignGlyphMetricsили IDWriteTextLayout::GetMetrics
GetCharWidthI Получает ширину последовательных глифовых индексов или массив глифовых индексов из текущего шрифта. IDWriteFontFace::GetDesignGlyphMetricsили IDWriteTextLayout::GetMetrics
GetFontData Возвращает данные метрик для шрифта TrueType. IDWriteFontFace::TryGetFontTable
GetFontLanguageInfo Возвращает сведения о выбранном шрифте для контекста отображения. N/A
GetFontUnicodeRanges Указывает, какие символы Юникода поддерживаются шрифтом. цикл IDWriteFont::HasCharacter
GetGlyphIndices Преобразует строку в массив глифовых индексов. IDWriteFontFace::GetGlyphIndices
GetGlyphOutline Возвращает контур или растровое изображение для символа в шрифте TrueType. glyph metrics -- IDWriteFontFace::GetDesignGlyphMetrics, фактические сведения о структуре -IDwriteFontFace::GetGlyphRunOutline, если требуется глиф растровых карт, IDWriteRenderBitmapRenderTarget::D rawGlyphRun
GetKerningPairs Возвращает пары символьного кернинга для шрифта. Kerning разрешен через типографические свойства макета (DirectWrite выполняет кернинг сам по себе, поэтому не существует метода для возврата этих сведений).
GetOutlineTextMetrics Возвращает текстовые метрики для шрифтов TrueType. IDWriteFontFace::GetMetrics
GetRasterizerCaps Указывает, установлены ли шрифты TrueType. (Шрифты TrueType устанавливаются в Windows Vista и Windows 7 по умолчанию.)
GetTabbedTextExtent Вычисляет ширину и высоту символьной строки, включая вкладки. IDWriteTextLayout::GetMetrics
GetTextAlign Возвращает параметр выравнивания текста для контекста устройства. IDWriteTextFormat::GetTextAlignment
GetTextCharacterExtra Возвращает текущий интервал между символами для контекста устройства. N/A
GetTextColor Возвращает цвет текста для контекста устройства. N/A. (DirectWrite не зависит от отрисовки, поэтому не знает цвет. Приложения должны отслеживать его сами.)
GetTextExtentExpoint Получает количество символов в строке, которая будет соответствовать пробелу. IDWriteTextLayout::GetMetrics
GetTextExtentExPointI Получает количество глифовых индексов, которые будут соответствовать пробелу. IDWriteTextLayout::GetMetrics
GetTextExtentPoint32 Вычисляет ширину и высоту строки текста. IDWriteTextLayout::GetMetrics
GetTextExtentPointI Вычисляет ширину и высоту массива глифовых индексов. IDWriteTextLayout::GetMetrics
GetTextFace Возвращает имя шрифта, выбранного в контексте устройства. IDWriteFont::GetFaceNames (возвращает все имена)
GetTextMetrics Заполняет буфер метриками шрифта. IDWriteFontFace::GetMetrics
PolyTextOut Рисует несколько строк с помощью цветов шрифта и текста в контексте устройства. N/A; создание нескольких объектов макета
RemoveFontMemResourceEx Удаляет шрифт, источник которого был внедрен в документ из системной таблицы шрифтов. IUnknown::Release в связанном объекте
RemoveFontResource Удаляет шрифты в файле из системной таблицы шрифтов N/A
RemoveFontResourceEx Удаляет из системной таблицы шрифтов частный или непеременимый шрифт. N/A
SetMapperFlags Изменяет алгоритм, используемый для сопоставления логических шрифтов с физическими шрифтами. N/A
SetTextAlign Задает флаги выравнивания текста для контекста устройства. IDWriteTextFormat::SetTextAlignment
SetTextCharacterExtra Задает интервал между символами. N/A
SetTextColor Задает цвет текста для контекста устройства. Приложение должен заботиться об указании цвета в одном из вызовов Рисование.
SetTextJustification Указывает объем пространства, которое система должна добавить к символам останова в строке. N/A. Интервалы оправданий и символов не поддерживаются в этом выпуске.
TabbedTextOut Записывает символьную строку в расположении, расширяя вкладки до указанных значений. IDWriteTextLayout::D raw
TextOut Записывает символьную строку в расположении IDWriteTextLayout::D raw

 

 

 

  • Last updated on