Status XQueryBestSize(display, class, which_screen, width,
			    height, width_return, height_return)
	Display *display;
	int class;
	Drawable which_screen;
	unsigned int width, height;
	unsigned int *width_return, *height_return;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• class - назначение графического образа ( CursorShape, TileShape или StippleShape);
• which_screen - объект назначения вывода;
• width, height - предполагаемые размеры;
• width_return, height_return - возвращаемое значение оптимальных размеров, наиболее близких к предполагаемым;

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

     В случае CursorShape просто возвращается максимальный размер графического образа, который может полностью отображаться на экране, которому принадлежит объект назначения which_screen.

     Для TileShape и StippleShape возвращаются такие размеры графических образов, которые обеспечат максимальную производительность при использовании их в качестве параметров tile и stipple в графическом контексте. Аргумент which_screen, кроме определения экрана в этом случае еще используется и для анализа таких параметров, как возможные глубина и визуальные типы объектов назначения.

     Если в which_screen указывается окно, то оно должно быть окном InputOutput. Если указать окно InutOnly, появится ошибка BadMatch.

     Более подробно принцип работы графических образов tile и stipple в графических контекстах вывода можно узнать в описании структуры XGCValues.

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

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

Cм. также: XCreateGC, XCopyGC, XChangeGC, XGetGCValues, XFreeGC, XGContextFromGC, XSetArcMode, XSetClipOrigin, XSetPlaneMask, XSetFillStyle, XSetFont, XSetLineAttributes, XSetTile,