// 连接X11 Server和获取根窗口
Display* display = XOpenDisplay(NULL);
Window root = DefaultRootWindow(display);
// 修改根窗口属性，其请求类型为ChangeWindowAttributes，窗口属性掩码值为CWEventMask
// 告知X11 server将client的顶层窗口的窗口请求和事件转发过来。
// SubstructureRedirectMask: CirculateRequest, ConfigureRequest, MapRequest
// SubstructureNotifyMask  : CirculateNotify, ConfigureNotify, CreateNotify, DestroyNotify, GravityNotify, MapNotify, ReparentNotify, UnmapNotify
XSelectInput(display, root, SubstructureRedirectMask | SubstructureNotifyMask);
XSync(display, false);
// 锁屏，禁止X11 server处理其它client的请求
XGrabServer(display);
 
Window returned_root, returned_parent;
Window* top_level_windows;
unsigned int num_top_level_windows;
// 发送QueryTree请求，获取X11 server上根窗口的直接子窗口，即client的顶层窗口。
XQueryTree(display, root, &returned_root, &returned_parent, &top_level_windows, &num_top_level_windows);
// 给顶层窗口套壳：创建一个新窗口，作为顶层窗口的父窗口，根窗口的子窗口
for (unsigned int i = 0; i < num_top_level_windows; ++i) {
  Window w = top_level_windows[i];
  Frame(w);
}
XFree(top_level_windows);
// 取消锁屏，恢复处理其它client的请求，一般来说窗口会加个边框
XUngrabServer(display);
 
// Main event loop.
// 1. 转发请求和事件处理，SubstructureRedirectMask和SubstructureNotifyMask对应的请求和事件
// 2. 对自身创建的窗口按键和鼠标处理，包括快捷键，鼠标拖动，最小化/最大化/恢复窗口等操作处理

const unsigned int BORDER_WIDTH = 3;
const unsigned long BORDER_COLOR = 0xff0000;
const unsigned long BG_COLOR = 0x0000ff;
 
// 获取窗口属性，主要是尺寸
XWindowAttributes w_attrs;
XGetWindowAttributes(display, w, &w_attrs)
 
// 发送CreateWindow请求，创建一个InputOutput窗口，以根窗口为父窗口
Window frame = XCreateSimpleWindow(display, root, w_attrs.x, w_attrs.y,
    w_attrs.width, w_attrs.height, BORDER_WIDTH, BORDER_COLOR, BG_COLOR);
 
// 告知X11 server将frame直接子窗口的窗口请求和事件转发过来。
XSelectInput(display, frame, SubstructureRedirectMask | SubstructureNotifyMask);
 
// 发送ChangeSaveSet (SetModeInsert)请求，告知X11 server保存w叠层次序，WM崩溃后，可复原w原有叠层次序
XAddToSaveSet(display, w);
 
// 发送ReparentWindow请求，将w的父窗口由根窗口改为frame窗口
XReparentWindow(display, w, frame, 0, 0);
 
// 发送MapWindow请求，显示frame窗口
XMapWindow(display, frame);
 
// 在客户端窗口上抓取通用窗口管理操作：移动、缩放、关闭和切换窗口
// 分别发送GrabButton和GrabKey请求，捕获w窗口指定的鼠标和键盘事件，X11 server将事件转发给frame
// 发送GrabButton请求，ButtonMotionMask响应MotionNotify事件，ButtonPressMask/ButtonPressMask表示响应按键的两个状态（Press, Release）事件
// 发送GrabKey请求，捕获按键请求，响应KeyPress和KeyRelease事件
// 看来Mod1Mask修饰表示Alt，Button1表示left，Button2表示right。两个同时按下，在MotionNotify响应函数时处理
 
// alt + left按键移动窗口
XGrabButton(display, Button1, Mod1Mask, w, false,
    ButtonPressMask | ButtonReleaseMask | ButtonMotionMask,
    GrabModeAsync, GrabModeAsync, NULL, NULL);
 
// alt + right按键缩放窗口
XGrabButton(display, Button3, Mod1Mask, w, false,
    ButtonPressMask | ButtonReleaseMask | ButtonMotionMask,
    GrabModeAsync, GrabModeAsync, NULL, NULL);
 
// alt + f4关闭窗口
XGrabKey(display, XKeysymToKeycode(display, XK_F4),
    Mod1Mask, w, false, GrabModeAsync, GrabModeAsync);
 
// alt + tab切换窗口
XGrabKey(display, XKeysymToKeycode(display_, XK_Tab),
    Mod1Mask, w, false, GrabModeAsync, GrabModeAsync);

// 在ButtonPress响应函数中记录光标坐标、窗口坐标，将窗口移到顶层
// 事件中XButtonEvent，记录了光标在根窗口的起始坐标(x_root, y_root)
Window returned_root;
int x, y;
unsigned width, height, border_width, depth;
 
// 发送GetGeometry请求，获得窗口的几何形状
XGetGeometry(display, frame, &returned_root,
    &x, &y, &width, &height, &border_width, &depth);
 
// 发送ConfigureWindow请求，掩码为CWStackMode，值为Above，将窗口移到最上层
XRaiseWindow(display, frame)
 
// 在MotionNotify响应函数中处理窗口移动
// 根据XMotionEvent中的光标坐标(x_root, y_root)、点击时的坐标和窗口坐标，计算w窗口在根窗口的坐标
// 由于frame未创建边框，w和frame的起始坐标一致。
 
// 发送ConfigureWindow请求，移动frame窗口
XMoveWindow(display, frame, frame_x, frame_y);

// 在ButtonPress响应函数中记录窗口尺寸，将窗口移到顶层
Window returned_root;
int x, y;
unsigned width, height, border_width, depth;
 
// 发送GetGeometry请求，获得窗口的几何形状
XGetGeometry(display, frame, &returned_root,
    &x, &y, &width, &height, &border_width, &depth);
 
// 发送ConfigureWindow请求，掩码为CWStackMode，值为Above，将窗口移到最上层
XRaiseWindow(display, frame)
 
// 在MotionNotify响应函数中处理窗口缩放
// 发送ConfigureWindow请求，掩码值为CWWidth|CWHeight，缩放窗口
XResizeWindow(display, frame, width, depth);
// 缩放客户端窗口
XResizeWindow(display, w, width, depth);

// 在KeyPress响应函数中优雅关闭窗口
  
Atom* supported;
int num_supported;
// 发送InternAtom请求，获取名为"WM_PROTOCOLS"的atom，supported中存在WM_DELETE_WINDOW
XGetWMProtocols(display, w, &supported, &num_supported);
 
XEvent msg;
memset(&msg, 0, sizeof(msg));
msg.xclient.type = ClientMessage;
msg.xclient.message_type = WM_PROTOCOLS;
msg.xclient.window = e.window;
msg.xclient.format = 32;
msg.xclient.data.l[0] = WM_DELETE_WINDOW;
// 发送SendEvent请求给X11 server，server发送ClientMessage给client，client根据WM_PROTOCOLS协议中WM_DELETE_WINDOW值销毁窗口
XSendEvent(display, w, false, 0, &msg)

// 在KeyPress响应函数中切换窗口
 
// 先从窗口管理器中找到w窗口下一层next_w窗口，然后将该窗口移到最上层。窗口管理器管理所有client顶层窗口，未在此例中列出  
 
// 发送ConfigureWindow请求，掩码为CWStackMode，值为Above，将窗口移到最上层
XRaiseWindow(display, next_frame);
// 发送SetInputFocus请求，窗口获取输入焦点。RevertToPointerRoot表示窗口不可见时，将输入焦点回退至根窗口
XSetInputFocus(display, next_w, RevertToPointerRoot, CurrentTime);

_NET_WM_WINDOW_TYPE_DESKTOP

_NET_WM_WINDOW_TYPE_DOCK

_NET_WM_WINDOW_TYPE_TOOLBAR

_NET_WM_WINDOW_TYPE_MENU

_NET_WM_WINDOW_TYPE_UTILITY

_NET_WM_WINDOW_TYPE_SPLASH

_NET_WM_WINDOW_TYPE_DIALOG

_NET_WM_WINDOW_TYPE_DROPDOWN_MENU

_NET_WM_WINDOW_TYPE_POPUP_MENU

_NET_WM_WINDOW_TYPE_TOOLTIP

_NET_WM_WINDOW_TYPE_NOTIFICATION

_NET_WM_WINDOW_TYPE_COMBO

_NET_WM_WINDOW_TYPE_DND

_NET_WM_WINDOW_TYPE_NORMAL

_NET_WM_STATE_MODAL

_NET_WM_STATE_STICKY

_NET_WM_STATE_MAXIMIZED_VERT

_NET_WM_STATE_MAXIMIZED_HORZ

_NET_WM_STATE_SHADED

_NET_WM_STATE_SKIP_TASKBAR

_NET_WM_STATE_SKIP_PAGER

_NET_WM_STATE_HIDDEN

_NET_WM_STATE_FULLSCREEN

_NET_WM_STATE_ABOVE

_NET_WM_STATE_BELOW

_NET_WM_STATE_DEMANDS_ATTENTION

_NET_WM_STATE_FOCUSED

typedef struct {
    long flags;         /* marks which fields in this structure are defined */
    // x, y, width, height由用户设置指定，已废弃使用
    int x, y;           /* Obsolete */
    int width, height;  /* Obsolete */
    // 窗口最小的宽度和高度
    int min_width, min_height;
    // 窗口最大的宽度和高度
    int max_width, max_height;
    // 缩放窗口的最小步幅
    int width_inc, height_inc;
    // 最大和最小的屏幕宽高比。x为宽，y为高
    struct {
           int x;           /* numerator */
           int y;           /* denominator */
    } min_aspect, max_aspect;
    // 最适合的宽度和高度，未设置时，以最小宽度和高度为准
    int base_width, base_height;
    // 指定参考坐标位置，默认为NorthWest
    int win_gravity;
    /* this structure may be extended in the future */
} XSizeHints;
 
// 设置几何形状约束函数
void XSetWMNormalHints(Display *display, Window w, XSizeHints *hints);
// 获取几何形状约束函数
Status XGetWMNormalHints(Display *display, Window w, XSizeHints *hints_return, long *supplied_return);