XtAppSetFallbackResources() XtAppSetFallbackResources()
Name
XtAppSetFallbackResources - specify a default set of resource values.
Synopsis
void XtAppSetFallbackResources(app_context, specification_list)
XtAppContext app_context;
String *specification_list;
Inputs
app_context
Specifies the application context in which the fallback resources will be used.
specification_list
Specifies a NULL-terminated array of resource specifications to pre-load the database, or NULL.
Availability
Release 4 and later.
Description
XtAppSetFallbackResources() registers specification_list as a default set of resource values that will be used in app_context to initialize
the resource database if the application-specific class resource file (i.e., the app-defaults file) cannot be found.
specification_list is an array of strings, each string a single resource specification in resource file format. If XtDisplayInitialize()
is not able to find or read an application-specific class resource file then the resource database for the display will be initialized with
the values most recently registered with XtAppSetFallbackResources().
XtAppSetFallbackResources() is not required to copy specification_list; the caller must ensure that the contents of the list and of the
strings addressed by the list remain valid until all displays are initialized, or until XtAppSetFallbackResources() is called again. Pass-
ing NULL for specification_list removes any previous fallback resource specification for the application context.
Usage
XtAppInitialize() provides an argument for specifying the fallback resources, so few applications need to call XtAppSetFallbackResources()
directly. Note that XtAppSetFallbackResources() should be called before XtOpenDisplay() or XtDisplayInitialize() if they are to take
effect for that display.
The intended use of fallback resources is to provide a minimal number of resources that make the application usable (or at least terminate
with helpful diagnostic messages) when some problem exists in finding and loading the application-defaults file.
See Also
XtAppInitialize(1), XtDisplayInitialize(1), XtOpenDisplay(1).
Xt - Resource Management XtAppSetFallbackResources()