Структура LOGFONT

Структура LOGFONT определяет атрибуты шрифта.

Синтаксис

typedef struct tagLOGFONT { 
  LONG lfHeight; 
  LONG lfWidth; 
  LONG lfEscapement; 
  LONG lfOrientation; 
  LONG lfWeight; 
  BYTE lfItalic; 
  BYTE lfUnderline; 
  BYTE lfStrikeOut; 
  BYTE lfCharSet; 
  BYTE lfOutPrecision; 
  BYTE lfClipPrecision; 
  BYTE lfQuality; 
  BYTE lfPitchAndFamily; 
  TCHAR lfFaceName[LF_FACESIZE]; 
} LOGFONT, *PLOGFONT;

Члены структуры

lfHeight

Устанавливает высоту, в логических единицах измерения, символьной ячейки шрифта или символа. Значение высоты символа (также известное как em-высота) является величиной высоты ячейки символа, минус величина внутреннего межстрочного интервала. Механизм отображения логического шрифта в физический интерпретирует значение, указанное в параметре lfHeight нижеследующим способом.

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

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

Это отображение происходит тогда, когда шрифт используется с самого начала.

Для режима отображения MM_TEXT, Вы можете использовать ниже следующее формулу, чтобы установить высоту для шрифта с заданным размером в пунктах:

lfHeight = -MulDiv(PointSize, GetDeviceCaps(hDC, LOGPIXELSY), 72);

lfWidth

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

lfEscapement

Устанавливает угол, в десятых долях градусов между вектором наклона и осью X устройства. Вектор наклона параллелен к основной линии строки текста.

Windows NT/2000/XP: Когда графический режим устанавливается с флажком GM_ADVANCED, Вы можете задать угол наклона строки независимо от ориентации угла символов строки.

Когда графический режим устанавливается с флажком GM_COMPATIBLE, член lfEscapement задает и наклон и ориентацию. Вы должны установить члены lfEscapement и lfOrientation в одно и то же значение.

Windows 95/98/Me: член lfEscapement задает и наклон и ориентацию. Вы должны установить члены lfEscapement и lfOrientation в одно и то же значение.

lfOrientation

Устанавливает угол, в десятых долях градусов, между основной линией каждого символа и осью X устройства.

lfWeight

Устанавливает толщину шрифта в диапазоне от 0 до 1000. Например, значение 400 нормальная толщина, а 700 является полужирная. Если это значение равно нулю, используется толщина заданная по умолчанию.

Ниже следующее значения определяются для удобства.

Значение	Толщина
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

Устанавливает подчеркнутый шрифт, если в нем установлено значение ИСТИНА (TRUE).

lfStrikeOut

Устанавливает зачеркнутый шрифт, если в нем установлено значение ИСТИНА (TRUE).

lfCharSet

Устанавливает набор символов. Нижеследующие значения предопределены.

ANSI_CHARSET
BALTIC_CHARSET
CHINESEBIG5_CHARSET
DEFAULT_CHARSET
EASTEUROPE_CHARSET
GB2312_CHARSET
GREEK_CHARSET
HANGUL_CHARSET
MAC_CHARSET
OEM_CHARSET
RUSSIAN_CHARSET
SHIFTJIS_CHARSET
SYMBOL_CHARSET
TURKISH_CHARSET
VIETNAMESE_CHARSET

Выпуск Windows на корейском языке:
JOHAB_CHARSET
Выпуск Windows на языках Ближнего Востока:
ARABIC_CHARSET
HEBREW_CHARSET
Выпуск Windows на тайском языке:
THAI_CHARSET

Значение OEM_CHARSET устанавливает набор символов, который является зависимым от операционной системы.

Windows 95/98/Me: Вы можете использовать значение DEFAULT_CHARSET, чтобы дать возможность полностью описывать название и размер логического шрифта. Если указанное имя шрифта не существует, шрифт из любого набора символов может быть заменен указанным шрифтом, так что вам следует мало использовать флажок DEFAULT_CHARSET, чтобы избежать неожиданных результатов.

Windows NT/2000/XP: флажок DEFAULT_CHARSET устанавливается в значение, основанное на текущем языке конкретной страны в системе. Например, когда язык конкретной страны в системе является английским (Соединенные Штаты), он устанавливается как ANSI_CHARSET.

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

Этот параметр важен в процессе подстановки шрифтов. Чтобы гарантировать совместимые результаты, задайте конкретный набор символов. Если Вы устанавливаете название гарнитуры шрифта в члене lfFaceName то, удостоверьтесь, что величина lfCharSet соответствует набору символов гарнитуры шрифта, указанной в lfFaceName.

lfOutPrecision

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

Значение	Предназначение
OUT_CHARACTER_PRECIS	Не используется.
OUT_DEFAULT_PRECIS	Устанавливает заданное по умолчанию поведение механизма отображения логического шрифта в физический.
OUT_DEVICE_PRECIS	Указывает механизму отображения логического шрифта в физический, чтобы выбрать шрифт поставляемый устройством, когда система содержит многокомпонентные шрифты с тем же самым названием.
OUT_OUTLINE_PRECIS	Windows NT/2000/XP: Это значение указывает механизму отображения логического шрифта в физический, который выбирает из шрифта формата TrueType и других шрифтов на основе контура
OUT_RASTER_PRECIS	Указывает механизму отображения логического шрифта в физический, чтобы выбрать растровый шрифт, когда система содержит многочисленные шрифты с тем же самым названием.
OUT_STRING_PRECIS	Это значение не используется механизмом отображения логического шрифта в физический, но оно возвращается, когда перечисляются растровые шрифты.
OUT_STROKE_PRECIS	Windows NT/2000/XP: Это значение не используется механизмом отображения логического шрифта в физический, но оно возвращается, когда перечисляются шрифты формата TrueType, другие шрифты на основе контура и векторные шрифты. Windows 95: Это значение используется, когда преобразуются векторные шрифты и возвращается, когда перечисляется шрифты формата TrueType или векторные шрифты.
OUT_TT_ONLY_PRECIS	Указывает механизму отображения логического шрифта в физический, чтобы выбирать из только шрифтов TrueType. Если шрифтов TrueType установленных в системе нет, механизм отображения логического шрифта в физический возвращается к заданному по умолчанию поведению.
OUT_TT_PRECIS	Указывает механизму отображения логического шрифта в физический, чтобы выбрать шрифт TrueType, когда система содержит многочисленные шрифты с тем же самым названием.

Приложения могут использовать флажки OUT_DEVICE_PRECIS, OUT_RASTER_PRECIS и OUT_TT_PRECIS, чтобы управлять механизмом отображения логического шрифта в физический при выборе шрифта, когда операционная система содержит больше чем один шрифт с указанным названием. Например, если операционная система содержит растровый шрифт по имени Symbol и в формате TrueType, определение флажка OUT_TT_PRECIS вынуждает механизм отображения логического шрифта в физический выбрать версию шрифта формата TrueType. Определение флажка OUT_TT_ONLY_PRECIS вынудило бы механизм отображения логического шрифта в физический выбрать шрифт TrueType, даже если он использует вместо указанного шрифт TrueType другого названия.

lfClipPrecision

Устанавливает точность отсечения. Точность отсечения определяет, как отсечь символы, которые находятся частично вне области отсечения. Член может состоять из одного или нескольких нижеследующих значений.

Значения	Предназначение
CLIP_DEFAULT_PRECIS	Устанавливает характер операции отсечения по умолчанию.
CLIP_CHARACTER_PRECIS	Не используется.
CLIP_STROKE_PRECIS	Не используется механизмом отображения логического шрифта в физический, но возвращается, когда перечисляются растровые, векторные или шрифты TrueType. Windows NT/2000/XP: Для совместимости, это значение всегда возвращается при перечислении шрифтов.
CLIP_MASK	Не используется.
CLIP_EMBEDDED	Вы должны устанавливать этот флажок для того, чтобы использовать внедренный шрифт только для чтения.
CLIP_LH_ANGLES	Когда используется это значение, вращение, сдвиг для всех шрифтов зависит от того, является ли ориентация системы координат левосторонней или правосторонней. Если флажок не используется, шрифты устройства всегда вращаются против часовой стрелки, но вращение других шрифтов зависит от ориентации системы координат. Более подробную информации об ориентации систем координат, см. в описании параметра *nOrientation*.
CLIP_TT_ALWAYS	Не используется.

lfQuality

Устанавливает качество вывода. Качество вывода определяет, как тщательно графический интерфейс устройств (GDI) должен пытаться найти соответствие атрибутов логического шрифта с такими же атрибутами фактического физического шрифта. Член может быть одним из ниже перечисленных значений.

Значение	Предназначение
ANTIALIASED_QUALITY	Windows NT 4.0 и старше: Шрифт всегда сглаживается, если шрифт поддерживает это действие, и размер шрифта определяется и не слишком маленьким и не слишком большим. Windows 95 Plus!, Windows 98/Me: Вывод на экран должен иметь цвет больше чем 8- битовый, это должно быть одноплоскостное устройство, он не может быть палитрой дисплея, и он не может быть в нескольких установленных экранах монитора. Кроме того, Вы должны выбрать шрифт TrueType в контексте устройства (DC) экрана до использования флажка в DIBSection, в противном случае сглаживание не происходит.
CLEARTYPE_QUALITY	Windows XP: Если он установлен, текст (когда возможно) изображается с плавным переходом полутонов, используя ClearType метод сглаживания . См. Замечания с подробной информацией.
DEFAULT_QUALITY	Вид шрифта не имеет значения.
DRAFT_QUALITY	Вид шрифта менее важен, чем в случае, когда используется флажок PROOF_QUALITY. Для растровых шрифтов графического интерфейса устройств, допускается масштабирование, которое означает, что, доступно больше размеров шрифта , но качество может быть ниже. Полужирный, курсивный, подчеркнутый, и зачеркнутый шрифты синтезируются в случае необходимости.
NONANTIALIASED_QUALITY	Windows 95/98/Me, Windows NT 4.0 и старше: Шрифт никогда не сглаживается.
PROOF_QUALITY	Качество символов шрифта более важно, чем точное соответствие атрибутов логического шрифта. Для растровых шрифтов графического интерфейса устройства (GDI), масштабирование заблокировано, и выбирается наиболее близкий по размеру шрифт. Хотя выбранный размер шрифта не может быть отображен точно, когда используется флажок PROOF_QUALITY, качество шрифта высокое и нет никаких проявлений искажения. Полужирные, курсивные, подчеркнутые, и зачеркнутые шрифты синтезируются в случае необходимости.

Если ни ANTIALIASED_QUALITY, ни NONANTIALIASED_QUALITY не выбираются, шрифт выравнивается только тогда, если пользователь выбирает в Панели управления гладкие шрифты для видеотерминала .

lfPitchAndFamily

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

DEFAULT_PITCH
FIXED_PITCH
VARIABLE_PITCH

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

FF_DECORATIVE
FF_DONTCARE
FF_MODERN
FF_ROMAN
FF_SCRIPT
FF_SWISS

Подходящее значение может быть получено при помощи использования Булева оператора OR, чтобы соединить константу какой-то ширины символов с какой-то константой семейства.

Семейства шрифта описывают внешний вид шрифта в общих чертах. Они предназначены для того, чтобы определить шрифты, когда необходимая точная гарнитура шрифта не доступна. Значения для семейств шрифта следующие.

Значение	Предназначение
FF_DECORATIVE	Нововведенные шрифты. Старинный английский готический шрифт - пример.
FF_DONTCARE	Не интересует или незнакомый шрифт.
FF_MODERN	Шрифты фиксированной ширины, с или без засечек. Шрифты фиксированной ширины обычно современные. Пример тому - шрифты Pica, Elite и CourierNew®.
FF_ROMAN	Шрифты с переменной шириной штриха (пропорциональные) и с засечками. Пример - MS® Serif.
FF_SCRIPT	Шрифты, разработанные, чтобы выглядеть подобно рукописным. Примеры Script и Cursive.
FF_SWISS	Шрифты с переменной шириной штриха (пропорциональный) и без засечек. Пример MS® Sans Serif.

lfFaceName

Символьная строка с нулем в конце, которая устанавливает название гарнитуры шрифта. Длина этой строки не должна выходить за пределы 32 символов, включая нулевой признак конца. Функция EnumFontFamiliesEx может использоваться для перечисления названий гарнитур шрифта всех текущих доступных шрифтов. Если член lfFaceName - пустая строка, графический интерфейс устройства (GDI) использует первый шрифт, который соответствует другим заданным атрибутам.

Замечания

Windows XP: Ниже следующее ситуации не поддерживают сглаживание технологии ClearType:

Текст сглаживается на принтере.

Вывод на экран установлен для 256 цветов или меньше.

Текст сглаживается клиентом терминального сервера.

Шрифт - не шрифт TrueType или формата OpenType с контурами формата TrueType. Например, ниже следующие шрифты не поддерживают сглаживание технологии ClearType: шрифт Type 1, шрифты Postscript OpenType без контуров формата TrueType, растровые, векторные шрифты и шрифты поставляемые с устройством.

Шрифт настроен на внедренные точечные рисунки, для любых размеров шрифта, которые содержат внедренные точечные рисунки. Например, это обычно встречается в восточно-азиатских шрифтах.

Смотри также

Обзор шрифты и текст, Структуры, используемые шрифтами и текстом, CreateFont, CreateFontIndirect, EnumFontFamiliesEx

Размещение и совместимость LOGFONT
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Объявлены как структуры Unicode и ANSI
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки