Window XCreateWindow(display, parent, x, y, width, height, border_width, depth,
                         class, visual, valuemask, attributes)
    Display *display;
    Window parent;
    int x, y;
    unsigned int width, height;
    unsigned int border_width;
    int depth;
    unsigned int class;
    Visual *visual
    unsigned long valuemask;
    XSetWindowAttributes *attributes;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• parent - идентификатор родительского окна;
• x, y - координата левого вехнего угла окна;
• width, height - ширина и высота окна;
• border_width - толщина рамки вокруг окна;
• depth - количество разрядов, отводящихся для кодирования цвета в окне;
• class - класс окна. Допустимые значения: InputOutput (ввод и вывод), InputOnly (только ввод) или CopyFromParent (установить тип как у окна-предка);
• visual - визуальные характеристики окна. Если указать CopyFromParent, данные будут взяты у окна-предка;
• valuemask - маска, указывающая, какие параметры из аргумента attributes следует указывать;
• attributes - расширенные параметры окна;

     Функция XCreateWindow создаёт выключенное окно-потомок для указанного окна-предка, возвращая идентификатор созданного окна. При создании окна X-сервер генерирует событие CreateNotify. Созданное окно располагается самым верхним среди окон, принадлежащих указанному предку. Части окна, выходящие за пределы родительского окна обрезаются.

     Система координат образуется из горизонтальной оси X и вертикальной оси Y с началом [0, 0] в левом-верхнем углу экрана. Каждое окно имеет свою собственную систему координат. Начало системы координат окна расположено внутри рамки, в левом-верхнем углу окна.

     Для окон класса InputOutput аргументы visual и depth должны составлять комбинацию, поддерживаемую экраном X-сервера, иначе будет получена ошибка BadMatch. Аргумент depth не обязательно должен быть таким же, какой установлен в окне-предке, однако окно-предок не должно быть окном класса InputOnly, иначе также будет получена ошибка BadMatch.

     Для окон класса InputOnly аргументы depth и border_width должны быть нулевыми, а visual должен поддерживаться экраном X-сервера. Если какое-либо из условий не удовлетворяется, возникает ошибка BadMatch. Для окон такого класса родительское окно может быть произвольного класса.

     Созданное окно сразу не показывается на экране. Чтобы отобразить окно, необходимо вызвать функцию XMapWindow. Новое окно изначально использует тот-же графический курсор, что и его предок, новый курсор может быть определен для нового окна вызовом XDefineCursor. Окно останется невидимым до тех пор, пока все его предки не станут видимыми или пока будет полностью скрыто другими окнами.

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

• BadAlloc - X-сервер не может выделить запрошенный ресурс или память;
• BadColor - ошибка указания цветовой палитры;
• BadCursor - ошибка указания графического курсора;
• BadMatch - несоотвествие одного или нескольких аргуметов допустимым значениям;
• BadPixmap - ошибка указания графического образа;
• BadValue - какое-то из числовых значений выходит за допустимый диапазон;
• BadWindow - ошибка указания идентификатора окна.

Cм. также: XChangeWindowAttributes, XConfigureWindow, XDefineCursor, XDestroyWindow, XMapWindow, XRaiseWindow, XUnmapWindow.