XCopyArea(display, src, dest, gc, src_x, src_y, width, height,  dest_x, dest_y)
	Display *display;
	Drawable src, dest;
	GC gc;
	int src_x, src_y;
	unsigned int width, height;
	int dest_x, dest_y;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• src, dest - исходный объект вывода и объект назначения;
• gc - маска, указывающая какие параметры контекста необходимо копировать;
• src_x, src_y - координаты левого верхнего угла области в исходном объекте;
• width, height - размеры области по горизонтали и вертикали;
• dst_x, dst_y - координаты для левого верхнего угла области в объекте назначения.

     Функция XCopyArea производит вывод прямоугольной области в объекте назначения dest используя данные из прямоугольной области такого же размера исходного объекта src. Если объекты вывода принадлежат разным корневым окнам или имеют разную глубину цветности, то возникает ошибка BadMatch.

     Регионы в исходном объекте, выходящие за пределы объекта, а также закрытые регионы, не сохранённые в backing_store, не копируются. В соответствующих местах объекта назначения, которые либо видны, либо которые закрыты, но сохранены в backing_store, производится заполнение фоном, определённым для объекта назначения (по всем плоскостям функцией GXCopy).

     Независимо от того, является объект назначения окном или графическим образом, если в графическом контексте gc флаг graphics-exposures установлен в True, то генерируется одно или несколько событий GraphicsExpose для всех изменённых участков объекта назначения. Если флаг graphics-exposures в графическом контексте установлен, но необходимости в генерации событий GraphicsExpose не возникло, то генерируется событие NoExpose. Следует иметь ввиду, что по-умолчанию значение флага graphics-exposures при создании графического контекста устанавливается в True.

     При копировании областей используются следующие параметры графического контекста: function, plane_mask, foreground, background, subwindow_mode, graphics_exposures, clip_x_origin, clip_y_origin и clip_mask. Назначение этих параметров рассмотрено в описании структуры XGCValues.

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

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

Cм. также: XClearWindow, XClearArea.