FreeBSD Manual Pages
XmtInitial...cationShell(3) Library Functions Manual XmtInitial...cationShell(3) NAME XmtInitializeApplicationShell() - set initial application resource values. 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 re- sources read, or any descendant of that widget. args An array of resource name/value pairs to override application re- source 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 re- sources used by the Xmt library from the resource database and overrides 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 application. See Chapter 7, Application Resources and Command-Line Arguments, for a complete list of the Xmt application resources. XmtInitializeApplicationShell() does not make copies of any string re- sources 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 explic- itly 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 wid- gets by name between the separate widget hierarchies. SEE ALSO Chapter 7, Application Resources and Command-Line Arguments, XmtGetApplicationValues(), XmtInitialize(), XmtNameToWidget(), XmtParseCommandLine(), XmtSetApplicationValues(). Xmt Motif Tools XmtInitial...cationShell(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.1.quarterly>