VtMessageDialog(VTCL)


VtMessageDialog -- create message dialog, return widget name

Synopsis

VtMessageDialog widgetName [options]

Description

Creates a dialog box which contains a message and the default pushbuttons OK, Cancel and Help. Returns the widget name of the dialog. All the standard Dialog options are also supported. To override the default buttons, the options -ok, -cancel, and -help can be used to specify which buttons go in the dialog. If any one of these options is used then it is assumed that only buttons which have been individually specified or referenced via either a label or a callback option will be put in the dialog.

If the user chooses either the OK or Cancel button, the dialog is automatically popped down and destroyed. The -autoHide and -autoDestroy options can be used to override this default behavior.

For example:

set msg [VtMessageDialog $but.msg -message "Hi there!" -ok]
VtShow $msg

Options


-message string (CSG)
Sets the text of the message. Use ``\n'' to separate lines.

Return values

If VtMessageDialog fails, it returns one of the following error messages:

NO_BUTTON
named widget button does not exist

Standard errors
See ``Tcl widget creation errors'' in Developing Visual Tcl applications.

02 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 02 June 2005