MASH-TK(1)MASH-TK(1)NAMEmash-tk - control visual elements of mash window
SYNOPSIS
load tk
tk clear
tk def button name value
tk def ibutton name value image
tk def menu name
tk def item menu name value
tk dialog title mesg default label ...
tk dump [ name ... ]
tk env
tk file title dir pattern ...
tk geom
tk layout [ name ... ]
tk notice message
tk sel
tk sget
tk sput string
tk string mesg
tk taskbar string
tk text
DESCRIPTION
Tk is a loadable builtin for mash. It provides a set of primitives for
customizing a mash window and building fairly sophisticated graphical
functions. It is currently implemented as a single command with a vari‐
ety of subcommands. For the tk command to work, mash must have been
started using wm/wmmash. In the following descriptions, references to
return values indicate strings put on a command's standard output.
Creating a Menu Bar
The def subcommand is used to define graphical pushbuttons and menus.
The def button and def ibutton commands are used to define pushbuttons
labelled with text or graphical icons, respectively. The name parame‐
ter is used to label buttons, and to layout both buttons and ibuttons.
Value is a command to be executed when the button is clicked, and must
be quoted if it contains white space. Image is the name of a bitmap
file; it is looked for in /icon/tk, unless the name begins with which
suppresses prepending /icon/tk.
Def menu is used to name and label menu buttons, and def item specifies
items within the corresponding pulldown menus. In def item, menu is a
name supplied on a def menu subcommand, name is the label for this menu
item, and value is a command to execute when this menu item is
selected. All the items in a menu are simple command buttons; there is
no provision for any other kind of control, or for cascading menus.
The layout subcommand creates and makes visible a menu bar, using menus
and buttons defined with def subcommands. The current components, if
any, are removed first, so layout with no parameters just removes all
the current buttons and menus from the mash window. The components are
laid out from left to right, in the order presented in the layout sub‐
command. A copy of the current mash environment is made, and commands
executed as a result of clicking buttons or selecting menu items are
executed in that environment. For example, variables will have the
values they had when the layout was done.
The env subcommand can be used to make a new copy of the environment
for use by button or menu actions.
Displaying Popup Widgets
The notice subcommand pops up a window containing message and a single
button to dismiss the window. The icon displayed in the window is
/icons/tk/error. No value is returned by notice.
The dialog subcommand is more complex; title is used to name the win‐
dow, and multiple buttons labelled according to the label parameter(s)
are provided. Default is the number of the button which is the default
choice. The leftmost button is numbered 0. When the user selects one
of the buttons, the dialog box is popped down and the number of the
button selected is returned.
The file subcommand pops up a standard Inferno file selection box. Dir
specifies the initial directory to display, and pattern specifies which
non-directory files to include in the list of files. If the Cancel but‐
ton in the file dialog is clicked, no value is returned. If a file is
selected and the Exit button is clicked, the full pathname of the file
is returned, complete with final / if the file is a directory. Double
clicking on a non-directory file in the list will likewise return that
file's path. Double clicking on a directory in the list will display
the contents of that directory.
The string subcommand pops up a small window with mesg as the label of
a text field. Characters typed into the text field, up to but not
including ENTER, are returned.
Dealing With the Selection
The sel subcommand returns whatever is currently selected. When typing
into the shell's window, nothing is selected, so nothing is returned.
However, if invoked via a pushbutton and there is a selection, it is
returned.
The sput subcommand puts string into the snarf buffer maintained by the
window manager, and the sget subcommand retrieves and returns the cur‐
rent contents of the snarf buffer. This provides a way to pass text
between the shell and other applications. The Snarf and Paste buttons
on the popup menu associated with mouse button two can also be used to
do this.
Miscellaneous Tk Subcommands
The taskbar subcommand lets you put string in the title bar of the mash
window. The old value is returned.
The text subcommand returns the contents of the mash window.
The clear subcommand removes all text from the window.
The dump subcommand returns the mash-tk commands needed to define the
buttons and menus currently defined, and to recreate the currently vis‐
ible set of buttons and menus, or, if dump has parameters, the commands
needed to define the buttons and menus named by the parameters.
The geom subcommand returns the position of the upper left corner of
the mash window relative to the upper left corner of the Inferno
screen.
SOURCE
/appl/cmd/mash/tk.b
SEE ALSOmash(1)MASH-TK(1)
