Cause a window to join a window group


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


The handle for the window that is to join the group.
A unique string that identifies the group. This string must have been communicated down from the parent window.




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).