FreeBSD Manual Pages
XmtInitia...ationShell(3) Library Functions Manual XmtInitia...ationShell(3) NAME XmtInitializeApplicationShell() - set initial application resource val- ues. SYNOPSIS #include <Xmt/AppRes.h> void XmtInitializeApplicationShell(Widget w, ArgList args, Cardinal num_args) ARGUMENTS INPUTS w The root shell widget to be registered and have its application resources read, or any descendant of that widget. args An array of resource name/value pairs to override application resource values specified in the resource database or on the command line. num_args The number of elements in the args array. DESCRIPTION XmtInitializeApplicationShell() obtains values for the application resources used by the Xmt library from the resource database and over- rides them with any values specified in the args array. These values are stored in a private structure associated with the shell widget for later use by the library. This function also initializes some private values that the Xmt library maintains for each root shell in an appli- cation. See Chapter 7, Application Resources and Command-Line Argu- ments, for a complete list of the Xmt application resources. XmtInitializeApplicationShell() does not make copies of any string resources passed to it. This means that any strings passed in the args array must be constants or must be in memory that will not be modified or freed. You need only call XmtInitializeApplicationShell() if you want to explicitly hardcode some application resource values with the args array. If you do not call this function your self, the Xmt library will call it the first time it needs to look up an application resource. XmtInitializeApplicationShell() has another purpose-it registers the name of the specified application shell for use by XmtNameToWidget() and the Xmt String-to-Widget converter. This is important only in applications that have more than one root shell widget, and want to be able to refer to widgets by name between the separate widget hierar- chies. SEE ALSO Chapter 7, Application Resources and Command-Line Arguments, XmtGetApplicationValues(), XmtInitialize(), XmtNameToWidget(), XmtParseCommandLine(), XmtSetApplicationValues(). Xmt Motif Tools XmtInitia...ationShell(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtInitializeApplicationShell&sektion=3&manpath=FreeBSD+Ports+15.0>