GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTDISPLAYMESSAGE (3)

NAME

XmtDisplayMessage(), XmtDisplayMessageAndWait(), Xmt DisplayMessageVaList() - display a message in a dialog box.

CONTENTS

SYNOPSIS

   #include <Xmt/Dialogs.h>

   void XmtDisplayMessage(Widget w, String msg_name, String msg_class, String msg_default, String title_default, String help_default, Pixmap icon_default, int modality, int type, ...)

   void XmtDisplayMessageAndWait(Widget w, String msg_name, String msg_class , String msg_default, String title_default, String help_default, Pixmap icon_default, int modality, int type, ...)

   void XmtDisplayMessageVaList(Widget w, String msg_name, String msg_class, String msg_default, String title_default, String help_default, Pixmap icon_default, int modality, int type, va_list args)

ARGUMENTS

INPUTS
w Any widget; the dialog will be displayed over the shell of this widget.
msg_name The name of this message; used to look up resources for the message. You may specify NULL.
msg_class The class of this message; use to look up resources for the message. If you specify NULL the class will be based on the value of the type argument.
msg_default The text of the message to display, unless overridden by a value in the resource database. This message may contain printf()-style substitutions.
title_default The title to appear in the dialog’s title bar, unless overridden by a value in the resource database. If you specify NULL, the default title will depend on the type argument.
help_default The help text to display, when requested by the user, unless overridden by a value in the resource database.
icon_default The pixmap to appear in the message dialog, unless overridden by a value in the resource database. If you specify None, the default icon will depend on the type argument.
modality The modality of the dialog; one of the values XmDIALOG_MODELESS, XmDIALOG_PRIMARY_APPLICATION_MODAL, or XmDIALOG_FULL_APPLICATION_MODAL.
type The type of the dialog; one of the values XmDIALOG_MESSAGE, XmDIALOG_INFORMATION, XmDIALOG_WARNING, and XmDIALOG_ERROR. This argument controls the title and icon to be used for the dialog, if they are not specified in the resource database or by the title_default and icon_default arguments.
... A printf()-style variable-length argument list of values to be substituted into the message.
args For XmtDisplayMessageVaList() only, a printf()-style variable-length argument list converted to a va_list as you would when calling vprintf().

DESCRIPTION

XmtDisplayMessage() displays a message in an automatically created, cached, and managed XmMessageBox dialog. The message to be displayed is formed by performing a printf()-style substitution of the arguments in the variable-length argument list into the specified message template. The specified title will appear in the title bar of the dialog (if the user’s window manager is configured to display a title bar for these dialog widgets), and the specified icon will be displayed in the upper-left corner of the dialog. If any help text is specified then the dialog box will contain a Help button. If the user clicks on this button, the help text will be appended to the displayed message. The modality argument lets you specify whether the dialog should be modal or modeless, and the type argument lets you display dialogs that display the default Motif information, warning, and error icons.

For customizability and internationalizability, XmtDisplayMessage() looks up the message text and other resources for the message dialog in the resource database. Thus, the message_default, title_default, icon_default, and help_default arguments are simply default values that can be overridden with resources. The resources are looked up using the message name and class specified by the msg_name and msg_class arguments. You may specify NULL for these arguments, but it will result in a dialog that is not customizable. See the ‘‘Customization’’ section below for more details.

XmtDisplayMessageAndWait() behaves just like XmtDisplayMessage() but enters an internal event loop after displaying the message so that it appears to ‘‘block’’ until the user has seen and responded to the message by clicking the Ok button.

XmtDisplayMessageVaList() is identical to XmtDisplayMessage() except that it takes its printf() substitution arguments in the form of a va_list instead of an actual variable-length argument list. va_list is the type initialized by va_start() and passed to vprintf(). XmtDisplayMessageVaList() provides a way for you to write your own printf()-style functions that use Xmt message dialogs internally.

Customization

If the msg_name argument is specified for a dialog, then the message text, title, help text and icon of the dialog are looked up in the resource database, and any values found there override values specified by the msg_default, title_default, help_default, and icon_default arguments.

The resources are looked up as subresources of the shell over which the dialog will be displayed. The name and class of the subpart are given by the msg_name and msg_class arguments. The names and classes of the resources that are looked up are the following:

NameTypeClassPurposeDefault
messageStringMessageThe text of the message to display.msg_default
helpTextStringHelpTextThe help text to display.help_default
titleStringTitleThe name to appear in the title bar.title_default
iconPixmapIconThe icon to display.icon_default

WIDGETS

The first time it is called XmtDisplayMessage() (or any of the related functions based on XmtDisplayMessage()) creates an XmMessageBox widget named ‘‘xmtMessageDialog’’ as a child of an XmDialogShell named ‘‘xmtMessageDialogShell’’. The XmDialogShell widget is created as a child of the nearest XmDialogShell, TopLevelShell or ApplicationShell ancestor of the widget w. These message dialog widgets are cached for reuse by subsequent calls to XmtDisplayMessage() (or to any related functions.)

Dialog Types

The type argument to XmtDisplayMessage() serves mainly to provide default values when the msg_class, title_default, or icon_default arguments are omitted. The legal values for type, and the defaults it specifies are shown in the table below:

Default Values

Dialog TypeClassTitleIcon
XmDIALOG_MESSAGEXmtMessageDialogMessagenone
XmDIALOG_INFORMATIONXmtInformationDialogHelpstandard Motif
XmDIALOG_WARNINGXmtWarningDialogWarningstandard Motif
XmDIALOG_ERRORXmtErrorDialogErrorstandard Motif

SEE ALSO

Chapter 25, Message Dialogs,
XmtDisplayError(), XmtDisplayErrorMsg(), XmtDisplayErrorMsgAndWait(), XmtDisplayInformation(), XmtDisplayInformationMsg(), XmtDisplayWarning(), XmtDisplayWarningMsg(), XmtDisplayWarningMsgAndWait().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTDISPLAYMESSAGE (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.