XDIALOG(1)

HP-UX

NAME

xdialog - display a message in an X11 Motif dialog window

SYNOPSIS

xdialog [ options ]

DESCRIPTION

The xdialog program reads a message from either the command line or from a file and displays the message in an X11 Motif dialog window. By default a single pushbutton labeled OK appears below the window. A message must be provided via either the command line (via the -m option) or from a file (via the -f option). Command line options allow the user to specify a bitmap to be displayed left of the message, add a Cancel button, change the labels for the OK and Cancel buttons, and associate a command to run if/when the user selects the OK button. The xdialog program can be used to query for Yes/No style responses; xdialog exits with a value of “0” when the OK button is selected, and a value of “1” with the Cancel button.

OPTIONS

Several options can be used to change the behavior of xdialog:

-display display
Specifies the server to connect to; see X(1).

-fg color
Specify the foreground (text) color.

-bg color
Specify the background color.

-m message_string
Specify the message string to appear in the window. The string should be enclosed by quotes if it contains white space or newline characters. The -m and -f options are mutually-exclusive.

-f pathname
Specify the file to read The file pathname contains the text of the message to display. The -m and -f options are mutually-exclusive.

-O label_string
Specify a different label for the OK button.

-C label_string
Specify a different label for the Cancel button. This button also enables the Cancel button if is is not already enabled.

-p bitmap_file
Cause the bitmap specified in the file bitmap_file to appear to the left of the message area.

-e command_string
Associates the command specified by command_string with the OK button. If the user presses the OK button, then xdialog does a fork/exec of command_string. This option automatically turns on the Cancel button.

-t title_string
Use the specified string as the title of the window.

-c Cause the Cancel button to be the default button. This option causes the Cancel button to appear.

-o Cause the OK button to be the default button. This is the default behavior. This option causes the Cancel button to appear.

ENVIRONMENT

DISPLAY
The default host and display number.