FvwmGtk(1)FvwmGtk(1)
NAME
FvwmGtk - the Fvwm GTK module
SYNOPSIS
FvwmGtk is spawned by fvwm, so no command line invocation
will work. From within the fvwm's configuration file,
FvwmGtk is spawned as follows:
Module FvwmGtk [ name ]
or from within an fvwm pop-up menu:
DestroyMenu Module-Popup
AddToMenu Module-Popup "Modules" Title
AddToMenu Module-Popup "Gtk" Module FvwmGtk [ name ]
DESCRIPTION
The FvwmGtk module implements GTK-based alternatives to
the GUI elements in fvwm, namely the builtin menus and the
FvwmForm dialogs.
INVOCATION
No command line invocation is possible. FvwmGtk must be
invoked by the fvwm window manager. When invoked with the
optional name argument, name is used to find configuration
commands and configuration files instead of "FvwmGtk".
CONFIGURATION OPTIONS
FvwmGtk only has options to define the content of the
menus and dialogs. This includes the labels and pixmaps
to show; configuration of the appearance must be done
through the GTK rc file mechanism.
FvwmGtk gets config info from fvwm's module configuration
database (see fvwm2(1), section MODULE COMMANDS) when it
starts up. In addition, FvwmGtk accepts commands from
fvwm and its modules as it runs.
If the optional name is used to start FvwmGtk, name is
used in all commands, messages, menus and forms generated
by FvwmGtk and in the configuration file name. Unlike
other fvwm modules, there is little reason to use the
optional name.
All dialogs and menus have to be defined through configu-
ration commands before they can be used. A dialog or menu
is invoked by sending its name to FvwmGtk. For menus, you
also send the button which is to be used.
SendToModule FvwmGtk menu-example 1
SendToModule FvwmGtk dialog-example
MENUS
The following commands define menus. For all arguments
named "label" in the following menu commands, FvwmGtk
looks for embedded ampersands in the same way fvwm does
for its menus.
*FvwmGtk: Menu name
Instructs FvwmGtk to append subsequent items to the
menu named by the argument. Note that you can
"reopen" a menu and continue to append to it. It is
also possible to redefine a menu from scratch, see
"*FvwmGtk: Destroy".
*FvwmGtk: Title label [ icon [ r_label ] ]
Appends a title to the currently open menu. If the
optional argument is given, it should be the name
of an xpm file in the ImagePath. The icon will
appear to the left of the text. If FvwmGtk has been
compiled with imlib support, icon can of any image
format imlib can read. The label can contain an
ampersand to mark the following character as an
accelerator to be underlined. Underlined accelera-
tors work in the same way as they do in fvwm native
menus. If r_label is given, it will be right-justi-
fied.
*FvwmGtk: Item label action [ icon [ r_label ] ]
Appends an item to the currently open menu. The
first argument is the text that will appear in the
item, the second argument will be sent to fvwm when
the item is activated. If the optional argument is
given, it should be the name of an xpm file in the
ImagePath. The icon will appear to the left of the
text. The label can contain an ampersand to mark
the following character as an accelerator to be
underlined. Underlined accelerators work in the
same way as they do in fvwm native menus. If
r_label is given, it will be right-justified.
*FvwmGtk: Submenu label name [ icon ]
Appends an item to the currently open menu. The
first argument is the text that will appear in the
item, the second argument is the name of the sub
menu that will be opened when the item is selected.
If the sub menu doesn't exist yet, it will be cre-
ated. If the optional argument is given, it should
be the name of an xpm file in the ImagePath. The
icon will appear to the left of the text. The label
can contain an ampersand to mark the following
character as an accelerator to be underlined.
Underlined accelerators work in the same way as
they do in fvwm native menus.
*FvwmGtk: Tearoff
Appends a special tear-off item. Activating it
turns the menu into a permanent window; activating
it once more makes the menu disappear again.
WINDOW LISTS
Window lists are special dynamically created menus. They
offer a list of all windows managed by fvwm and send "Win-
dowListFunc window-id" back to fvwm, where window-id is
the ID of the selected window in hexadecimal notation as
expected by fvwm. WindowListFunc is the same function that
is also used by fvwm for its builtin window list.
*FvwmGtk: WindowList name [ option... ]
Creates a window-list bound to name. The window-
list will be formatted according to the given
options. Currently supported are the following
options which have the same meaning as for the
fvwm's builtin window list: "NoGeometry", "NoMini-
Icon", "UseIconName", "Desk ", "CurrentDesk",
"Icons/NoIcons/OnlyIcons", "Sticky/NoSticky/Only-
Sticky", "Normal/NoNormal/OnlyNormal",
"NoDeskSort", "Alphabetic", "Function ". The
following options are new: "Title