dwtdisplayvmsmessage(3dwt) [ultrix man page]
DwtDisplayVmsMessage(3Dwt) DwtDisplayVmsMessage(3Dwt) Name DwtDisplayVmsMessage - Accepts and displays a VMS message. Syntax Widget DwtDisplayVmsMessage(parent_widget, name, default_position, x, y, style, message_vector, widget_id, convert_proc, ok_callback, help_callback) Widget parent_widget; char *name; int default_position; int x, y; int style; int *message_vector; Widget *widget_id; int (*convert_proc)(); DwtCallbackPtr ok_callback; DwtCallbackPtr help_callback; Arguments parent_widget Specifies the parent widget ID. name Specifies the name of the created widget. default_position Specifies a boolean value that, when True, indicates that DwtNx and DwtNy are to be ignored forcing the widget to be centered in the parent window. x Specifies the placement, in pixels, of the left side of the widget window relative to the inner upper left corner of the parent window. y Specifies, in pixels, the placement of the upper left corner of the widget window relative to the inner upper left corner of the parent window. style Specifies the style of the message box widget. You can pass DwtModal (modal) or DwtModeless (modeless). message_vector Specifies the message argument vector identifying the message identifier and associated information. This argument is identical to the VMS $PUTMSG system service. 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 VMS message identifier. Message identifiers are passed by value. If the message is user-supplied, the next word consists of the $FAO parameter count. The final n longwords in the message block are the $FAO parameters. widget_id This argument contains the widget ID of an already-existing message box widget. If this argument is nonzero, a new message box is not created. An XtSetValues will be performed on this widget to change the text of the message to match this new message. This is an input/output argument. That is, the function fills in widget_id after you call it. convert_proc Specifies a pointer to a function that is executed after the message is formatted but before it is displayed. A pointer to the formatted string is passed to the function as a parameter. This parameter is a NULL-terminated character string. ok_callback Specifies the callback function or functions called when the user clicks on the Acknowledged push button. For this callback, the reason is DwtCRYes. help_callback Specifies the callback function or functions called when a help request is made. Description The DwtDisplayVmsMessage function accepts standard VMS message vectors (as defined by the $PUTMSG system service), retrieves the messages, formats them, and creates a message box in which to display the message. This parameter is a NULL-terminated character string. Return Values Upon completion, DwtDisplayVmsMessage returns to the calling program the ID of the created message box widget. See Also Guide to the XUI Toolkit: C Language Binding Guide to the XUI Toolkit Intrinsics: C Language Binding DwtDisplayVmsMessage(3Dwt)
Check Out this Related Man Page
DXmDisplayCSMessage(3X) 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
The identifier (widget ID) for the parent widget of the created widget. The name of the created widget. 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. The placement, in pixels, of the left side of the message box relative to the inner upper-left corner of the parent window. The placement, in pixels, of the upper side of the message box relative to the inner upper-left corner of the parent window. 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 interac- tions in the same application XmDIALOG_MODELESS Modeless type dialog box XmDIALOG_PRIMARY_APPLICATION_MODAL Used when dialogs must be responded to before other interac- tions in ancestors of the widget XmDIALOG_SYSTEM_MODAL Modal type dialog box ----------------------------------------------------------- The default is XmDIALOG_MODELESS. 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 con- tains 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. The identifier (widget ID) of an already existing message box wid- get. 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. 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. A callback descriptor data structure. The callback is executed when the user clicks on the Acknowledged button. The reason is XmCR_OK. 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. DXmDisplayCSMessage(3X)