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

FreeBSD Manual Pages

  
 
  

home | help 
XmtDialog...aultValues(3)  Library Functions Manual  XmtDialog...aultValues(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,	Ar-
		      gList 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 Xmt-
		   BuildDialog() or XmtBuildQueryDialog().

	    args   An optional array of	resource name/value pairs  which  will
		   be used to hardcode some of the default values for the dia-
		   log.

	    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 pop-
       ping 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 associ-
       ated  with  dialog when it was created by XmtBuildDialog() or XmtBuild-
       QueryDialog(). It uses this resource list  in  a	 call  to  XtGetSubre-
       sources()  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 sub-
       part 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().

Xmt				  Motif	Tools	     XmtDialog...aultValues(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.0>

home | help