Name

XtAppSetFallbackResources — specify a default set of resource values. 

Synopsis

void XtAppSetFallbackResources(app_context, specification_list)

      XtAppContext app_context;
      String ∗specification_list;

Arguments

app_contextSpecifies the application context in which the fallback specifications will be used. 

specification_list
Specifies a NULL-terminated list of resource specifications to pre-load the database, or NULL. 

Description

XtAppSetFallbackResources specifies a default set of resource values that will be used to initialize the resource database if no application-specific class resource file is found (the app-defaults file). 

Each entry in specification_list points to a string in the format of XrmPutLineResource.  In the future, if XtDisplayInitialize is not able to find or read an application-specific class resource file according to the rules given above, and if specification_list is non-NULL, then the display-specific resource database will be initialized with the resource specifications in specification_list. 

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. 

The value NULL for specification_list removes any previous fallback resource specification for the application context.  The intended use 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. 

XtAppInitialize provides an argument for specifying the fallback resources, so few applications need to call XtAppSetFallbackResources directly. 

See Also

XtAppInitialize(1), XtDisplayInitialize(1), XtOpenDisplay(1).