Chinaunix首页 | 论坛 | 博客
  • 博客访问: 2880568
  • 博文数量: 471
  • 博客积分: 10012
  • 博客等级: 上将
  • 技术积分: 5255
  • 用 户 组: 普通用户
  • 注册时间: 2006-04-10 23:58
文章分类

全部博文(471)

文章存档

2011年(3)

2010年(61)

2009年(52)

2008年(212)

2007年(69)

2006年(74)

我的朋友

分类: LINUX

2008-04-17 13:56:17

Fvwm中文手册-FvwmButtons

FvwmButtons

名称(NAME):

FvwmButtons -FVWM buttonbox 模块

概要(SYNOPSIS):

Module FvwmButtons [-g geometry] [-transient | -transientpanel] [name[configfile]]

FvwmButtons 只能被fvwm调用(fork),不能从命令行启动。

描述DESCRIPTION):

FvwmButtons 模块在桌面上提供了一个窗口,这个窗口可以作为按钮的容器,在它里面放置多个按钮,而我们可以使用 FvwmButtons 模块去管理和布局这些按钮。我们可以在任何时候通过去点击这些按钮来触发与之关联的操作,比如启动一个应用程序。FvwmButtons只能在fvwm窗口管理器里使用。

FvwmButtons 提供的按钮容器可以被配置成任意的形状,并可以处于任意位置。它可以容纳具有关联操作的单色或彩色图标,甚至还可以在它里面集成其它的应用或模块。

我们可以通过点击一个按钮去打开面板,参看CREATING PANELS部分。

选项(OPTIONS):

-g,指定主窗口的geometry。这里的命令行选项优先于配置文件里的geometry选项。

-transient,使用transient选项调用 FvwmButtons 模块时,一旦其中按钮关联的操作的被执行,FvwmButtons就会自动关闭。

-transientpanel选项类似于-transient选项,但是并不会关闭整个FvwmButtons,仅仅是将它隐藏起来。这通常使用在一个 FvwmButtons 作为一个另一个 FvwmButtons 的子面板(subpanel)被启动时。

调用(INVOCATION):

FvwmButtons 只能被fvwm调用(fork),不能从命令行启动。

可以通过在配置文件里添加‘Module FvwmButtons OptionalName’语句调用FvwmButtons模块。如果希望FvwmButtons在fvwm初始化期间启动,它需要添加在StartFunction函数里,否则,可以将它与菜单、鼠标、键盘等操作绑定在一起。

如果指定了OptionalName参数,则使用OptionalName查找配置命令,而不是FvwmButtons,例如:

    AddToFunc StartFunction Module FvwmButtons MyButtonBox

之后,FvwmButtons将使用以“*MyButtonBox”字符串开始的配置,而不是默认的"*FvwmButtons"。

配置选项(CONFIGURATION OPTIONS):

下面是目前可用的一些配置选项:

*FvwmButtons: Back color

指定按钮的背景色,relief和阴影的颜色可以通过它计算出来。

*FvwmButtons: BoxSize algorithm

指定遵守Rows和Columns选项的程度。可以是dumb,fixed,smart

如果使用fixed,且Rows和Columns选项被指定为非0值,FvwmButtons使用固定的行数和列数,如按钮容器(box)太小以至于不能容纳所有的按钮,这个模块将不能成功启动。

如果使用smart,FvwmButtons将可以扩大按钮容器来容纳所有的按钮。列的数目将至少增加到最宽的按钮的宽度,并且新的行将被增加直到已经容纳所有的按钮。使用smart选项可以减少配置错误的发生。

dumb即不表示fixed,也不表示smart,这是默认值。

*FvwmButtons: Colorset colorset

指定模块窗口背景使用的颜色集(colorset)。关于colorset的细节可以参考FvwmTheme。

*FvwmButtons: ActiveColorset colorset

指定当鼠标光标移动到按钮上面时,它的背景和标题(title)使用的colorset。

*FvwmButtons: PressColorset colorset

指定当按钮被按下时,它的背景和标题(title)使用的colorset。

*FvwmButtons: Columns columns

指定按钮容器窗口里包含按钮的列数。如果没有指定,则列数被设置成按钮的总数除以行数。如果行数和列数都被指定,但是按钮的总数大于它们所允许的范围,则列数被忽略,除非BoxSize选项的值是fixed

*FvwmButtons: File filename

指定从文件filename查找配置选项。filename可以是绝对路径,或者假定位于fvwm的启动目录下。这个文件和fvwm的配置文件有同样的格式,但是其中的每一行都以字符串“*FvwmButtons”为前缀。

*FvwmButtons: Font font

指定按钮标签使用的字体,默认为None。

*FvwmButtons: Fore color

指定按钮标签的文本和单色图标的使用的颜色。

*FvwmButtons: Frame width

指定按钮周围relief的宽度。如果为负数,则正常情况下按钮的轮廓是凹下去的。

*FvwmButtons: Geometry geometry

指定按钮容器窗口的位置和尺寸。

*FvwmButtons: ButtonGeometry geometry

指定按钮容器串口里单个按钮的位置和尺寸。

*FvwmButtons: Padding width height

指定FvwmButtons窗口里每个按钮周围的空白空间,width表示水平方向的空白为,height表示垂直方向的空白,单位为像素。除了FvwmButtons窗口里集成的其它窗口和容器,正常情况下,按钮的relief和它的内容之间,左右两边的间隙是2个像素,上面和下面的间隙是4个像素。

*FvwmButtons: Pixmap pixmapfile

指定FvwmButtons窗口的背景使用的pixmap。none表示透明背景。

*FvwmButtons: Rows rows

指定按钮行数,默认值为2。

*FvwmButtons: (options) [title icon command]

指定FvwmButtons窗口里单个按钮的内容多个选项之间使用逗号分隔

geometry

指定按钮的大小和在 FvwmButtons 窗口里的大小和位置以普通按钮的宽和高为单位。明确指定位置参数的按钮将首先被放置,如果两个以上的按钮发生重叠,则FvwmButtons将产生一条错误消息,然后退出。

Action [(options)] command

指定按钮被激活时(按下回车键或使用鼠标点击时)执行的fvwm命令。如果command包含逗号或

者括号,则需要加引号。

目前Action的当前选项可以是:Mouse n 表示command仅与鼠标按键n关联。

command字段里,可以使用预定义的变量:$left, $right, $top$bottom表示按钮被按下时按钮的left,right,top,和bottom坐标。$-left, $-right, $-top$-bottom具有同样的含义,不过是从屏幕的底部或右边界开始算起(比如距屏幕右边界5个像素,则$-right值为5)。$width$height表示按钮的宽和高。变量$fg$bg表示BackFore选项指定的背景色和前景色。字母‘$’可以通过‘$$’获得。

例如:

        *FvwmButtons: (Title xload, Action (Mouse 1) \

        `    Exec exec xload -fg $fg -bg $bg -geometry -3000-3000)

注意,在2.5.0之前的fvwm版本,Action选项不能被分配给集成(swallowed)了一个应用窗口的按钮。这样的操作只能通过点击按钮四周的border执行。目前的版本修正了这个问题,为了兼容之前的版本,可以使用ActionIgnoresClientWindow:

        *FvwmButtons: (Action beep, ActionIgnoresClientWindow, \

             Swallow xeyes "Exec exec xeyes")

上面的例子里command仅当你点击这个按钮的borderxeyes窗口的透明部分时执行。

ActionIgnoresClientWindow

参看上面Action部分。

ActionOnPress

通常情况下除了Popup操作,其它关联操作都是当鼠标按钮释放时执行。ActionOnPress可以改变这种行为,使关联操作在按钮按下时执行。

Back color

指定box的背景色。relief和阴影的颜色可以通过它计算出来。

Center

按钮的内容位于按钮中央。默认是这样的,但可以通过LeftRight改变。

Colorset colorset

colorset可以应用于一个容器,一个集成的(swallowed)应用和简单的一个按钮。为了应用于按钮和容器,把这个选项添加到描述按钮和容器的行里即可。使用colorset为单个按钮和容器绘制背景需要和X server进行大量的通信。因此,在显示多个按钮时,如果你不能满意使用colorse的速度,就不要去使用它。应用于集成的应用时没有这个约束,但完全依赖于这个应用本身。

如果集成的窗口是一个fvwm模块,则colorset不能适用于它。我们应该在该模块的配置里使用colorset。如果这个模块的背景使用了透明的colorset,则FvwmButtons 窗口的背景被使用作这个模块的背景。参考FvwmTheme模块。

ActiveColorset colorset

指定当鼠标光标移动到这个按钮上面时,它的背景和标题(title)使用的colorset。

PressColorset colorset

指定当这个按钮被按下时,它的背景和标题(title)使用的colorset。

Container [(options)]

指定这个按钮将包含一个小型的按钮容器(buttonbox),相当于集成了另外一个FvwmButtons模块。Options将影响这个容器里的所有按钮。适用于这个用法的选项有Back, Font, Fore, Frame Padding。Title 和 Swallow 选项的标记可以使用Title(flags) 和 Swallow(flags)设置。同样也可以指定Columns widthRows heightRows 2是默认值。

这个集成的容器按钮可以使用FramePadding选项,也可以关联特定的命令。

典型地,你至少希望给容器设置一个widthxheight的大小。

End

指定不会再向在当前的按钮容器添加更多的按钮,之后的按钮将被添加在这个容器的父容器(parent)里。这个选项应该独占一行,例如:

    *FvwmButtons: (End)

Font fontname

指定这个按钮的标签使用的字体。

Fore color

指定按钮标签的文本和单色图标的使用的颜色。

Frame width

指定按钮周围relief的宽度。如果为负数,则正常情况下按钮的轮廓是凹下去的。

Icon filename

指定按钮的图标。FvwmButtons 将从 ImagePath配置的路径里查找图标文件。

ActiveIcon filename

指定当鼠标光标移动到这个按钮上面时,显示的图标。如果没有明确指定,使用和Icon同样的配置。

PressIcon filename

指定当这个按钮被按下时,显示的图标。如果没有明确指定,使用和Icon同样的配置。

Id id

按钮的id,第一个字符必须为字母。

阅读(1039) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~