Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for xmgetsecondaryresourcedata (redhat section 3)

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 XtGetResourceList and XtGetConstraintResourceList.
       In order to retrieve the descriptions of these resources, an application must  use  XmGet-
       SecondaryResourceData.

       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 (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 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 (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\n", 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)


All times are GMT -4. The time now is 09:52 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password