Index:
Property & Atom
Atom
Property
Cut Buffer
Window Manager
WM_NAME
WM_ICON_NAME
WM_NORMAL_HINTS
WM_HINTS
WM_CALSS
Selection
Owner & Requestor
例 1
传输大量资料 - INCR
例 2
Selection Atom
Functions of Selection
Client Message
Property & Atom
在 X 的世界中, 每一个视窗都随附着一些资料, 称为 property. 每个 property 都有一个名称, 和 type. 每
个 property 的 type 指定了资料的资料形态
(type), 如 INTEGER, PIXMAP, CURSOR, ... etc. 而 名称则为存取 property 的途
径, client 透过名称以存取特定视窗 的某个 property. property 可以是由 client 自定, 或由 system 内
建. X 内建了许多 property , 用於视窗管理(window manager 管
理). 如: WM_CLASS, WM_NAME, WM_ICON_NAME, ... etc.
Atom
因为效率因素的考量, 这些 property 的名称和 type 以 atom 表示. 在 系统, 每一个 atom 以一个整数
(atom ID)表示, 代表着一个字串. 而且 每一个 atom 都是唯一的, 没有任何两个 atom 拥有相同的 ID. 当我
对 X Server 发出 request 而需要这些字串时为参数时, 我们就以对应的 atom ID 为参数, 这样可以降低字串在网路上传轮
的 overhead, 改进系统效率. Xlib 提供 一些 function, 让我们在 atom 和字串之间转换. 当 client 导入一
个新的 字串进入系统时, Xlib 也提供 function 以取得一个唯一,而且不重的 atom ID, 以对应新加入的字串. 因
此, 由 client 导入的字串, 在每一次 执行时, 不一定会得到同一个 atom ID. 但, 由系统内建的 atom 则有固
定 的 ID, 这些 atom 定义在 (XA_prefix 形式, 如 XA_WM_CLASS).这
些 atom 可以 hard code 在程式碥, 不需再经过 Xlib 所提供的 function 加以转换.
atom 除了用於 property 名称和 property type 之外, 还用
於 selection , Font property, type of client message 等等.
下面是 Xlib 提供的 function, XInterAtom 可从 string 转换
成 atom ID, XInterAtoms 则一次可以转换多个字串. XGetAtomNames 则是由 atom 取得字串.
--------------------------------------------------------------------------------
Atom XInternAtom(display, atom_name, only_if_exists)
Display *display;
char *atom_name;
Bool only_if_exists;
--------------------------------------------------------------------------------
由 atom_name 指定要转换的字串, XInternAtom 传回对应
的 atom ID. 当 only_if_exists 为 True, 若字串原本不存在系统, 则会为其分配 一个不重
的 ID. 若 only_if_exists 为 False 时, 只有在 atom 早己 存在时才会传回 atom ID, 否则会传
回 None.
--------------------------------------------------------------------------------
Status XInternAtoms(display, names, count, only_if_exists,
atoms_return)
Display *display;
char **names;
int count;
Bool only_if_exists;
Atom *atoms_return;
--------------------------------------------------------------------------------
XInternAtoms 和 XInternAtom 功能相同, 但一次转换多个 atom, 由 names 传入每个字
串, count 是字串的数目, 由 atoms_return 传回 atom ID 阵列. only_if_exists 为 False, 只
有己存在的 atom 会 传回 atom ID, 不存在的 atom 会传回 None. only_if_exists 为 True 时, 则会
为不存在的 atom 配置一个 atom ID. 这个函数只有在所有的字串都 传回 atom ID 时, 才传回不为 0 的数字, 否则传
为 0.
--------------------------------------------------------------------------------
char *XGetAtomName(display, atom)
Display *display;
Atom atom;
--------------------------------------------------------------------------------
XGetAtomName 可从 atom ID 取得对应字串.
--------------------------------------------------------------------------------
Status XGetAtomNames(display, atoms, count, names_return)
Display *display;
Atom *atoms;
int count;
char **names_return;
--------------------------------------------------------------------------------
和 XGetAtomName 相同, 但可一次转换多个 atom.
Property
--------------------------------------------------------------------------------
int XGetWindowProperty(display, w, property, long_offset,
long_length, delete, req_type, actual_type_return,
actual_format_return, nitems_return, bytes_after_return,
prop_return)
Display *display;
Window w;
Atom property;
long long_offset, long_length;
Bool delete;
Atom req_type;
Atom *actual_type_return;
int *actual_format_return;
unsigned long *nitems_return;
unsigned long *bytes_after_return;
unsigned char **prop_return;
--------------------------------------------------------------------------------
XGetWindowProperty 为我们传回 property 的内容, client 指定 display, 视窗
(w), property, 从资料那个位置(long_offset)开始读取和 读取长度
(long_length). delete 为 True or False, 指定是否在读取之後, 将 property 删
除. long_length 是以 4 bytes 为单位, 也就是你实际指定 的长度是 long_length * 4. 另
外 req_type 指定 property 资料的 type, 若你不计较 property 资料的 type, 那麽你可以指
定 AnyPropertyType. 而此 function 则传回资料的实际 type(actual_type_return), 资料
的 format(单位长度 8, 16, 32;actual_format_return), 传回多少个单位 的资料(实际长度
/format;nitems_return), 结尾还有多少资料 (bytes_after_return)和 property 内容
(prop_return).注意: 改变 property 或 delete property 会产
生 PropertyNotify event.
若我们所要读取的 property 并不存在, 那麽 XGetWindowProperty 会 传回 None 实际资
料 type(actual_type_return).
--------------------------------------------------------------------------------
int XGetWindowProperty(display, w, property, long_offset,
long_length, delete, req_type, actual_type_return,
actual_format_return, nitems_return, bytes_after_return,
prop_return)
Display *display;
Window w;
Atom property;
long long_offset, long_length;
Bool delete;
Atom req_type;
Atom *actual_type_return;
int *actual_format_return;
unsigned long *nitems_return;
unsigned long *bytes_after_return;
unsigned char **prop_return;
--------------------------------------------------------------------------------
XGetWindowProperty 为我们传回 property 的内容, client 指定 display, 视窗
(w), property, 从资料那个位置(long_offset)开始读取和 读取长度
(long_length). delete 为 True or False, 指定是否在读取之後, 将 property 删
除. long_length 是以 4 bytes 为单位, 也就是你实际指定 的长度是 long_length * 4. 另
外 req_type 指定 property 资料的 type, 若你不计较 property 资料的 type, 那麽你可以指
定 AnyPropertyType. 而此 function 则传回资料的实际 type(actual_type_return), 资料
的 format(单位长度 8 bits, 16 bits, 32 bits;actual_format_return), 传回多少个单位的资料
(实际长度/format;nitems_return), 结尾还有多 少资料(bytes_after_return)和 property 内容
(prop_return).
因为 X 的网路特性, 让我们不得注意 byte order 的问题. 资料在网路 上传送, 我们无法知道在网对面的接收端电脑的资料表示
形式是否和我们 相同. 如一个 32 bits - 4bytes 的整数, 低位元和高位元的存放次序在 不同的电脑上就不太相同. 也许在 A 机
器的储放方式是先最低位的 byte 然後次低位,然後次高位,最後最高位. 然 B 机器却可能相反. 因此, 每 个 property 都必需指
定 format, 以确定资料单位的单位长度, 这样 Xlib 才能自动进行 byte order 的转换, 确保资料
的 byte order 不会 错乱.
若我们所要读取的 property 并不存在, 那麽 XGetWindowProperty 会 传回 None 实际资
料 type(actual_type_return). actual_format_return 和 bytes_after_return 也皆
为 0. nitem_return 则传回 0(empty).
若 property 存在, 但是 req_type(request type) 和 property 的实际 type 不合(不相
同), 那麽 XGetWindowProperty 在 actual_type_return 传回实 际
的 type, 在 actual_format_return 传回 property 资料
的 format, bytes_after_return 则以 byte 为单位, 传回 property 的实际长度. 这
时, nitem_return 则为 0, 也就是不传回任何资料(空的;empty).
若 property 存在, 且指定 AnyPropertyType 或 property type 和指定 的 type 吻
合, 则 XGetWindowProperty prop_return 传回 property 的内容.
--------------------------------------------------------------------------------
N = property 的实际长度(以 byte 为单位)
I = 4 * long_offset
T = N - T
L = MINIMUM(T, 4 * long_length)
A = N - (I + L)
--------------------------------------------------------------------------------
prop_return 传回的资料长度为 L, 但 XGetWindowProperty 总是会多配置 一个 byte 的空间, 在这个
多馀的 byte 填上 0, 这样方便字串的使用, 不需进行 null terminate, 增加 copy 的动
作. bytes_after_return 则 传回 A, 告知 client 在传回这些资料後, 还有多少资料在後
面. prop_return 的内容是从 property 的第 I 个 byte 开始, 一直
到 (I + L - 1) byte, prop_return 的空间是於 Xlib 自动配置, client 程式最後必需透
过 XFree() 将之释放.
--------------------------------------------------------------------------------
Atom *XListProperties(display, w, num_prop_return)
Display *display;
Window w;
int *num_prop_return;
--------------------------------------------------------------------------------
XListProperties 可传回随附在视窗(w)的所有 property 名称 (名称字串
的 atom). num_prop_return 是实际 property 的个数, 名称 atom 直接从 return value 传
回 atom list. 若视窗(w)没有任有 property, 则 function 传回 null pointer. 传回
的 atom list 最後必需以 XFree() 释放.
--------------------------------------------------------------------------------
XChangeProperty(display, w, property, type, format, mode,
data, nelements)
Display *display;
Window w;
Atom property, type;
int format;
int mode;
unsigned char *data;
int nelements;
--------------------------------------------------------------------------------
透过 XChangeProperty 可以修改增加 property 的内容. property 和 type 分别传
入 property 的名称 atom 和 type atom, format 可以指定 8, 16, 32. nelements 则是传入资料
的单位个数, data 则为资料内容. mode 则指 定修改方
式, PropModeReplace, PropModePrepend, 或 PropModeAppend.
PropModeReplace
以新的资料完全取代旧内容.
PropModePrepend
新资料插入到旧资料之前
PropModeAppend
新资料插入到旧资料之後
PropModePrepend 和 PropModeAppend mode, 新资料的 type 和 format 必需和旧资料相同.
--------------------------------------------------------------------------------
XDeleteProperty(display, w, property)
Display *display;
Window w;
Atom property;
--------------------------------------------------------------------------------
删除 property.
Cut Buffer
Cut Buffer 是一种简单, 但是功能、效果较不好的 peer-to-peer 讯通架构. Cut Buffer 是属於一种被动的
形式, 资料提供者直接将资料放在 cut buffer。 当其它 client 有需要时，直接从 cut buffer 将资取出，资料的要求者和
资 料的提供者之间没有直接的互动。
Cut buffer 机制包含 8 个在 screen 0 的 root window 的 property, 分别
以 atoms CUT_BUFFER0 ... CUT_BUFFER7 命名。存在 cut buffer property 的资料，必
需 是 STRING type 并且 format 8。资料提供者在储存资料之前，必需先确定这些 property 是否存在。确定的方式是透
过 XChangeProperty() 函数, append 长度 为 0 的资料至 CUT_BUFFER0 ... CUT_BUFFER7。
资料提供者在每次储存资料至 CUT_BUFFER0 ... CUT_BUFFER7 之前，必需先 做 rotate property 的
顺序。透过 XRotateWindowProperties 函数，将 CUT_BUFFER0 改名
为 CUT_BUFFER1, CUT_BUFFER1 改为 CUT_BUFFER2 ...... CUT_BUFFER7 改名
为 CUT_BUFFER0。 写入 Cut buffer 的机制如下:
资料提供者确定 CUT_BUFFER0 ... CUT_BUFFER7 存在.(XChangeProperty)
Rotate Properties
将资料存入 CUT_BUFFER0
Client 在读取资料时，也会希望输替读取 CUT_BUFFER0 ... CUT_BUFFER7 的 内容，那麽需要在读取资料之後，
透过 XRotateWindowProperties 函数，将 CUT_BUFFER0 ... CUT_BUFFER7 改
名，CUT_BUFFER7 变
成 CUT_BUFFER6 ，CUT_BUFFER6 变 CUT_BUFFER5, ......, CUT_BUFFER0 变
成 CUT_BUFFER7。 读取 cut buffer 的机制如下:
读取 CUT_BUFFER0
Rotate Properties
Window Manager
当 client 执行时, 除了要处理视窗的内容外, 还需要和 Window Manager 配合, 提
供 Window Manager 必要的资讯, 如视窗的名称(WM_NAME),icon 等等, 让 Window Manager 进行装饰工作
(如显示 title, 提供视窗的外框). 这 些由 client 提供给 Window Manager 的资讯称为 hint, 是透
过 property 的机制附属於 top window.我们可以直设定 property, 或经由 Xlib 提供的 function, 提
供 Window Manager Hint
以 client 的观点而言, top window 可分为三种状态
Normal
Iconic
Withdrawn
视窗刚被建立时, top window 初始在 Withdrawn, 此时视窗尚未 map. 一旦 map 之
後, top window 即进入 Normal 或 Iconic state. 之後, 因 map 和 unmap 而
在 Normal 和 Iconic 之间转换. Normal state 即一般的视窗模式, 相对於 Iconic state, 视窗只以一个
小 icon 表示.
WM_NAME
通常 Window Manager 会在 Window 的上方放置一个 title bar, 用以 显示 Window 的名
称. Window Manager 透过 Client 设定 WM_NAME property, 取得 Client 希望设定的讯
息. WM_NAME 是一个经过编码的 字串, 而字串的 encoding 则由 property 的 type 决定. 例如
以 STRING 为 property type, 则字串的内容为 ISO Latin-1 character 再加上一些控制字
元; COMPOUND_TEXT 则为 Compound Text interchange format 字串, 为一种可以包含 Multi-
language 的字串格式(此格式内 容烦长, 需另写文章介绍).
--------------------------------------------------------------------------------
void XSetWMName(display, w, text_prop)
Display *display;
Window w;
XTextProperty *text_prop;
typedef struct {
unsigned char *value;/* property data */
Atom encoding; /* type of property */
int format; /* 8, 16, or 32 */
unsigned long nitems;/* number of items in value */
} XTextProperty;
--------------------------------------------------------------------------------
Xlib 提供 XSetWMName 做为方便函数, 但使用起来似乎没有比直接 使用 XChangeProperty 方便到那去. 使
用 XChangeProperty 修改 WM_NAME property 时, type 参数即
和 XTextProperty::encoding 相当, 可以
为 STRING, COMPOUND_TEXT 或 C_STRING 等 type.
WM_ICON_NANE
WM_ICON_NAME 指定 window 的 icon 名称. Window Manager 将一个 视窗变成 icon 形式
时, 通常会在 icon 下方显示字串, 以提醒使用 者该 icon 和代表的内容. 当 window 进入 icon 状态时, 由
於 icon 的面积往往较小, title bar 上的讯息通常太长, 以致於不适合做为 icon 名称. 所以 WM_ICON_NAME 需要
由 Client 设定一较精简的讯息, 以反应其内容.
WM_NORMAL_HINTS
WM_NORMAL_HINTS property 的 type 为 WM_SIZE_HINTS, 设定和 window 大小相关的资
料, 如视窗的最大宽度和高度. 当使用者欲 改变视窗大小时(如将视窗拉大), Window Manager 会参
考 WM_NORMAL_HINTS, 以控制 window 的行为.
WM_NORMAL_HINTS 的内容如下:
--------------------------------------------------------------------------------
Field Type Comments
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
flags CARD32 见下表
pad 4*CARD32 For backward compatibility
min_width INT32 宽度最小值
min_height INT32 高度最小值
max_width INT32 宽度最大值
max_height INT32 高度最大值
width_inc INT32 视窗宽度的变化值
height_inc INT32 视窗高度的变化值
min_aspect (INT32,INT32)
max_aspect (INT32,INT32)
base_width INT32 初始的宽
base_height INT32 初始的高
win_gravity INT32 default=NorthWest
--------------------------------------------------------------------------------
下面定义 WM_SIZE_HINTS.flags bits:
--------------------------------------------------------------------------------
Name Value Field
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
USPosition 1 User-specified x, y
USSize 2 User-specified width, height
PPosition 4 Program-specified position
PSize 8 Program-specified size
PMinSize 16 Program-specified minimum size
PMaxSize 32 Program-specified maximum size
PResizeInc 64 Program-specified resize increments
PAspect 128 Program-specified min and max aspect ratios
PBaseSize 256 Program-specified base size
PWinGravity 512 Program-specified window gravity
--------------------------------------------------------------------------------
WM_SIZE_HINTS.flags 用以告知 Window Manager, Client 设定 WM_SIZE_HINTS 那些栏
位. 但 USPosition 和 USSize 则是例外, 告知 Window Manager 视窗第一次 map 时, 可由使用者指定视
窗 位置和大小. PPosition 和 PSize 则是另一个另外, 告知 Window Manager 视窗第一次 map 时, 位置和大小
全由 client 自行控制, 不需经过使用者指定.
PMinSize 和 PMaxSize 所指定的栏
位 min_width, min_height, max_width, max_height 告知 Window Manager, 当使用调整视
窗 的大小时, 希望视窗大小不超过这几个极限值.
PResizeInc 和 PBaseSize 的栏
位 width_inc, height_inc, base_width 和 base_height 形成下面两修公式:
width = base_width + (i * width_inc)
height = base_height + (j * height_inc)
i 和 j 是大於零的整数. 当使用者调整视窗大小时, client 希望 Window Manager 只让 user 将视窗调整为符
合上列公式所得的宽和高, 成为 perferred window size. 若 base_width 和 base_height 没有指
定, 则 Window Manager 以 min_width 和 min_height 做为 base.
PAspect 和 PBaseSize 的栏位形成下面公式:
min_aspect[0] / min_aspect[1] <
(width - base_width) / (height - base_height) <
max_aspect[0] / max_aspect[1]
在每次改变视窗大小时, Window Manager 会检查上面的不等式是否成立, width 和 height 为视窗的宽和
高. 若 client 没有指定 base size, 那麽 width 和 height 就不 需减去 base size, 也就是使用下面
的 式子:
min_aspect[0] / min_aspect[1] <
width / height <
max_aspect[0] / max_aspect[1]
这些不等式, 更进一步限制 preferred window size 的比例.
PWinGravity 指定 client window 要如何移位(shift), 以维
持 window manager frame 和 client window 的位置 关. PWinGravity 可以
是 Static, NorthWest, NorthEast, SouthWest, SouthEast, North, South, East, West 和 Center. 若
指定 Static, 则 client window 保位置, window manager frame 临接在 client window 的
外缘; window manager frame 的内缘和 client window 的 border 位在相同位置. 其
它 win_gravity 指定的值, 指定了一个参考 点
(referrence point). North, South, East, West 指定参考点於 於相对应的外围边缘
(outer border; 视窗的外框线)的中心
点. NorthWest, NorthEast, SouthWest 和 SouthEast 指定对应的角落为 参考点
(referrence point). Center 则指定视窗之中央为 referrence point. 若是指定 Static 以外
的 PWinGravity 值, 则 window manager frame 的 referrence point 将会位
於 client window 从 Withdrawn state 变成其
它 state 时, client window 的 referrence point 的 位置. 即 client window 的位置会适当
的位移(shift), 以使的 frame 的 referrence point 能置於原
本 client window referrence point 的位置.
WM_HINTS
WM_HINTS property 的 type 为 WM_HINTS, 提供 window manager 除了位置大小和名称以外的资
讯, 让 client 能向 window manager 进行一些视窗行为的建议.
--------------------------------------------------------------------------------
Field Type Comment
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
flags CARD32 请见下表
input CARD32 The client's input model
initial_state CARD32 第一次 map 时的状态
icon_pixmap PIXMAP icon 的图形
icon_window WINDOW 显示 icon 图形的视窗
icon_x INT32 icon 位置的 x 座标
icon_y INT32 icon 位置的 y 座标
icon_mask PIXMAP icon 形状的 mask
window_group WINDOW group leader 的 window ID
--------------------------------------------------------------------------------
下表定义 WM_HINTS.flags bits:
--------------------------------------------------------------------------------
Name Value Field
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
InputHint 1 input
StateHint 2 initial_state, 参考下表
IconPixmapHint 4 icon_pixmap
IconWindowHint 8 icon_window
IconPositionHint 16 icon_x & icon_y
IconMaskHint 32 icon_mask
WindowGroupHint 64 window_group
MessageHint 128 (obsolete)
UrgencyHint 256 urgency
--------------------------------------------------------------------------------
initial_state:
--------------------------------------------------------------------------------
State Value Comment
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
NormalState 1 视窗内容可见
IconicState 3 视窗在 icon 状态
--------------------------------------------------------------------------------
WM_HINTS.flags 指定 client 设定的 WM_HINTS property 栏 位. 上面第二表定义各栏位的对
应 flag bit.
input 栏位的值为 True or False. 当使用者点选视窗时, 通常 window manager 会将 Focus 转移
至 user 点选的视窗, 以供使 用者在该视窗进行输入资料的动作. input 栏位若为 True, window manager 就会主动
将 focus 设定在 user 指定的 top window. 若 input 栏位为 False, 则 window manager 将不会
设定 focus 至 该 top window. 因此, 一些 input only 的视窗, 例如小时钟之类的 程式, 就不需
要 focus, 可以将 input 栏位设为 False. 虽然 window manager 不主动转移 focus 至 input 栏位
为 False 的 top window, 但是 client 还是可以自行主动进行 focus 的转移, 取得 focus.
initial_state 可
为 NormalState 或 IconicState. 为 NormalState 时, top window 第一次 map 会进
入 normal state. 为 IconicState 时, 则会进入 iconic state.
icon_pixmap 指定该视窗的 icon 图形. 关於 icon pixmap 有几个规定:
若有 WM_ICON_SIZE property 存在於 root 视窗, 则 pixmap 必需是 WM_ICON_SIZE 所指的其
中一个大小.
pixmap 的 deep 必需为 1 bit.
icon_mask 用来指定 icon 的形状, 去除不必要的陪份, 让 icon 不只是 矩形, 也可以是不规则形.
也许你希望使用自己指定的视窗做为 icon, 那麽你就必需将 window id 设定於 icon_window. 如
此, client 可以自行控制 icon 行, 做一些不同 的变化.
flags bit, UrgencyHint 告知 window manager 视窗的内容是属於紧急 性的, 如
此 window manager 可以做特别的处理, 以提醒 user. UrgencyHint 状态可以随时改便, 随
时 set or unset. 当一 top window 离开 Withdrawn state 後, window manager 就必需随时
注意 UrgencyHint 的变化, 以及时做出反应.
WM_CLASS
WM_CLASS property 的 type 为 STRING, 包含两个连续, null-terminated 的字串, 分别
为 application 的 instance name 和 class name. 这两个 name 用
於 window manager 或 client 存取 application 的 resource 时使用, 做为识别名称
(identify). 关於 resource 在往後 的章节另有说明.
Selection
在 X 环境, 两个 client 之间要如何交换讯息呢? client 之间不能 像一般的程式一样, 开个共同存取的档案, 而
且 client 可能各自使用 不同的协定和 X Server 通讯, 因此不能假定能透过一般的方式和其它 client 沟
通. X client 之间主要的通讯方式是透过 selection 机制. Atom 在这也扮演 selection 的名称, 做为存取的媒
介.
selection 主要是用於 client 之间传输资料, 如: 常用於视窗之间的 copy & paste 动作. 我们先
在 A 视窗 mark 要 copy 的资料, 然於 再於 B 视窗 paste, 於是 A 视窗成了资料的拥有者, B 视窗成了资 料的要求
者. 当在 A 视窗完 mark 资料的动作之後, A 视 窗取得一个 selection S 的拥有权, 成为 S 的拥有者, 等待资料要求者
的要求. 然後我们在 B 视窗进行 paste 动作时, B 视窗就向 S 进行要求(SelectionRequest), 这个
对 selection S 的要会转送到 S 的拥有者 A 视窗. A 视窗 收到要求後就将资料传送给 B 视窗. 接我们又在 C 视窗进
行 paste 动作, 同样的 C 视窗也对 S 进行要求, 而 A 视窗则继续服务 对 S 提出的要求, 直到其它视窗夺走(取得) S 的拥有
权, 或着 A 视 窗自动放弃 S 的拥有权.
Owner & Requestor
系统内可以有多个 selection 存在, 每个 selection 有自已的名称. 这些 selection 是整
个 display 共用的, 除了系统预定的 selection , client 之也可以定义自己的 selection. 每
个 selection 可以有一 个拥有者(owner)视窗, 但 selection 不一有拥有者. 当视窗准备好 资料, 视窗的拥有
者 client 透过 XSetSelectionOwner() 函数宣告视窗 成为 selection 的新拥有
者. 若 selection 原本就有一个拥有者, 在改变拥有者时, 原拥有者会得 SelectionClear event, 得知不再拥
有 该 selection.
Selection 的要求者(requestor)则透过 XConvertSelection() 函数对 selection 进 行要
求, 这时拥有者会收到 SelectionRequest event. SelectionRequest 包含几个参
数, selection, target, property, 和 requestor. target 指定要求的资料形态, 例
如 INTEGER, PIXMAP, AnyPropertyType. 拥有者 将资料转换成 target 指定的 type, 然後才传送
给 requstor 指定的视窗. 传送流程 中, 若拥有者有能力提供 target 指定的资料 type, 则拥有者将资料写
入 SelectionRequest 指定的 property, 然後拥 有者传送 SelectionNotify 给 requestor, 告
知资料己经备妥. 拥有者必需设定 SelectionNotify 的 selection, target, property 和 time 等参
数. 这些参数必需和 SelectionRequest 得到的对应参 数相同. 若拥有者无法提供 target 指定的资料 type, 或者无法
顺利写入 property, 则 SelectionNotify 的 property 参数需设为 None, 以示无法提供资料.
要求者在收到 SelectionNotify 之後, requestor 就从 SelectionNotify 指定
的 property(!= None) 读取资料, 最後将 property delete (透
过 XGetWindowProperty, delete=True). property 被 delete 之後, 拥有者会得
到 PropertyNotify, 以得知 requestor 己传完资料. 拥有者在得知资料 己传送完毕前, 必需保持资料的完整性, 直到传送
完成之後, 才可以 对使用者做回馈反应. 拥有者(owner)为了要在最後能收到 PropertyNotify 必需在传
送 SelectionNotify 之前, 对 requestor 视窗的 PropertyNotify 表示兴趣
(XSelectInput), 才能正确的收到 event.
要求者若要求一个没有拥有者(owner)的 selection 时, 这明显的得不到 任何资料, X Server 会自动产生一
个 property=None 的 SelectionNotify.
Request selection 的流程:
要求者: XConvertSelection()
拥有者:
收到 SelectionRequest
将资料转换成 target 指定的 type
然後将资料 replace property 的资料, 传送 SelectionNotify 要求者.
要求者:
收到 SelectionNotify
读取 property 并 delete property.
要求者完成所有步骤.
拥有者:
收到 PropertyNotify(state=Deleted).
拥有者完成 request 的 service.
下面是本章各 event 的结构:
--------------------------------------------------------------------------------
typedef struct {
int type;
unsigned long serial; /* # of last request processed by server */
Bool send_event; /* true if this came from a SendEvent request */
Display *display; /* Display the event was read from */
Window owner;
Window requestor;
Atom selection;
Atom target;
Atom property;
Time time;
} XSelectionRequestEvent;
--------------------------------------------------------------------------------
Structure of SelectionNotify:
--------------------------------------------------------------------------------
typedef struct {
int type;
unsigned long serial; /* # of last request processed by server */
Bool send_event; /* true if this came from a SendEvent request */
Display *display; /* Display the event was read from */
Window requestor;
Atom selection;
Atom target;
Atom property; /* ATOM or None */
Time time;
} XSelectionEvent;
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
typedef struct {
int type;
unsigned long serial; /* # of last request processed by server */
Bool send_event; /* true if this came from a SendEvent request */
Display *display; /* Display the event was read from */
Window window;
Atom selection;
Time time;
} XSelectionClearEvent;
--------------------------------------------------------------------------------
Structure of PropertyNotify:
--------------------------------------------------------------------------------
typedef struct {
int type;
unsigned long serial; /* # of last request processed by server */
Bool send_event; /* true if this came from a SendEvent request */
Display *display; /* Display the event was read from */
Window window;
Atom atom;
Time time;
int state; /* NewValue, Deleted */
} XPropertyEvent;
--------------------------------------------------------------------------------
例 1
程式
signature
传输大量资料 - INCR
利用 property 做为传输媒介时, 由於 property 是属於系统资源, 当 资料量大时, 耗用系统大量的资源, 因此实在不适
合一次塞进这麽多资 料, 造成系统资源的使用效率低落. 因此 selection 在 ICCCM 提供 了一个传送大量资料时的成规.
当 selection 传送大量资料的完整流程如下:
拥有者传送 property type 为 INCR 的 SelectionNotify 给拥
有 者, type INCR (incrementally) 是一种整数, 记录整个 selection 的资料大小.
要求者收到 SelectionNotify, property 的 type 为 INCR, 这时 要求者可以从 property 取得
整个 selection 的资料量(integer) ; 以byte 为单位计
算. 并 delete property. delete property 会造
生 PropertyNotify(state=Deleted).
拥有者收到 PropertyNotify(state=Deleted), 将一小部分还未传输 的资料附加(append)
到 property. 这个 property 和前面的 SelectionNotify 的 property 相同. 由
於 property 改变, 这导致 PropertyNotify(state=NewValue) event.
要求者收到 PropertyNotify(state=NewValue) event, 从 property 读取资
料, 并 delete property 产生 PropertyNotify(state= Deleted).
goto step 3 until 没有未传资料.
拥有者收到 PropertyNotify(state=Deleted)对 property append 长度 0 的资料.
要求者收到 PropertyNotif(state=NewValue), 从 property 读取 资料长
度 0, 并 delete property 产生 PropertyNotify(state= Deleted). 要求者完
成 selection request.
拥有者收到 PropertyNotify(state=Deleted), 完成
对 selection request 的 service.
Selection Atom
前面说过, selection 可以由 client 自行定义, 每一个 selection 都以 atom 命名. X 环境定义三
个 selection atom, 让各种 client 可以遵循, 让各种不特定的 client 能够相互沟通.
PRIMARY
主要用於当作 command 的第一个 selection 参数
SECONDARY
当作需要两个 selection 参数的 command 的第二个参数, 或其它原因不愿使 用 PRIMARY 时使用.
CLIPBOARD
做为一般 copy & paste 动作使用.
在 ICCCM 说道, 习惯上, 一般的 client 只也支援上面三个 selection, 反过来说, client 至少要能支援上
面三个 selection. 否则很难 和其它 client 做 inter-client 的通讯.
例 2
程式
signature
DELETE INSERT_SELECTION INSERT_PROPERTY
Functions of Selection
--------------------------------------------------------------------------------
XSetSelectionOwner(display, selection, owner, time)
Display *display;
Atom selection;
Window owner;
Time time;
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Window XGetSelectionOwner(display, selection)
Display *display;
Atom selection;
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
XConvertSelection(display, selection, target, property,
requestor, time)
Display *display;
Atom selection, target;
Atom property;
Window requestor;
Time time;
--------------------------------------------------------------------------------
Client Message
阅读(1544) | 评论(0) | 转发(1) |
