Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
XmtDisplayErrorMsg(3)	    Library Functions Manual	   XmtDisplayErrorMsg(3)

NAME
     XmtDisplayErrorMsg(),  XmtDisplayWarningMsg(), XmtDisplayInformationMsg() -
     display a formatted message in a dialog box.

SYNOPSIS
     #include <Xmt/Dialogs.h>

     void XmtDisplayErrorMsg(Widget w, String msg_name, String msg_default,
		    String title_default, String help_default, ...)

     void XmtDisplayWarningMsg(Widget w, String msg_name, String msg_default,
		    String title_default, String help_default, ...)

     void XmtDisplayInformationMsg(Widget w, String msg_name, String msg_de-
		    fault, String title_default, String help_default, ...)

ARGUMENTS
     INPUTS

	  w	 Any widget; the message dialog will be popped up over the shell
		 of this widget.

	  msg_name
		 The name of this message, or NULL; used to  look  up  resources
		 for the message.

	  msg_default
		 The  text of the message, unless overridden by a value from the
		 resource database. The message may contain printf()-style  sub-
		 stitutions.

	  title_default
		 The string to appear in the title bar of the dialog box, unless
		 overridden by a value from the resource database.

	  help_default
		 Help text for the dialog, unless overridden by a value from the
		 resource database.

	  ...	 A  printf()-style variable-length argument list of values to be
		 substituted into the message.

DESCRIPTION
     XmtDisplayErrorMsg(),  XmtDisplayWarningMsg(),  and  XmtDisplayInformation-
     Msg()  perform  a	printf()-style	variable substitution into the specified
     msg_default (or into an overriding message from the resource database)  and
     display  the  resulting string in a simple dialog box over the shell widget
     that contains the specified widget w.

     The dialog is an XmMessageBox dialog displaying the  standard  Motif  ``er-
     ror'',  ``warning''  or ``information'' icons. It is automatically created,
     cached, popped up, and popped down by  Xmt.  For  XmtDisplayErrorMsg()  and
     XmtDisplayWarningMsg(), the dialog is modal, and for XmtDisplayInformation-
     Msg(), it is modeless.

     The  title  bar of the dialog box (if the window manager displays one) will
     contain the title_default string, or an overriding value from the	resource
     database. If help_default is non-NULL, or if there is help specified in the
     resource  database, then the dialog will display a Help button. If the user
     clicks on this button, the help string will be  appended  to  the	original
     message in the dialog.

     See  XmtDisplayMessage() and Chapter 25, Message Dialogs, for more informa-
     tion on customizing message dialogs with resources.

SEE ALSO
     Chapter 25, Message Dialogs,
     XmtDisplayError(), XmtDisplayErrorAndAsk(), XmtDisplayErrorMsgAndWait(),
     XmtDisplayInformation(), XmtDisplayMessage(), XmtDisplayMessageAndWait(),
     XmtDisplayMessageVaList(), XmtDisplayWarning(),
     XmtDisplayWarningMsgAndWait().

Xmt				   Motif Tools		   XmtDisplayErrorMsg(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtDisplayErrorMsg&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help