XQueryTextExtents16(display, font_ID, string, nchars, direction_return,
			font_ascent_return, font_descent_return, overall_return)
	Display *display;
	XID font_ID;
	XChar2b *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 - возваращаемые общие значения размеров строки.

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

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

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

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

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

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

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