Функції бібліотеки Xlib XCreateSimpleWindow

АРГУМЕНТИ

  • display- покажчик на структуру, що описує з'єднання з X-сервером;
  • parent- ідентифікатор батьківського вікна;
  • x, y- координата лівого віхового кута вікна;
  • width, height- ширина та висота вікна;
  • border_width- товщина рамки навколо вікна;
  • border- значення кольору рамки;
  • background- значення кольору тла вікна;
ОПИС

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

Система координат утворюється з горизонтальної осі X та вертикальної осі Y з початком [0, 0] у лівому-верхньому куті екрану. Кожне вікно має власну систему координат. Початок системи координат вікна розташовано всередині рамки, у лівому верхньому куті вікна.

Такі параметри вікна як глибина кольоровості (depth), клас і візуальні параметри повністю успадковуються від батьківського вікна. Інші атрибути вікна, крімbackgroundіborderставляться значеннями, прийнятими за замовчуванням.

Для вікон класу InputOnly аргументborder_widthповинен бути нульовим.

Створене вікно не відображається на екрані. Щоб відобразити вікно, потрібно викликати функцію XMapWindow. Нове вікно спочатку використовує той же графічний курсор, що і його предок, новий курсор може бути визначений для нового вікна викликом XDefineCursor. Вікно залишиться невидимим доти, доки всі його предки не стануть видимими або буде повністю приховано іншими вікнами.

ФункціяXCreateWindow може генерувати такі помилки:

  • BadAlloc – X-сервер не може виділити запитаний ресурс чи пам'ять;
  • BadMatch - невідповідність одного чи кількох аргуметів допустимим значенням;
  • BadValue - якесь із числових значень виходить за допустимий діапазон;
  • BadWindow – помилка вказівки ідентифікатора вікна.