AwesomeWM中的client

Awesome WM 使用 client 类来指代 XClient 应用程序的一个窗口。

一个应用程序可能有多个窗口，也就有多个 client 对象与之相对应。 这些 client 对象通常有相同的 class 属性。 我们可以通过 xprop 命令来查询某个 client 的属性。

一个clinet对象中包含了多个属性，这些属性包括:

windowX window ID nameclient title skip_taskbar是否在任务栏上显示 type窗口类型，可能是 desktop, docker, splash, dialog, menu, toolbar, utility, dropdown_menu, popup_menu, notification, combo, dnd, normal. 详情可以参见这里 classclient的第一个class属性，可以通过 xprop 命令获取 instanceclient的instance属性，可以通过 xprop 命令获取 pidclient的PID roleThe window role, if available(没太明白什么意思). machine运行client所在的机器 icon_name当缩小成图标时的client name iconclient所使用的图标路径 icon_sizes一个数组，包含了icon可用的所有尺寸大小 screenclient所在的screen hidden该client是否隐藏 minimized该client是否最小化。最小化的client只在任务栏上可见 size_hints_honorHonor size hints border_widthclient边框宽度 border_colorclient边框颜色 urgentclient的urgent标志，true/false contentA cairo surface for the client window content. 可以用它来进行截屏 gears.surface(c.content):write_to_png(path) opacity透明度，0为完全透明，1为完全不透明 ontop该client是否在所有窗口的最前面 above该client是否设为居前(The client is above normal windows.) below该client是否设为据后(The client is below normal windows. ) fullscreen该client是否全屏显示 maximized该client是否最大化 maximized_horizontal该client是否水平最大化 maximized_vertical该client是否垂直最大化 transient_forThe client the window is transient for.(没看懂) group_windowwindow所属组ID leader_window当一个命令产生多个client时，这些client共享同一个leader_window size_hintsclient的推荐大小(A table with size hints of the client. ) sticky设置client是否sticky，一个sticky的client在所有tags下都可见 modalIndicate if the client is modal. focusable该client是否能获取到焦点 shape_boundingThe client's bounding shape as set by awesome as a (native) cairo surface. shape_clipThe client's clip shape as set by awesome as a (native) cairo surface. client.shape_inputThe client's input shape as set by awesome as a (native) cairo surface. shape_client_boundingThe client's bounding shape as set by the program as a (native) cairo surface. shape_client_clipThe client's clip shape as set by the program as a (native) cairo surface. startup_idThe FreeDesktop StartId. valid该client是否由awesome WM所管理着 first_tag该client所属的第一个tag，相当于 c:tags()[1] marked该client是否被标记 is_fixed该client的大小是否被锁定，该属性为只读的 floating该client是否为浮动的 x / y该client在screen上的偏移量 width / height该client的尺寸 dockableIf the client is dockable. A dockable client is an application confined to the edge of the screen. The space it occupies is substracted from the screen.workarea. shape设置client的形状，请参见gears.shape

需要说明的是，修改client对象的属性可能会对窗口本身产生影响，比如设置

c.maximized=true

会让该client最大化

local c = client.focus
if c then
  -- 处理当前client
end

for _,c in ipairs(client.get()) do
  --do something
end

-- un-minimize all urxvt instances
local urxvt = function (c)
  return awful.rules.match(c, {class = "URxvt"})
end

for c in awful.client.iterate(urxvt) do
  c.minimized = false
end

local c = client.focus
if c then
  x,y,width,height = c:geometry()
  naughty.notify{text=string.format("x=%s,y=%s,w=%s,h=%s",x,y,width,height)}
end

local matcher = function (c)
  return awful.rules.match(c, {class = 'URxvt'})
end
awful.client.run_or_raise('urxvt', matcher)