Xlib

Xlib

开发者	X.Org基金会
首次发布	大约1985年
当前版本	1.8.10（2024年7月28日；稳定版本）
源代码库	gitlab.freedesktop.org/xorg/lib/libx11
编程语言	C
类型	库
许可协议	Expat许可证 X11许可证 历史许可通知和免责声明
网站	www.x.org, 文档: www.x.org/releases/current/doc/libX11/libX11/libX11.html

Xlib是一种X Window System协议的客户端，以C语言撰写。其功能是与X server沟通。这样的功能可以让程序人员撰写程序时，毋须了解其协议的细节。但甚少应用程序会直接使用Xlib;通常是透过其他的函数库来调用Xlib用以提供部件工具箱（widget toolkits）：

Xlib及其应用

• Intrinsics（Xt）
• Xaw（Xaw）
• Motif
• GTK+
• Qt（X11 version）
• Tk

Xlib发表于1985年，目前使用在许多的Unix-like操作系统上。

目前XCB有可能取代Xlib.

资料类型

Xlib主要的资料类型是Display结构。

示例

下面是一个XLib的范列，产生一个视窗。

/*
  Simple Xlib application drawing a box in a window.
  gcc input.c -o output -lX11
*/

#include <X11/Xlib.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <stdbool.h>

int main(void)
{
  Display *d;
  Window w;
  XEvent e;
  char *msg = "Hello, World!";
  int s;

  bool done = false;

  /* open connection with the server */
  d = XOpenDisplay(NULL);
  if (d == NULL) {
    fprintf(stderr, "Cannot open display\n");
    exit(1);
  }

  s = DefaultScreen(d);

  /* create window */
  w = XCreateSimpleWindow(d, RootWindow(d, s), 10, 10, 640, 480, 0,
			  BlackPixel(d, s), WhitePixel(d, s));

  /* register interest in the delete window message */
  Atom wmDeleteMessage = XInternAtom(d, "WM_DELETE_WINDOW", False);
  XSetWMProtocols(d, w, &wmDeleteMessage, 1);
   
  /* select kind of events we are interested in */
  XSelectInput(d, w, ExposureMask | KeyPressMask | StructureNotifyMask);

  /* map (show) the window */
  XMapWindow(d, w);

  /* event loop */
  while (!done) {
    XNextEvent(d, &e);
    /* draw or redraw the window */
    if (e.type == Expose) {
      XFillRectangle(d, w, DefaultGC(d, s), 20, 20, 10, 10);
      XDrawString(d, w, DefaultGC(d, s), 50, 50, msg, strlen(msg));
    }

    /* exit on key press */
    switch(e.type){
      
    case KeyPress:
      XDestroyWindow(d, w);
      break;

    case DestroyNotify:
      done = true;
      break;

    case ClientMessage:
      if (e.xclient.data.l[0] == wmDeleteMessage){
	done = true;
      }
      break;      
    }
  }

  /* close connection to server */
  XCloseDisplay(d);

  return 0;
}

外部链接

• Xlib Programming Manual
• Manual pages for all Xlib functions （页面存档备份，存于互联网档案馆）
• Kenton Lee's pages on X Window and Motif （页面存档备份，存于互联网档案馆）
• A short tutorial on Xlib （页面存档备份，存于互联网档案馆）
• A longer tutorial on Xlib
• Using Xlib for creating a screensaver module （页面存档备份，存于互联网档案馆）
• Simple X11 toolkit for learning Xlib