Dynamic Settings

NAME

 OlGetApplicationResources

SYNOPSIS

#include <OpenLook.h>
#include <Dynamic.h>
 ...
extern void
OlGetApplicationResources(w, base, resources, num_resources, args, num_args)
Widget       w;
caddr_t      base;
XtResource ∗ resources;
int          num_resources;
ArgList      args;
Cardinal     num_args;

DESCRIPTION

The OlGetApplicationResources procedure is used to retrieve application resources and to effect dynamic refreshing of these resources automatically.  The parameters to this procedure are identical to the Intrinsic routine XtGetApplicationResources which this procedure complements.  When olGetApplicationResources is called, it registers the supplied resource list so that the resource values list can be updated whenever the RESOURCE_MANAGER property changes.  Therefore, the supplied resource list and base address should be static information.  Also, applications normally call this routine only once for the life of the application since additional calls to this routine cause the previously cached resource information to be replaced with the new resource information.

SEE ALSO

OlRegisterDynamicCallback(3), OlUnregisterDynamicCallback(3)
OlCallDynamicCallbacks(3)

NOTE

The architecture of the X Window System assumes that the value of the RESOURCE_MANAGER property will not be refreshed in the Display and, using this assumption, returns pointers into the initial value for resources of type String.  The Dynamic Settings utilities will refresh the value addressed through the Display and therefore potentially free the original space, making any String pointers returned invalid.  To avoid problems caused by this behavior the application should either use the OlGetApplicationResources procedure to maintain valid String pointers or immediately copy the Strings returned following a call to XtGetApplicationResources.

Sun Release 4.1  —  Last change: {:heading=>"OlGetApplicationResources\|(\|3W\|)\0\0\(em\0\0\∗(]D"}  —  Last change: {:heading=>"OlGetApplicationResources\|(\|3W\|)\0\0\(em\0\0\∗(]D"}