xmreptypegetnamelist(3x) [osf1 man page]

XmRepTypeGetNameList(3X)												  XmRepTypeGetNameList(3X)

NAME

       XmRepTypeGetNameList - A representation type manager function that generates a list of values for a representation type

SYNOPSIS

       #include <Xm/RepType.h>

       String * XmRepTypeGetNameList (rep_type_id, use_uppercase_format)
	       XmRepTypeId rep_type_id;
	       Boolean use_uppercase_format;

DESCRIPTION

       XmRepTypeGetNameList generates a null-terminated list of the value names associated with the specified representation type. Each value name
       is a null-terminated string.  This routine allocates memory for the returned data.  The application must free  this  memory  using  XtFree.
       Specifies  the  identification number of the representation type.  Specifies a Boolean value that controls the format of the name list.	If
       True, each value name is in uppercase characters prefixed by "Xm"; if False, the names are in lowercase characters.

RETURN VALUE

       Returns a pointer to an array of the value names.

SEE ALSO

       XmRepTypeGetId(3X), XmRepTypeGetRegistered(3X), XmRepTypeRegister(3X)

															  XmRepTypeGetNameList(3X)

XmRepTypeGetRegistered(library call)									      XmRepTypeGetRegistered(library call)

NAME

       XmRepTypeGetRegistered -- A representation type manager function that returns a copy of the registration list

SYNOPSIS

       #include <Xm/RepType.h>
       XmRepTypeList XmRepTypeGetRegistered(void)

DESCRIPTION

       XmRepTypeGetRegistered  retrieves  information about all representation types that are registered with the representation type manager. The
       registration list is an array of structures, each of which contains information for a representation type entry. The end of  the  registra-
       tion  list  is  marked with a representation type entry whose rep_type_name field has a NULL pointer. This routine allocates memory for the
       returned data. The application must free this memory using XtFree.

       The representation type entry structure contains the following information:

       typedef struct
       {
	       String  rep_type_name;
	       String  *value_names;
	       unsigned char   *values;
	       unsigned char   num_values;
	       Boolean reverse_installed;
	       XmRepTypeId     rep_type_id;
       } XmRepTypeEntryRec, *XmRepTypeList;
       (void)

       rep_type_name
		 The name of the representation type

       value_names
		 An array of representation type value names

       values	 An array of representation type numerical values

       num_values
		 The number of values associated with the representation type

       reverse_installed
		 A flag that indicates whether or not the reverse converter is installed

       rep_type_id
		 The identification number of the representation type

RETURN

       Returns a pointer to the registration list of representation types.

RELATED

       XmRepTypeRegister(3) and XmRepTypeGetRecord(3).

													      XmRepTypeGetRegistered(library call)