|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtDialogGetDefaultValues(3) | FreeBSD Library Functions Manual | XmtDialogGetDefaultValues(3) |
NAME
XmtDialogGetDefaultValues() - read default data values for a dialog from the resource database.SYNOPSIS
void XmtDialogGetDefaultValues(Widget dialog, XtPointer address, ArgList args, Cardinal num_args)
ARGUMENTS
INPUTS- dialog
- The dialog that is to have its default data values looked up. This is a widget returned by a previous call to XmtBuildDialog() or XmtBuildQueryDialog().
- args
- An optional array of resource name/value pairs which will be used to hardcode some of the default values for the dialog.
- num_args
- The number of elements in args.
OUTPUTS
- address
- The address of a data structure in which the dialogs default values will be stored.
DESCRIPTION
XmtDialogGetDefaultValues() has dialog and address arguments just as XmtDialogGetDialogValues() and XmtDialogSetDialogValues() do. Instead of transferring data from or to the widgets of a dialog box, however, this function looks up default values for each of the dialog data items and stores them in a structure. If you call this function before popping up your dialogs, you'll give the user or the system administrator to customize the dialog defaults to their personal or site preferences.XmtDialogGetDefaultValues() looks up the resource list that was associated with dialog when it was created by XmtBuildDialog() or XmtBuildQueryDialog(). It uses this resource list in a call to XtGetSubresources() to obtain default values from the args argument list and the resource database and store them in the structure at address.
If a resource name appears in the args array, then its corresponding value is used as the default. If a hardcoded default does not appear here, then the resource is looked up in the resource database as a subpart of w. The name of the subpart is ``xmtDefaults''. (For a resource named ``orientation'' of a dialog box named ``*print'', the default would be looked up as ``*print.xmtDefaults.orientation''. If a default value is not found in args or in the resource database, then the default comes from the resource list itself-from the default_type and default_addr fields of the XtResource structure.
SEE ALSO
Chapter 29, Custom Dialogs and Automatic Dialog Management, XmtBuildDialog(), XmtBuildQueryDialog(), XmtDialogCancelCallback(), XmtDialogDo(), XmtDialogDoSync(), XmtDialogGetDataAddress(), XmtDialogGetDialogValues(), XmtDialogOkayCallback(), XmtDialogSetDialogValues(), XmtDialogSetReturnValue().| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.