|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtInitializeApplicationShell(3) | FreeBSD Library Functions Manual | XmtInitializeApplicationShell(3) |
NAME
XmtInitializeApplicationShell() - set initial application resource values.SYNOPSIS
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 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 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 hierarchies.
SEE ALSO
Chapter 7, Application Resources and Command-Line Arguments, XmtGetApplicationValues(), XmtInitialize(), XmtNameToWidget(), XmtParseCommandLine(), XmtSetApplicationValues().| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.