[ Содержание ] | [ Перечень функций ] |
char **XListFontsWithInfo(display, pattern, maxnames, count_return, info_return) Display *display; char *pattern; int maxnames; int *count_return; XFontStruct **info_return;
АРГУМЕНТЫ
Эта функция производит просмотр списка всех доступных шрифтов и формирует список тех шрифтов, которые подходят под шаблон pattern, после чего возвращает этот список, устанавливая количество записей в агрументе actual_count_return. При этом количество записей в списке ограничивается указанном в maxnames значении. Также одновременно формируется и возвращается список с информацией о шрифтах. Информация в этом списке совпадает с информацией, которая возвращается функцией XLoadQueryFont, за исключением того, что в ней не указываются метрики каждого символа шрифта.
Регистр букв в шаблоне значения не имеет. В шаблоне также могут быть использованы произвольные символы. Исключение составляют символы '*' и '?', образующие маску поиска. Если стоит знак '?', то значит в этом месте названия может находится произвольный символ. Если стоит знак '*', то значит в этом месте, в пределах одного параметра названия, может находиться произвольное количество произвольных символов. Исключением также является знак '-', который является служебным в названии шрифта.
Более подробно структура имени шрифта рассмотрена в описании функции XLoadFont.
Если среди доступных шрифтов не было найдено тех, кто подходит под шаблон поиска, то вместо списков возвращаются значения NULL.
Пример шаблона имени шрифта:
-*-times-bold-r-normal-*-12-*-*-*-*-*-koi8-r
Удалить список имён можно при помощи функции XFreeFontNames. Если также необходимо удалить и список параметров шрифтов, то можно удалить оба списка сразу при помощи функции XFreeFontInfo.
См. также: XFreeFontNames, XListFonts, XFreeFontInfo, XLoadFont, XQueryFont, XLoadQueryFont, XFreeFont, XGetFontProperty, XSetFont, XUnloadFont.
[ Содержание ] | [ Перечень функций ] |