Index for Section 3X

Alphabetical listing for D

Bottom of page

DXmDisplayCSMessage(3X)
NAME
  DXmDisplayCSMessage - Displays a compound string message.

SYNOPSIS
  Widget DXmDisplayCSMessage(
	  Widget parent_widget,
	  char *name,
	  Boolean default_position,
	  Position x,
	  Position y,
	  unsigned char style,
	  int *message_vector,
	  Widget *widget,
	  int *convert_proc,
	  XtCallbackList ok_callback,
	  XtCallbackList help_callback );

PARAMETERS
  parent_widget
      The identifier (widget ID) for the parent widget of the created widget.

  name
      The name of the created widget.

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

  style
      The style of the dialog box widget used for the message box.  The
      predefined values for this resource are as follows:

      _________________________________________________________
      Value				   Description
      _________________________________________________________
      XmDIALOG_FULL_APPLICATION_MODAL

					   Used for dialogs
					   that must be
					   responded to before
					   other interactions
					   in the same
					   application

      XmDIALOG_MODELESS

					   Modeless type dialog
					   box

      XmDIALOG_PRIMARY_APPLICATION_MODAL

					   Used when dialogs
					   must be responded to
					   before other
					   interactions in
					   ancestors of the
					   widget
      XmDIALOG_SYSTEM_MODAL

					   Modal type dialog
					   box
      _________________________________________________________

      The default is XmDIALOG_MODELESS.

  message_vector
      The message argument vector specifying the compound strings and
      associated 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
      formatted 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.

  widget
      The identifier (widget ID) of an already existing message box widget.
      The Intrinsic routine XtSetValues is called on this widget to change
      the text of the message to match the new message.	 (Note, however, that
      this call to XtSetValues does not set default_position, x, y, or style
      for the existing message box widget.)  If this parameter is 0, a new
      message box widget is created.

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

  ok_callback
      A callback descriptor data structure.  The callback is executed when
      the user clicks on the Acknowledged button.  The reason is XmCR_OK.

  help_callback
      A callback descriptor data structure.  The callback is executed when
      the user requests help.  The reason returned is XmCR_HELP.

DESCRIPTION
  The DXmDisplayCSMessage routine accepts an array of compound strings,
  formats 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.

Index for Section 3X

Alphabetical listing for D

Top of page