Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
XmtDialogG...faultValues(3) Library Functions Manual XmtDialogG...faultValues(3)

NAME
     XmtDialogGetDefaultValues()  -  read  default data values for a dialog from
     the resource database.

SYNOPSIS
     #include <Xmt/Dialog.h>

     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 XmtBuildDia-
		 log() 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

	  addressThe  address  of  a data structure in which the dialogs default
		 values will be stored.

DESCRIPTION
     XmtDialogGetDefaultValues() has dialog and address arguments just as XmtDi-
     alogGetDialogValues() and XmtDialogSetDialogValues() do. Instead of  trans-
     ferring 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 XmtBuildQueryDia-
     log(). It uses this resource list in a call to XtGetSubresources()  to  ob-
     tain  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 ``orienta-
     tion'' 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().

Xmt				   Motif Tools	     XmtDialogG...faultValues(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtDialogGetDefaultValues&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help