FvwmIconMan
名称（NAME）：
FvwmIconMan -Fvwm 图标管理器（icon manager）
概要（SYNOPSIS）：
FvwmIconMan 只能被fvwm调用(fork),不能从命令行启动。
描述（DESCRIPTION）：
FvwmIconMan 模仿 TWM 的图标管理器。用户可以有多个图标管理器，每个负责管理一类窗口。例如，用户可以有一个管理器只负责管理emacs窗口，同时可以有另外一个管理器负责管理所有其它窗口。你也可以分别指定每个图标管理器使用的策略，例如，可以指定一个管理所有桌面上的窗口，而另一个仅仅管理当前桌面（desk）、页（page）、屏幕（screen）上的窗口。FvwmIconMan 能够显示fvwm提供的窗口微型图标。图标管理器可以有多个列（垂直增长），也可以有多个行（水平增长），或者固定尺寸大小并调整窗口图标的尺寸来适应它。
你能指定鼠标、键盘事件关联的操作，例如，你可以首先绑定鼠标按键反图标化所选择的窗口，然后抛开鼠标，直接绑定箭头键来浏览这个管理器。
FvwmIconMan 能够显示当前哪个窗口拥有键盘焦点，通过绑定select 事件到fvwm的Focus函数，你能模拟TWM 的图标管理器。
初始化（INITIALIZATION）：
在初始化期间，FvwmIconMan 搜索fvwm配置文件来发现用户配置的选项。建议将FvwmIconMan 设置为一个 sticky 窗口。如果你想利用 followfocus 选项，或者绑定一个操作到Focus，你应该使用 FvwmIconMan clicktofocus。使用Shape选项时，建议不要修饰 FvwmIconMan 窗口。
调用（INVOCATION）：
可以在.fvwmrc文件里添加‘Module FvwmIconMan’命令来启动 FvwmIconMan。如果希望在初始化期间启动 FvwmIconMan，应该将这个命令添加到 StartFunction 函数里，否则可以将它绑定到菜单，鼠标，或键盘操作以便后来启动 FvwmIconMan。
如果你希望以 transient 模式使用 FvwmIconMan，比如内置在一个窗口列表里，则应该传递Transient参数，‘Module FvwmIconMan Transient’。使用这个模式时，FvwmIconMan 将在鼠标光标的位置弹出一个管理器窗口，鼠标按键释放后，它执行一定的操作然后退出。
FvwmIconMan 也可以接受一个别名作为参数，例如“Module FvwmIconMan FvwmIconMan-Variant2”。
配置选项索引（CONFIGURATION OPTIONS REFERENCE CHART）：
FvwmIconMan 有非常多的选项，这里给出它们的索引，之后的部分将有更详尽的描述。
Name Description Default
NumManagers number of managers 1
Action binds command to event Mouse 0 N sendcommand Iconify
Background default background gray
ButtonGeometry size of button in pixels
Colorset default colorset
DontShow list of windows to ignore
DrawIcons use mini icons false
FocusAndSelectButton flat grey black
FocusAndSelectColorset
FocusButton style for focused buttons up grey black
FocusColorset
FollowFocus show which win has focus false
Font 8x13
Foreground default text color white
Format describes button label "%c: %i"
IconName manger icon name FvwmIconMan
IconButton style for icon buttons up black grey
IconColorset
ManagerGeometry size of manager in buttons 0x1
MaxButtonWidth max width of a button
MaxButtonWidthByColumns
NoIconAction animate iconification NOP
PlainButton style for normal buttons up black grey
PlainColorset
ReliefThickness size of button relief 2
Resolution global/desk/page/screen page
Reverse normal, icon or none none
SelectButton style for selected buttons flat black grey
SelectColorset
Shape use shape extension false
Show list of windows to show
ShowOnlyIcons only icons visible false
ShowNoIcons icons are not displayer false
ShowTransient transient windows visible false
Sort keep managers sorted name
SortWeight weight for sorting
Tips Tool Tips mode none
TipsDelays Tool Tips mapping delays 1000 300
TipsFont Font for Tool Tips default fvwm font
TipsColorset Tool Tips Colorset 0
TipsFormat describes Tips label the Format value
TipsBorderWidth Tool Tips border size 1
TipsPlacement Tips placement vs button updown
TipsJustification Tips Just vs button leftup
TipsOffsets Tips placement Offsets 3 2
Title manager title FvwmIconMan
TitleButton style for title button raisededge black grey
TitleColorset
UseWinList honor WinListSkip? true
配置选项（CONFIGURATION OPTIONS）：
除nummanagers选项外，其它的选项都可以针对某一个管理器定义。例如，你可以有一个红色背景的emacs 管理器，同时也可以有一个蓝色背景的xterm 管理器。因此，一个配置语句可能有两种形式：
*FvwmIconMan: OptionName OptionValue
选项OptionName的值OptionValue适用于每个管理器。
*FvwmIconMan: ManagerId OptionName OptionValue
选项OptionName的值OptionValue只适用于ID为 ManagerId 的管理器。MangerId 可以是一个正整数，也可以是字符串“transient”。正整数ID是指正常运行时 FvwmIconMan 创建的管理器，“transient”是指FvwmIconMan 临时运行时创建的管理器。
下面是可供使用的各个选项：
*FvwmIconMan: NumManagers num
num表示图标管理器的总数。FvwmIconMan 希望在处理一个特定选项的之前知道一共有多少管理器，它应该首先被设置，默认为1。
*FvwmIconMan: [id] Action type binding
绑定一个 FvwmIconMan 命令到一个事件。Type 的值可以是：Key, Mouse, 或 Select。Action在下面的 ACTIONS 部分详细描述。
*FvwmIconMan: [id] Background background
指定默认的背景色。
*FvwmIconMan: [id] ButtonGeometry geometry
以像素为单位指定单个按钮的初始尺寸。如果height为0，则按钮的高取决于字体的大小。X和Y坐标被忽略。
*FvwmIconMan: [id] Colorset colorset
默认的colorset。覆盖background和foreground的设置。参看FvwmTheme。
*FvwmIconMan: [id] DrawIcons value
如果你的fvwm版本能够使用mini icons，这个选项可以决定是否显示mini icons。否则，它将产生一个错误消息。“true”表示mini icons当窗口图标化时显示，“false”表示mini icons从不显示，“always”表示mini icons总是显示。
*FvwmIconMan: [id] PlainButton style [forecolor backcolor]
指定普通按钮如何显示。style可以是：flat，up，down，raisededge，或sunkedge。两个颜色选项是可选的，如果没有被设置，则使用默认的颜色。在单色屏幕（monochrome screen）上，style选项将被忽略，但仍然必须被设置。
*FvwmIconMan: [id] PlainColorset colorset
类似PlainButton，但指定的是colorset。style设置对 PlainButton 仍然有效。参看FvwmTheme。
*FvwmIconMan: [id] FocusAndSelectButton style [forecolor backcolor]
类似plainbutton选项，指定被选中并有键盘焦点时按钮如何显示。
*FvwmIconMan: [id] FocusAndSelectColorset colorset
作用类似focusandselectbutton，但指定的是colorsets。style设置对focusandselectbutton仍然有效。参看FvwmTheme。
*FvwmIconMan: [id] FocusButton style [forecolor backcolor]
类似plainbutton，指定拥有键盘焦点时按钮如何显示。参看FvwmTheme。
*FvwmIconMan: [id] FocusColorset colorset
类似FocusButton，但指定的是colorsets。style设置对FocusButton仍然有效。参看FvwmTheme。
*FvwmIconMan: [id] IconButton style [forecolor backcolor]
类似plainbutton，指定图标化时按钮如何显示。
*FvwmIconMan: [id] IconColorset colorset
类似IconButton，但指定的是colorsets。style设置对IconButton仍然有效。参看FvwmTheme。
*FvwmIconMan: [id] SelectButton style [forecolor backcolor]
类似plainbutton，指定鼠标光标位于按钮上方时按钮如何显示。
*FvwmIconMan: [id] SelectColorset colorset
类似SelectButton，但指定的是colorset。style设置对slectbutton仍然有效。参看FvwmTheme。
上面五组选项，如果colorset被设置，则forecolor backcolor将不起作用，但是style仍然有效。因此，如果colorset设置的时候，forecolor backcolor就可以不再设置。
*FvwmIconMan: [id] FollowFocus boolean
如果boolean为true，按钮的外观反映出当前哪个窗口拥有焦点。默认false。
*FvwmIconMan: [id] Font font
指定按钮标签的字体。默认是8x13
*FvwmIconMan: [id] Foreground foreground
指定默认的前景色。
*FvwmIconMan: [id] Format formatstring
一个 printf 格式的字符串，描述管理器内按钮标签内容的显示格式。可能的flag有：%t,%i,%c,和%r，分别表示窗口的title、icon、class和resource name。默认是"%c:%i"。
*FvwmIconMan: [id] IconName iconstring
指定管理器窗口的图标名称。Iconstring可以是单个单词或被加上引号的字符串。默认是“FvwmIconMan”。
*FvwmIconMan: [id] ManagerGeometry geometry
指定管理器的初始位置和尺寸，以按钮为单位。如果height为0，则这个管理器将有width列，一旦它拥有多于width个窗口，它将垂直伸长。同样，如果width为0，则它有height行，并水平伸长。如果两个都为非0值，则该管理器窗口将有确定的大小。如果指定负的y坐标，这个管理器将向上伸长。否则，向下伸长。
*FvwmIconMan: [id] MaxButtonWidth width
以像素为单位定义按钮的最大宽度。默认没有最大值。为0表示恢复默认设置（没有最大值）。最大值仅适用于固定大小的管理器（width和height都被指定为非0值）。
*FvwmIconMan: [id] MaxButtonWidthByColumns col
设置按钮宽度的另外一种方式。col是图标的列数。按钮宽度取决于FvwmIconMan的宽度除以列数。例如，如果FvwmIconMan 管理器窗口的宽度为1024，MaxButtonWidthByColumns值为4，则MaxButtonWidth为256。当你不知道管理器窗口宽度的时候，它将非常有用。
*FvwmIconMan: [id] NoIconAction action
指定一个 NoIcon 风格的窗口图标化和反图标化时 FvwmIconMan 执行的action。一个action的例子：“*FvwwmIconMan: NoIconAction SendToModule FvwmAnimate animate”。
*FvwmIconMan: [id] ReliefThickness num
指定non-flat按钮（up，down，raisededge，或sunkedge）边缘的形状（凹凸效果，正数时凹下，负数时凸起）。如果num为0，所有FocusAndSelectButton, FocusButton, IconButton, PlainButton, SelectButton, 和TitleButton将重置为flat按钮。如果num为负，按钮将凸起，好像针对所有按钮类型都设置了Reverse一样。
*FvwmIconMan: [id] Resolution resolution
指定管理器在什么时候显示哪些窗口，resolution可以采用下面的值：global，desk，page，screen，!global，!desk，!page，或!screen。global表示所有窗口都被显示。desk表示仅仅那些当前desk上的窗口被显示。page表示仅仅那些当前page上的窗口被显示。screen表示仅仅当前Xinerama屏上的窗口被显示。!desk与desk相反，表示仅仅显示不在当前desk上的窗口。同样，!page仅仅显示那些不在当前page上的窗口，!screen仅仅显示那些不在当前Xinerama屏上的窗口。默认为page。如果Xinerama没有激活，或者仅有一个屏幕被使用，则page和screen产生同样的效果。
FvwmIconMan 运行时resolution可以被动态的改变。
*FvwmIconMan: [id] Reverse class
使某类按钮的relef配置，up和down风格颠倒。对flat按钮无效。class可以是icon，normal，none。默认为none。
*FvwmIconMan: [id] Shape boolean
如果为True，窗口被shaped。或许仅当你有多行或多列时有用。如果FvwmIconMan 编译时不支持Shape 扩展，这将引发一个错误。当使用 shaped 窗口时，建议去掉 FvwmIconMan 窗口的边框。否则，fvwm将混淆。
*FvwmIconMan: [id] Sort value
name表示管理器内图标按名字排列。namewithcase表示按名字排列，但大小写敏感。id表示按窗口id排列，窗口id在窗口创建后从不改变。weighted表示按weight排列（参看sortweight的描述）。为none，不按一定的顺序排列。默认为name。
*FvwmIconMan: [id] SortWeight weight pattern-list
分配指定的weight给匹配pattern-list的窗口。这个列表由type=pattern形式的字段组成，type可以是class，resource，title，或icon；pattern和 style 命令的格式相同。可以指定多个sort weights，每个窗口按照顺序去匹配，并被设置成第一个匹配到的weight。低weight值的窗口被放置在管理器列表的开始。例如：
*FvwmIconMan: Sort weighted
*FvwmIconMan: SortWeight 1 class=XTerm title=special*
*FvwmIconMan: SortWeight 10 class=XTerm
*FvwmIconMan: SortWeight 5
上面的例子里，标题以“special”开始的xterm窗口（weight 1）被放在列表的开始，后面是其它的非xterm窗口（weight 5），而标题不以“special”开始的xterm窗口位于列表的最后。默认的weight为0（仅当sort类型为weight时有效）。
*FvwmIconMan: [id] Title title-string
指定管理器窗口的标题字符串。titlestring可以是单个单词，或者加上引号的字符串。默认是“FvwmIconMan”。它将显示在管理器窗口的标题栏（title bar）上。
*FvwmIconMan: [id] TitleButton style [forecolor backcolor]
类似plainbutton，指定标题按钮（title button）（管理器为空时显示这个按钮）如何显示。管理器的标题显示在标题按钮里面。
*FvwmIconMan: [id] UseWinList boolean
true 表示如果某类应用使用了 WindowListSkip 属性，那么管理器不收集它们。否则，所有的窗口依据show和dontshow列表接受管理。
