noble (3) XtAppSetFallbackResources.3.gz

NAME

       XtAppSetFallbackResources - set fallback resources

SYNTAX

       #include <X11/Intrinsic.h>

       void XtAppSetFallbackResources(XtAppContext app_context, String* specification_list);

ARGUMENTS

       app_context
                 Specifies the application context.

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

DESCRIPTION

       Each entry in specification_list points to a string in the format XrmPutLineResource.  following a call
       to XtAppSetFallbackResources, when a resource database is being created for a particular screen and the
       Intrinsics are not able to find or read an application-specific class resource file and if
       specification_list is not NULL the resource specification in specification_list will be merged into the
       screen resource database in place of the application-specific class resource file.
       XtAppSetFallbackResources is not required to copy specification_list; the caller must ensure that the
       contents of the list and 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 for
       fallback resources is to provide a minimal number of resources that will 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

       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface