---
name: "XtGetResourceList"
section: "3x"
platform: "linux"
package: "libxt-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/XtGetResourceList/3x"
---

# XtGetResourceList(3x)

obtain resource list

## NAME

XtGetResourceList, XtGetConstraintResourceList - obtain resource list

## SYNTAX

void XtGetResourceList(WidgetClass *class*, XtResourceList \**resources\_return*, Cardinal \**num\_resources\_return*);

void XtGetConstraintResourceList(WidgetClass *class*, XtResourceList \**resources\_return*, Cardinal \**num\_resources\_return*);

## ARGUMENTS

- *num\_resources\_return*

  Specifies a pointer to where to store the number of entries in the  resource list.

- *resources\_return*

  Specifies a pointer to where to store the returned resource list. The caller must free this storage using *XtFree* when done with it.

- *widget\_class*

  Specifies the widget class.

## DESCRIPTION

If  *XtGetResourceList* is called before the widget class is initialized (that is, before the first widget of that class has been created), *XtGetResourceList* returns the resource list as specified in the widget class record. If it is called after the widget class has been initialized, *XtGetResourceList* returns a merged resource list that contains the resources  for all superclasses. The list returned by *XtGetResourceList* should be freed using *XtFree* when it is no longer needed.

If  *XtGetConstraintResourceList* is called before the widget class is initialized (that is, before the first widget of that class has been created), *XtGetConstraintResourceList* returns the resource list as specified in the widget class Constraint part record. If it is called after the widget class has been initialized, *XtGetConstraintResourceList* returns a merged resource list that contains the Constraint resources  for all superclasses. If the specified class is not a subclass of *constraintWidgetClass*, *\*resources\_return* is set to NULL and *\*num\_resources\_return* is set to zero. The list returned by *XtGetConstraintResourceList* should be freed using *XtFree* when it is no longer needed.

## SEE ALSO

XtGetSubresources(3Xt), XtOffset(3Xt)\
 *X Toolkit Intrinsics - C Language Interface*\
 *Xlib - C Language X Interface*