screen_create_window_group()

Создание оконной группы, к которой могут присоединиться другие окна

Прототип:

#include <screen/screen.h>
 
int screen_create_window_group( screen_window_t win,
                                const char      *name );

Аргументы:

win: Дескриптор окна, для которого будет создана группа. Это окно должно быть создано с помощью screen_create_window_type() с типом SCREEN_APPLICATION_WINDOW.
name: Уникальная строка для идентификации оконной группы. Данная строка должна быть известна другому окну, желающему присоединиться к группе в качестве дочернего окна win. Кроме уникальности, никаких дополнительных требований к имени не применяется.

Данная функция создает оконную группу и ассоциирует ее с определенным окном. Группа идентифицируется строкой, которая должна быть уникальной. Запрос будет отклонен в случае, если уже была создана другая группа с этой же строкой.

Возвращаемое значение:

0: Группа успешно создана.
-1: В случае ошибки, код ошибки записывается в errno.

Коды ошибок:

EINVAL: Некорректный аргумент.
ENOMEM: Недостаточно памяти для создания группы.
EFAULT: Создание группы завершилось с ошибкой на стороне сервера, либо невозможно установить её параметры.

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Screen

Поддерживается, начиная с ЗОСРВ «Нейтрино» редакции 2020

Безопасность использования
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Да

Предыдущий раздел: Группы