XCONFIRM(1) UNIX System V XCONFIRM(1)
NAME
xconfirm - general purpose dialog box
SYNOPSIS
xconfirm [ -c ] [ -b button-name ] [ -B default-button-
name ] [ -t string ] [ -file filename ]
[ -icon icontype ] [ -font font ] [ -header titlebar-
string ] [ -geometry geometry-string ] [ -useslider ]
[ -noframe ] [ -exclusive ]
DESCRIPTION
xconfirm displays a line of text for each -t argument
specified (or a file when the -file argument is used), and a
button for each -b argument specified. When one of the
buttons is pressed, the label of that button is written to
xconfirm's standard output. The enter key activates the
specified default button. This provides a means of
communication/feedback from within shell scripts and a means
to display useful information to a user from an application.
Command line options are available to specify geometry, font
style, frame style, modality and one of five different icons
to be presented for tailored visual feedback to the user.
-c Center the window on the display. Ignored if position
is specified via -geometry.
-b button-name
Displays a button with the label button-name. If
button-name is the empty string, the button in that
position is not displayed. If no -b arguments are
present, the default is a button with the label
Continue.
-B button-name
Displays a button with the label button-name and
specifies it as the button to be activated when enter
is pressed.
-t message
Displays message. Up to 10 strings can be listed on
the command line (each must be preceded with the -t
option).
-file filename
Displays the file filename. All -t options will be
ignored.
-icon icontype
Displays the icon icontype where icontype is one of:
info, error, question, progress, warning, critical.
See the Motif Style Guide for guidance in selecting an
appropriate icon type. action is also accepted as a
synonym for error for backware compatibility.
-font fontname
Use fontname as the font.
-header string
Use string as the window title.
-geometry geometry-string
This provides xconfirm with an X-compatible geometry
string specification.
-useslider
When displaying a file, use a slider instead of
clipping to the window size.
-noframe
Do not display a frame around the contents.
-exclusive
Grab the keyboard/pointer and do not allow further
input until a button is pressed.
EXAMPLE
The following shell script will display a window with an
information icon, asking the user a yes or no question with
"Yes" as the default.
#! /bin/sh
case `xconfirm -t "Really power down the system?" -b No -B Yes -icon info`
in
Yes) shutdown;;
No) ;;
esac
CAVEATS
Xconfirm will resize the window vertically -t arguments are
used. Xconfirm will also attempt to resize horizontally
(for files this is based on the longest of the first 20
lines of the file, so long lines may be truncated unless a
-geometry argument is given), so if users specify a large
number of buttons, they may not all appear unless a
-geometry argument is given.
Page 2 (printed 7/20/06)