AwesomeWM中的client

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

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

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

window

X window ID

name

client title

skip_taskbar

是否在任务栏上显示

type

窗口类型，可能是 desktop, docker, splash, dialog, menu, toolbar, utility, dropdown_menu, popup_menu, notification, combo, dnd, normal. 详情可以参见这里

class

client的第一个class属性，可以通过 xprop 命令获取

instance

client的instance属性，可以通过 xprop 命令获取

pid

client的PID

role

The window role, if available(没太明白什么意思).

machine

运行client所在的机器

icon_name

当缩小成图标时的client name

icon

client所使用的图标路径

icon_sizes

一个数组，包含了icon可用的所有尺寸大小

screen

client所在的screen

hidden

该client是否隐藏

minimized

该client是否最小化。最小化的client只在任务栏上可见

size_hints_honor

Honor size hints

border_width

client边框宽度

border_color

client边框颜色

urgent

client的urgent标志，true/false

content

A 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_for

The client the window is transient for.(没看懂)

group_window

window所属组ID

leader_window

当一个命令产生多个client时，这些client共享同一个leader_window

size_hints

client的推荐大小(A table with size hints of the client. )

sticky

设置client是否sticky，一个sticky的client在所有tags下都可见

modal

Indicate if the client is modal.

focusable

该client是否能获取到焦点

shape_bounding

The client's bounding shape as set by awesome as a (native) cairo surface.

shape_clip

The client's clip shape as set by awesome as a (native) cairo surface.

client.shape_input

The client's input shape as set by awesome as a (native) cairo surface.

shape_client_bounding

The client's bounding shape as set by the program as a (native) cairo surface.

shape_client_clip

The client's clip shape as set by the program as a (native) cairo surface.

startup_id

The 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的尺寸

dockable

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