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

FreeBSD Manual Pages


home | help
XmtDialogGetDefaultValues(3Library Functions ManuaXmtDialogGetDefaultValues(3)

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

       #include	<Xmt/Dialog.h>

       void XmtDialogGetDefaultValues(Widget dialog, XtPointer address,	Ar-
		      gList args, Cardinal num_args)


	    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-

		   The number of elements in args.


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

       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.

       Chapter 29, Custom Dialogs and Automatic	Dialog Management,
       XmtBuildDialog(), XmtBuildQueryDialog(),	XmtDialogCancelCallback(),
       XmtDialogDo(), XmtDialogDoSync(), XmtDialogGetDataAddress(),
       XmtDialogGetDialogValues(), XmtDialogOkayCallback(),
       XmtDialogSetDialogValues(), XmtDialogSetReturnValue().

Xmt				  Motif	Tools	  XmtDialogGetDefaultValues(3)


Want to link to this manual page? Use this URL:

home | help