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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmtDisplayErrorMsg(),   XmtDisplayWarningMsg(),	XmtDisplayInformation-
       Msg() - 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_de-
		      fault, 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 substitutions.

	    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  XmtDisplayInforma-
       tionMsg() perform a printf()-style variable substitution	into the spec-
       ified 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
       ``error'',  ``warning''	or  ``information'' icons. It is automatically
       created,	cached,	popped up, and popped down by Xmt.  For	 XmtDisplayEr-
       rorMsg()	 and XmtDisplayWarningMsg(), the dialog	is modal, and for Xmt-
       DisplayInformationMsg(),	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
       information 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)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO

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

home | help