XQueryTextExtents(display, font_ID, string, nchars, direction_return,
			font_ascent_return, font_descent_return, overall_return)
	Display *display;
	XID font_ID;
	char *string;
	int nchars;
	int *direction_return;
	int *font_ascent_return, *font_descent_return;
	XCharStruct *overall_return;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• font_ID - идентификатор загруженного шрифта, которым выводится сообщение;
• string - строка текста, размеры которой необходимо узнать;
• nchars - длина строки string;
• direction_return - возвращаемое значение направления вывода текста (FontLeftToRight или FontRightToLeft);
• font_ascent_return - возвращаемое значение высоты символов шрифта над базовой линией;
• font_descent_return - возвращаемое значение вертикального размера символов шрифта под базовой линией в строке;
• overall_return - возваращаемые общие значения размеров строки.

     Эта функция возвращает прямоугольник, ограничивающий выводимую строку string при выводе её шрифтом font_ID. Эта функция запрашивает данные у X-сервера, что может приводить к лишней нагрузке сервера и замедлению работы программы. В случае, если программе постоянно необходимо вычислять размер строки, то лучше воспользоваться функцией XTextExtents, которая вычисляет размер на основании локальных данных.

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

     Значение поля ascent этой структуры будет иметь максимальное значение высоты символа над базовой линией в строке. Поле descent будет иметь значение маскимального вертикального размера символа под базовой линией в строке. Поле width будет хранить ширину строки как сумму всех горизонтальных размеров width символов в строке.

     Обозначим W как позицию символа относительно координаты x выводимой строки. Обозначим L как W + lbearing символа. Обозначим R как W + rbearing симола. Тогда поле lbearing в аргументе overall_return будет иметь минимальное значение L для всех символов в строке, а поле rbearing будет иметь максимальное значение R для символов в строке. В обычной ситуации это означает левый отступ первого символа строки и правый край последнего символа строки.

     Функция XQueryTextExtents может генерировать следующие ошибки:

• BadFont - ошибка указания шрифта.

Cм. также: XDrawString, XDrawString16, XDrawText, XDrawText16, XDrawImageString, XDrawImageString16, XQueryTextExtents16.