XmGetSecondaryResourceData(3X)



X11 SDE 5.4R3.00                              XmGetSecondaryResourceData(3X)


NAME
       XmGetSecondaryResourceData--A function that provides access to
       secondary widget resource data

SYNOPSIS
       #include <Xm/Xm.h>

       Cardinal XmGetSecondaryResourceData (widget_class,
       secondary_data_return)      WidgetClass         widget_class;
            XmSecondaryResourceData**secondary_data_return;

DESCRIPTION
       Some Motif widget classes (such as Gadget, Text, and VendorShell)
       have resources that are not accessible via the functions
       XtGetResourceList and XtGetConstraintResourceList.  In order to
       retrieve the descriptions of these resources, an application must use
       XmGetSecondaryResourceData.

       When a widget class has such resources, this function provides
       descriptions of the resources in one or more data structures.
       XmGetSecondaryResourceData 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, 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
       XtResourceList, 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, 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 (i.e., if the value
               returned by the function is 0), the function returns no
               meaningful value for this argument.






Licensed material--property of copyright holder(s)                         1



X11 SDE 5.4R3.00                              XmGetSecondaryResourceData(3X)


RETURN VALUE
       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\n", block_array[i]->resources[j].resource_name);
           }
           XtFree((char*)block_array[i]->resources);
           XtFree((char*)block_array[i]);
         }
         XtFree((char*)block_array); }






































Licensed material--property of copyright holder(s)                         2

Museum