Cause a window to join a window group
#include <screen/screen.h>
int screen_join_window_group(screen_window_t win, const char *name)
Function Type: Delayed Execution
This function is used to add a window to a group. Child and embedded windows will remain invisible until they're properly parented.
Until the window joins a group, a window of any type behaves like an application window. The window's positioning and visibility are not relative to any other window on the display.
Once a window successfully joins a group, its position on the display is relative to the parent. The type of the window determines exactly how the window is positioned. Child windows are positioned relative to their parent (i.e., their window position is added to the parent's window position. Embedded windows are positioned relative to the source viewport of the parent.
Windows in a group inherit the visibility and the global transparency of their parent.
0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).