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)

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.0>

home | help