XDrawText(display, d, gc, x, y, items, nitems)
	Display *display;
	Drawable d;
	GC gc;
	int x, y;
	XTextItem *items;
	int nitems;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• d - окно или графический образ для вывода графики;
• gc - используемый графический контекст;
• x, y - координаты начала текста;
• items - список строк, составляющих текст;
• nitems - количество строк в списке items.

    Функция XDrawText выводит текст в объект назначения d. Текст представляет собой набор строк, перечисленных в списке items. Вывод этих строк происходит по одной коодинате y. Шрифт, которым начинает выводиться текст берется из параметра font графического контекста, однако структура XTextItem позволяет указать другой шрифт для вывода строки. Эта структура также позволяет задавать дополнительный отступ по координате x перед выводом указанной в ней строки.

     На рисунке приведен пример вывода текста:

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

     Функция XDrawText использует следующие параметры графического контекста: function, plane_mask, fill_style, font, subwindow_mode, clip_x_origin, clip_y_origin и clip_mask. Также, в зависимости от режимов, установленных в графическом контексте, могут использоваться следующие параметры графического контекста: foreground, background, tile, stipple, tile- stipple- _x_origin, tile- stipple- _y_origin.

     Назначение перечисленных параметров приведено в описании структуры XGCValues.

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

• BadDrawable - ошибка указания окна или графического образа;
• BadFont - ошибка указания шрифта;
• BadGC - ошибка указания графического контекста;
• BadMatch - несоотвествие одного или нескольких аргуметов допустимым значениям.

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