FvwmGtk
名称(NAME):
FvwmGtk -Fvwm GTK 模块。
概要(SYNOPSIS):
FvwmGtk 只能被fvwm调用(fork)。可以在配置文件里使用下面的语句调用 FvwmGtk:
Module FvwmGtk [ name ]
也可以从一个fvwm弹出菜单里调用 FvwmGtk:
DestroyMenu Module-Popup
AddToMenu Module-Popup "Modules" Title
AddToMenu Module-Popup "Gtk" Module FvwmGtk [ name ]
描述(DESCRIPTION):
FvwmGtk 模块在fvwm中实现了基于GTK的GUI元素,即内置菜单和 FvwmForm 对话框。
调用(INVOCATION):
FvwmGtk 只能被fvwm调用(fork),不能从命令行启动。指定参数name时,使用name来查找配置命令和配置文件,而不是使用“FvwmGtk”。
配置选项(CONFIGURATION OPTIONS):
FvwmGtk 仅有定义菜单和对话框内容的选项,包括标签和显示的pixmaps;菜单和对话框外观的配置必须通过GTK 的rc文件实现。
FvwmGtk 从fvwm的模块配置数据库获得配置信息。另外,FvwmGtk 运行时能够接受来自fvwm和其它模块的命令。
如果使用参数name启动FvwmGtk,name在所有的命令,消息,和FvwmGtk 生成的菜单和表格中使用。不像其它的模块,这里很少会使用到name。
所有的对话框和菜单必须在它们可用前通过配置命令进行定义。对话框和菜单可以通过将它们的名字发送给FvwmGtk 进行调用。对于菜单,与之绑定的按钮也需要一起发送。
SendToModule FvwmGtk menu-example 1
SendToModule FvwmGtk dialog-example
菜单(MENUS):
下面的命令用来定义菜单。
*FvwmGtk: Menu name
通知FvwmGtk 将之后的菜单项添加到name指定的菜单上。注意,你可以“reopen”一个菜单,并继续添加项给它。
*FvwmGtk: Title label [ icon [ r_label ] ]
添加一个title到当前的菜单上。如果指定可选的参数,它应该是一个xpm文件的名称。这个图标将出现在菜单项文本的左边。如果FvwmGtk 已经编有imlib支持,任何imlib能够读取的图像格式都可以被使用。这个标签可以包含一个“&”,指示跟随的字符将添加下划线来表示快捷键。
*FvwmGtk: Item label action [ icon [ r_label ] ]
添加一个菜单项到当前打开的菜单上。第一个参数是显示的文本,第二个参数是激活时发送给fvwm的命令。如果指定可选的参数,它应该是一个xpm文件的名称。图标将显示在文本左边。这个标签可以包含一个"&",指示跟随的字符将添加下划线来表示快捷键。
*FvwmGtk: Submenu label name [ icon ]
添加一个菜单项到当前打开的菜单上。第一个参数是显示的文本,第二个参数是子菜单的名称。如果子菜单不存在,它将被创建。如果指定可选的参数,它应该是一个xpm文件的名称。图标将显示在本本左边。这个标签可以包含一个"&",指示跟随的字符将添加下划线来表示快捷键。
*FvwmGtk: Tearoff
添加一个专门的tear-off项。它被激活时,菜单将变成一个窗口,再次激活它菜单将消失。
窗口列表(WINDOW LISTS):
窗口列表是是动态创建的菜单。它提供了fvwm管理的所有窗口的列表。
*FvwmGtk: WindowList name [ option... ]
创建一个名为name的窗口列表。这个列表的格式依据所所给定的选项而不同。下面的选项是当前所支持的,它们与fvwm内置的窗口列表选项有同样的意义:"NoGeometry", "NoMiniIcon", "UseIconName", "Desk ", "CurrentDesk", "Icons/NoIcons/OnlyIcons", "Sticky/NoSticky/OnlySticky", "Normal/NoNormal/OnlyNormal", "NoDeskSort", "Alphabetic", "Function "。下面的选项是新支持的:"Title
对话框(DIALOGS):
对话框由不同的控件(widgets)所组成。可以是容器控件,比如包含一个或多个其它控件,也可以是原子控件。容器控件通过指示子控件列表的开始和结束的一对命令定义。原子控件使用单个命令定义。一些控件从用户请求数据。
定义控件的命令通常有下面的形式:
*FvwmGtk: Widget widget-specific args [ -- general-args ]
*FvwmGtk: Dialog name title [ center ]
启动或重新打开名为name的对话框。title是窗口标题。如果指定参数center,对话框将被放到屏幕中心。否则它将放到鼠标的位置。
*FvwmGtk: Box [ vertical ] [ homogeneous ] [ spacing [ border ] ]
*FvwmGtk: EndBox
开始和结束一个容器控件的定义。参数将影响子控件的位置。
*FvwmGtk: Frame label [ border ]
*FvwmGtk: EndFrame
*FvwmGtk: Label label
添加一个标签控件。
*FvwmGtk: Entry name [ initial-value ]
添加一个能够接受用户输入的控件。initial-value表示显示的初始字符串。
*FvwmGtk: Button label cmd ...
添加一个按钮控件,label表示按钮的标签,cmd表示按钮按下时触发的命令。
*FvwmGtk: CheckButton name label on-value off-value [ on ]
*FvwmGtk: RadioGroup name
*FvwmGtk: EndRadioGroup
*FvwmGtk: RadioButton label on-value [ on ]
*FvwmGtk: Notebook label
打开一个标签为label的notebook页。如果已经有一个打开的notebook,则这里打开的页将附加到它上面。否则,创建一个新的notebook。
*FvwmGtk: EndNotebook
关闭notebook控件。
*FvwmGtk: Color name [ initial-value ]
*FvwmGtk: Scale name [ vertical ] value lower
*FvwmGtk: SpinButton name value lower
*FvwmGtk: OptionMenu name
*FvwmGtk: EndOptionMenu
*FvwmGtk: Item label value [ on ]
用来创建Option菜单。
公用配置(COMMON CONFIGURATION):
下面的命令菜单和对话框都可以使用:
*FvwmGtk: Separator
添加一个分隔行到当前打开的菜单上。
*FvwmGtk: Destroy name
销毁指定的菜单和对话框。
*FvwmGtk: RCFile file
注意,这个命令应该在定义任意一个菜单或对话框之前发送。
*FvwmGtk: IconSize [ width height ]
如果FvwmGtk 已经编有imlib支持,图标将会被缩放到参数指定的尺寸。
命令(COMMANDS):
可以使用命令 SendToModule 调用之前定义的菜单或对话框。
SendToModule FvwmGtk name button
将弹出name指定的菜单或对话框。第二个参数表示菜单所关联的按钮。例如:
Mouse 3 R A SendToModule FvwmGtk Window-Ops 3
Key F10 R A SendToModule FvwmGtk Applications-Menu
Mouse 1 R A SendToModule FvwmGtk Quit-Verify-Dialog