лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

} TEXTMETRIC;

Первые семь полей структуры определяют основные метрики шрифта (см. рис. 2.27) в логических единицах, которые зависят от режима отображения, выбранного в контексте устройства.

Поле tmWeight определяет вес (жирность) шрифта. Эта величина может изме няться от 0 до 1000, но чаще всего она равна или 400 для нормального начертания шрифта, или 700 для полужирного начертания.

Вполе tmOverhang содержится величина, на которую увеличивается ширина символов для синтезированных шрифтов, например для наклонных или жирных шрифтов, получаемых из нормального шрифта. Шрифты TrueType обычно не ис пользуют это поле, так как в них для каждого начертания создается свой шрифт.

Поля tmDigitizedAspectX и tmDigitizedAspectY прокомментированы в MSDN тер минами горизонтальный аспект устройства (horizontal aspect of the device) и вер тикальный аспект устройства (vertical aspect of the device) соответственно, для которых был создан текущий шрифт. По существу, они содержат те же значения, которые возвращает функция GetDeviceCaps с аргументами LOGPIXELSX и LOGPIXELSY, то есть «число пикселов на 1 логический дюйм по горизонтали» и «число пиксе лов на 1 логический дюйм по вертикали». При синтезе шрифтов имеют значение не абсолютные значения этих величин, а их соотношение tmDigitizedAspectY / tmDigitizedAspectX, называемое аспектным соотношением (aspect ratio).

Поле tmDefaultChar имеет довольно простой смысл. Если приложение пытает ся вывести неотображаемый символ, код которого отсутствует в шрифте, то вме сто него будет выведен символ с кодом, содержащимся в поле tmDefaultChar. На рис. 2.22–2.25 показано, что Windows выводит в таких случаях контурный пря моугольник.

Поле tmBreakChar обычно содержит код пробела (0x20).

Вполе tmPitchAndFamily содержится информация о шаге, технологии и семей стве шрифта. Четыре младших бита указывают на шаг и технологию. Соответ ствующие константы приведены в табл. 2.22.

Четыре старших бита обозначают семейство шрифта. Возможные значения

ввиде констант Windows были приведены в табл. 2.21.

Получив дескриптор встроенного шрифта, необходимо выбрать его в контекст устройства при помощи функции SelectObject. После окончания работы с встро енным шрифтом его удаление не требуется.

Создание логических шрифтов

Область применения стандартных шрифтов обычно ограничивается простым выводом элементов пользовательского интерфейса. Для любых других целей при ходится создавать собственные логические шрифты. В GDI для этого предусмот рены функции CreateFont, CreateFontIndirect и CreateFontIndirectEx.

В этом разделе не будет рассматриваться функция CreateFontIndirectEx, кото рая поддерживает использование шрифтов нового формата OpenType фирмы Microsoft. При необходимости найти нужную информацию можно в MSDN.

Функция CreateFont использует для описания логического шрифта 14 парамет ров, поэтому она не слишком удобна в использовании. Вместо нее лучше пользо ваться функцией CreateFontIndirect. Эта функция получает указатель на структу ру LOGFONT, в которой упакованы эти же 14 параметров. Функция имеет следующий прототип:

HFONT CreateFontIndirect(CONST LOGFONT* lplf);

Структура LOGFONT определена в файле wingdi.h следующим образом:

typedef struct tagLOGFONT

{

int lfHeight; int lfWidth;

int lfEscapement; int lfOrientation; int lfWeight;

BYTE lfItalic; BYTE lfUnderline; BYTE lfStrikeOut; BYTE lfCharSet;

BYTE lfOutPrecision; BYTE lfClipPrecision; BYTE lfQuality;

BYTE lfPitchAndFamily;

char lfFaceName[LF_FACESIZE]; } LOGFONT;

Рассмотрим назначение ее полей:

lfHeight — желательная высота шрифта в логических единицах. Поле может иметь положительное, нулевое или отрицательное значение. Положительное значение определяет требуемую высоту ячеек, то есть величину tmHeight на рис. 2.27. Если указано нулевое значение, то выбирается шрифт размером 12 пунктов (значе ние по умолчанию). Абсолютная величина отрицательного значения определя ет высоту символов, то есть расстояние tmHeight – tmInternalLeading.

lfWidth — желательная средняя ширина символов в логических единицах. Если поле lfWidth имеет нулевое значение, то аспектное соотношение устройства вы вода сопоставляется с аспектным соотношением доступных шрифтов в поиске наиболее подходящего шрифта по этому параметру.

lfEscapement — угол между базовой линией текста и осью X устройства в деся тых долях градуса. Отсчет ведется против часовой стрелки.

lfOrientation — угол между базовой линией каждого символа и осью X устрой ства в десятых долях градуса. Отсчет ведется против часовой стрелки. Если устройство работает в расширенном графическом режиме (GM_ADVANCED), до ступном лишь в Windows NT/2000, то наклон lfEscapement и ориентация lfOrientation задаются независимо друг от друга. В совместимом графическом режиме (GM_COMPATIBLE) поле lfEscapement задает одновременно и наклон, и ориентацию символов. MSDN рекомендует в последнем случае устанавли вать одно и то же значение для полей lfEscapement и lfOrientation.

lfWeight — желательный вес (жирность) шрифта в интервале от 0 до 1000. На пример, значение 400 создает нормальный шрифт, а 700 — полужирный шрифт. В табл. 2.25 приведены константы, которые можно использовать для установ ки данного поля. Значение FW_DONTCARE предписывает выбрать вес шрифта по умолчанию.

Таблица 2.25. Константы для определения веса шрифта1

Константа Значение

FW_DONTCARE 0

FW_THIN 100

FW_EXTRALIGHT 200

FW_ULTRALIGHT 200

FW_LIGHT 300

FW_NORMAL 400

FW_REGULAR 400

FW_MEDIUM 500

FW_SEMIBOLD 600

FW_DEMIBOLD 600

FW_BOLD 700

FW_EXTRABOLD 800

FW_ULTRABOLD 800

FW_HEAVY 900

FW_BLACK 900

lfItalic — запрашивается курсивный шрифт, если значение поля равно TRUE.

lfUnderline — запрашивается шрифт с подчеркиванием букв.

lfStrikeOut — запрашивается шрифт с перечеркнутыми буквами.

lfCharSet — набор символов шрифта. Вы можете использовать одну из констант, приведенных в табл. 2.23.

lfOutPrecision — требуемая степень соответствия параметров выбираемого шрифта запрашиваемым характеристикам. Это поле указывает GDI критерии выбора между имеющимися в системе шрифтами. Наиболее часто используются значе ния из табл. 2.26.

1 Можно использовать любое из указанных значений, однако следует иметь в виду, что многие шрифты содержат описания символов только для веса FW_NORMAL, FW_REGULAR и FW_BOLD.

lfClipPrecision — способ отсечения символа, частично попавшего за пределы ре гиона отсечения. Поле может иметь одно или несколько значений из табл. 2.27, объединенных побитовой операцией ИЛИ. Из всех флагов к отсечению, соб ственно, относится только константа CLIP_DEFAULT_PRECIS.

Таблица 2.27. Константы для поля lfClipPrecision

lfQuality — качество вывода глифов. Можно использовать одну из констант, приведенных в табл. 2.28. Для шрифтов TrueType константы DRAFT_QUALITY и PROOF_QUALITY не имеют значения, поскольку контуры глифов свободно мас штабируются до нужной величины.

Таблица 2.28. Константы для поля lfQuality

èне слишком мал

lfPitchAndFamily — задает шаг и семейство шрифта. Возможные значения опреде ляются как объединение (логическая операция ИЛИ) одного из значений, при веденных в табл. 2.29, и одного из значений, приведенных в табл. 2.21.

fFaceName — строка с завершающим нулевым байтом, задающая имя гарниту ры шрифта. Размер строки, включая завершающий нуль, не должен превы шать 32 байта. Имена гарнитур шрифтов, установленных в системе в настоя щий момент, можно получить при помощи функции EnumFontFamiliesEx. Если поле fFaceName содержит пустую строку, то GDI выбирает первый попавшийся шрифт, который удовлетворяет другим заданным атрибутам.

Перед вызовом функции CreateFontIndirect вы должны определить переменную типа HFONT для создаваемого шрифта:

HFONT hFont;

а также переменную типа LOGFONT:

LOGFONT lf;

После этого заполните ее поля нужными значениями, определяющими пара метры шрифта. Неиспользованные поля следует установить в 0. Более эффектив ным вариантом является объявление переменной lf со спецификатором static:

static LOGFONT lf;

так как в этом случае компилятор обеспечит инициализацию всех полей структу ры lf нулевыми значениями.

Если вы проектируете приложение, в котором пользователь должен иметь воз можность выбора используемого шрифта, то для заполнения полей структурной переменной lf следует воспользоваться функцией ChooseFont. Она вызывает стан дартное диалоговое окно для выбора шрифта. Эта возможность будет рассмотре на в главе 7 (раздел «Диалоговые окна общего пользования»).

После того как переменная lf подготовлена, вызовите функцию CreateFontIndirect:

hFont = CreateFontIndirect(&lf);

Полученный дескриптор hFont созданного логического шрифта выберите в кон текст устройства:

HFONT hOldFont = (HFONT)SelectObject(hDC, hFont);

Далее вы можете работать с этим шрифтом в функциях вывода текста, а после того, как он перестанет быть нужным, верните в контекст устройства предшеству ющий шрифт с одновременным удалением шрифта hFont:

DeleteObject(SelectObject(hDC, hOldFont));

Пример работы с логическими шрифтами приведен в листинге 2.3.

Подстановка шрифта

Новый логический шрифт, созданный функцией CreateFont или CreateFontIndirect, не ассоциируется ни с каким физическим шрифтом, пока он не будет выбран в контекст устройства вызовом функции SelectObject. Процесс поиска и выбора нуж ного физического шрифта, реализуемый системой в ходе выполнения функции

SelectObject, называется подстановкой или отображением шрифта (font mapping).

Процесс отображения логического шрифта довольно сложен. GDI сравнивает параметры, заданные в структуре LOGFONT, с параметрами различных шрифтов, доступных для графического устройства, выбирая наиболее подходящий шрифт. Для сравнения используются штрафные очки, которые имеют разные весовые коэффициенты. Выбирается тот шрифт, для которого штрафная сумма будет наи меньшей.

Наиболее важным фактором при подборе физического шрифта является набор символов, который задается в поле lfCharSet. При несовпадении этого атрибута очень велика вероятность, что символы будут выводиться совершенно неверными гли фами. Следующее по важности поле — это lfOutPrecision. Этот показатель ограничи вает рассматриваемые наборы символов определенными типами шрифтов. Затем оценивается поле lfFaceName, а после него — поле lfPitchAndFamily. Моноширинные шрифты сильно отличаются по внешнему виду от пропорциональных, поэтому этот атрибут также является важным при подстановке. После сравнения указанных по лей GDI сравнивает высоту символов, заданную в поле lfHeight, а затем поля lfWidth, lfItalic, lfUnderline, lfStrikeOut.

Получение информации о выбранном физическом шрифте

После того как логический шрифт выбран в контекст устройства, приложение может получить дополнительную информацию о подобранном физическом шриф те и его метриках.

Функция GetTextMetrics, позволяющая выполнить эту задачу, уже рассматрива лась ранее.

Но можно использовать и другую функцию, прототип которой приведен ниже:

int GetTextFace(HDC hDC, int nCount, LPTSTR lpFaceName);

Эта функция получает имя гарнитуры физического шрифта. Оно может отли чаться от имени гарнитуры, которое было задано в структуре LOGFONT. Искомое имя в виде строки с завершающим нулевым символом записывается в символь ный буфер с адресом lpFaceName. Длина буфера (количество символов) определя ется параметром nCount. В случае успешного завершения функция возвращает количество символов, скопированных в буфер, включая и завершающий нулевой символ. В случае ошибки возвращается нулевое значение. Функцию GetTextFace можно вызвать, указав на месте третьего параметра значение NULL. В этом случае она просто вернет количество символов в имени гарнитуры.

Функция GetTextCharSet(HDC hDC) возвращает идентификатор набора символов для текущего шрифта, выбранного в контекст устройства.

Есть и другие функции для получения дополнительной информации о теку щей реализации физического шрифта, к которым относятся GetFontLanguageInfo,

GetTextCharSetInfo и GetOutlineTextMetrics. Они используются при нетривиальном форматировании текста, например при непосредственной работе с глифами. Опи сание этих функций вы можете найти в MSDN или в книге [6].

Вывод текста

Win32 GDI обеспечивает полный набор функций для форматирования и рисова ния текста в клиентской области окна или на бумажной странице принтера. Эти функции могут быть разделены на те, которые форматируют текст, подготавли вая его для вывода, и те, которые действительно отображают текст. Форматиру