


DXmDisplayCSMessage(3X)				      DXmDisplayCSMessage(3X)



NAME
  DDXXmmDDiissppllaayyCCSSMMeessssaaggee -	Displays a compound string message.

SYNOPSIS

  WWiiddggeett DDXXmmDDiissppllaayyCCSSMMeessssaaggee((_p_a_r_e_n_t__w_i_d_g_e_t,, _n_a_m_e,,
			     _d_e_f_a_u_l_t__p_o_s_i_t_i_o_n,, _x,, _y,,
			     _s_t_y_l_e,, _m_e_s_s_a_g_e__v_e_c_t_o_r,,
			     _w_i_d_g_e_t,, _c_o_n_v_e_r_t__p_r_o_c,,
			     _o_k__c_a_l_l_b_a_c_k,, _h_e_l_p__c_a_l_l_b_a_c_k))
	  WWiiddggeett	  _p_a_r_e_n_t__w_i_d_g_e_t;;
	  cchhaarr		  **_n_a_m_e;;
	  BBoooolleeaann	  _d_e_f_a_u_l_t__p_o_s_i_t_i_o_n;;
	  PPoossiittiioonn	  _x;;
	  PPoossiittiioonn	  _y;;
	  uunnssiiggnneedd cchhaarr	  _s_t_y_l_e;;
	  iinntt		  **_m_e_s_s_a_g_e__v_e_c_t_o_r;;
	  WWiiddggeett	  **_w_i_d_g_e_t;;
	  iinntt		  **_c_o_n_v_e_r_t__p_r_o_c;;
	  XXttCCaallllbbaacckkLLiisstt  _o_k__c_a_l_l_b_a_c_k;;
	  XXttCCaallllbbaacckkLLiisstt  _h_e_l_p__c_a_l_l_b_a_c_k;;

PARAMETERS

  _p_a_r_e_n_t__w_i_d_g_e_t
      The identifier (widget ID) for the parent	widget of the created widget.

  _n_a_m_e
      The name of the created widget.

  _d_e_f_a_u_l_t__p_o_s_i_t_i_o_n
      When True, the _x and _y positions of the widget window are	ignored	in
      favor of the default, which centers the message box in the window	of
      the parent widget.

  _x   The placement, in	pixels,	of the left side of the	message	box relative
      to the inner upper-left corner of	the parent window.

  _y   The placement, in	pixels,	of the upper side of the message box relative
      to the inner upper-left corner of	the parent window.

  _s_t_y_l_e
      The style	of the dialog box widget used for the message box.  The
      predefined values	for this resource are as follows:


      ____________________________________________________

      Value				   Description

      ____________________________________________________










      XXmmDDIIAALLOOGG__FFUULLLL__AAPPPPLLIICCAATTIIOONN__MMOODDAALL

					   Used	for dia-
					   logs	that must
					   be responded	to
					   before other
					   interactions	in
					   the same appli-
					   cation



      XXmmDDIIAALLOOGG__MMOODDEELLEESSSS

					   Modeless type
					   dialog box



      XXmmDDIIAALLOOGG__PPRRIIMMAARRYY__AAPPPPLLIICCAATTIIOONN__MMOODDAALL

					   Used	when dia-
					   logs	must be
					   responded to
					   before other
					   interactions	in
					   ancestors of
					   the widget



      XXmmDDIIAALLOOGG__SSYYSSTTEEMM__MMOODDAALL

					   Modal type dia-
					   log box

      ____________________________________________________

      The default is XXmmDDIIAALLOOGG__MMOODDEELLEESSSS.

  _m_e_s_s_a_g_e__v_e_c_t_o_r
      The message argument vector specifying the compound strings and associ-
      ated information.

      The first	longword contains the number of	longwords in the message
      blocks to	follow.	 The first longword in each message block contains a
      pointer to the compound string.  The next	word consists of the format-
      ted ASCII	output (FAO) parameter count.  The remaining longwords in the
      message block are	the FAO	parameters.

      In addition to the standard FAO system service flags, the	compound
      string message routine will accept the new FAO directive "!CS".  When
      used, this directive will	insert a compound string itself.

  _w_i_d_g_e_t
      The identifier (widget ID) of an already existing	message	box widget.
      The Intrinsic routine XXttSSeettVVaalluueess	is called on this widget to change
      the text of the message to match the new message.	(Note, however,	that
      this call	to XXttSSeettVVaalluueess	does not set _d_e_f_a_u_l_t__p_o_s_i_t_i_o_n, _x, _y, or	_s_t_y_l_e
      for the existing message box widget.)  If	this parameter is 0, a new
      message box widget is created.

  _c_o_n_v_e_r_t__p_r_o_c
      A	pointer	to a routine that is executed after the	message	is formatted
      but before it is displayed.  A pointer to	the formatted string is
      passed to	the routine as a parameter.

      The parameter is a null-terminated character string.

  _o_k__c_a_l_l_b_a_c_k
      A	callback descriptor data structure.  The callback is executed when
      the user clicks on the Acknowledged button.  The reason is XXmmCCRR__OOKK.

  _h_e_l_p__c_a_l_l_b_a_c_k
      A	callback descriptor data structure.  The callback is executed when
      the user requests	help.  The reason returned is XXmmCCRR__HHEELLPP.




DESCRIPTION

  The DDXXmmDDiissppllaayyCCSSMMeessssaaggee routine accepts an array of compound strings,	for-
  mats them, and, if necessary,	creates	a message box. A return	of 0 (Null)
  indicates that the message box could not be created.

RETURN VALUES

  The identifier (widget ID) of	the message box	widget.

























































