DtSessionRestorePath(library call) DtSessionRestorePath(library call)
NAME
DtSessionRestorePath -- get a pathname for the application's state information file
SYNOPSIS
#include <Dt/Session.h>
Boolean DtSessionRestorePath(
Widget widget,
char **restorePath,
char *restoreFile);
DESCRIPTION
The DtSessionRestorePath function returns a pathname to an application's state information.
The widget argument is the application's top level widget. The restorePath argument is the address of the character string to receive the
pathname of the application's state information file. The restoreFile argument is the filename of the file containing the application
state information. This is the filename specified with the -session option at application invocation.
RETURN VALUE
Upon successful completion, the DtSessionRestorePath function returns True; otherwise, it returns False.
APPLICATION USAGE
The application must support the -session command-line option.
The application must use XtFree(3) to free data returned in *restorePath.
SEE ALSO
Dt/Session.h - DtSession(5), DtSessionSavePath(3); XtFree(3).
DtSessionRestorePath(library call)
Check Out this Related Man Page
XmGetSecondaryResourceData(library call) XmGetSecondaryResourceData(library call)
NAME
XmGetSecondaryResourceData -- A function that provides access to secondary widget resource data
SYNOPSIS
#include <Xm/Xm.h>
Cardinal XmGetSecondaryResourceData(
WidgetClass widget_class,
XmSecondaryResourceData **secondary_data_return);
DESCRIPTION
Some Motif widget classes (such as Gadget, Text, and VendorShell) have resources that are not accessible through the functions XtGetRe-
sourceList and XtGetConstraintResourceList. In order to retrieve the descriptions of these resources, an application must use XmGetSec-
ondaryResourceData.
When a widget class has such resources, this function provides descriptions of the resources in one or more data structures. XmGetSec-
ondaryResourceData takes a widget class argument and returns the number of these data structures associated with the widget class. If the
return value is greater than 0 (zero), the function allocates and fills an array of pointers to the corresponding data structures. It
returns this array at the address that is the value of the secondary_data_return argument.
The type XmSecondaryResourceData is a pointer to a structure with two members that are useful to an application: resources, of type XtRe-
sourceList, and num_resources, of type Cardinal. The resources member is a list of the widget resources that are not accessible using Xt
functions. The num_resources member is the length of the resources list.
If the return value is greater than 0 (zero), XmGetSecondaryResourceData allocates memory that the application must free. Use XtFree to
free the resource list in each structure (the value of the resources member), the structures themselves, and the array of pointers to the
structures (the array whose address is secondary_data_return).
widget_class
Specifies the widget class for which secondary resource data is to be retrieved.
secondary_data_return
Specifies a pointer to an array of XmSecondaryResourceData pointers to be returned by this function. If the widget class has no
secondary resource data, for example, if the value returned by the function is 0 (zero), the function returns no meaningful value
for this argument.
RETURN
Returns the number of secondary resource data structures associated with this widget class.
EXAMPLE
The following example uses XmGetSecondaryResourceData to print the names of the secondary resources of the Motif Text widget and then frees
the data allocated by the function:
XmSecondaryResourceData * block_array;
Cardinal num_blocks, i, j;
if (num_blocks = XmGetSecondaryResourceData (xmTextWidgetClass,
&block_array)) {
for (i = 0; i < num_blocks; i++) {
for (j = 0; j < block_array[i]->num_resources; j++) {
printf("%s
", block_array[i]->resources[j].resource_name);
}
XtFree((char*)block_array[i]->resources);
XtFree((char*)block_array[i]);
}
XtFree((char*)block_array);
}
XmGetSecondaryResourceData(library call)