GeListHead Manual


A GeListHead object is the root of a list or tree of GeListNode elements. See also GeListNode Manual.

GeListHead objects are an instance of ID_LISTHEAD.


GeListHead objects can be created with the usual tools:

The creation of GeListHead objects is typically only needed in custom NodeData based plugin classes that internally store custom objects (see also Heads and Branches).


It is possible to get the root GeListHead from every member of that list or tree:

// This example loops through all selected objects and tags.
// For each selected element the GeListHead is accessed to
// get the first child object of that list.
// loop through all elements of the selection
for (Int32 i = 0; i < selection->GetCount(); ++i)
C4DAtom* const atom = selection->GetIndex(i);
if (atom == nullptr)
return maxon::UnexpectedError(MAXON_SOURCE_LOCATION);
// check if the C4DAtom is a GeListNode
if (atom->IsInstanceOf(Tgelistnode) == false)
GeListNode* const node = static_cast<GeListNode*>(atom);
GeListHead* const head = node->GetListHead();
// check if the list head can be accessed
if (head != nullptr)
GeListNode* const child = head->GetFirst();
// check if the child is a BaseList2D object
if (child && child->IsInstanceOf(Tbaselist2d))
const BaseList2D* const child2D = static_cast<BaseList2D*>(child);
ApplicationOutput("First Child Element: " + child2D->GetName());
Py_ssize_t i
Definition: abstract.h:645
Definition: c4d_baselist.h:2190
String GetName() const
Definition: c4d_baselist.h:2363
Definition: c4d_baselist.h:1377
Bool IsInstanceOf(Int32 id) const
Definition: c4d_baselist.h:1418
Definition: c4d_baselist.h:2026
GeListNode * GetFirst()
Definition: c4d_baselist.h:2082
Represents a C4DAtom that resides in a 4D list.
Definition: c4d_baselist.h:1813
maxon::Int32 Int32
Definition: ge_sys_math.h:60
#define atom
Definition: graminit.h:72
Definition: memoryallocationbase.h:67
#define ApplicationOutput(formatString,...)
Definition: debugdiagnostics.h:210
#define Tbaselist2d
2D list.
Definition: ge_prepass.h:980
#define Tgelistnode
Node list.
Definition: ge_prepass.h:984
const char * doc
Definition: pyerrors.h:226
Definition: node.h:10

GeListHead objects can also be obtained using GeListNode::GetBranchInfo():

// This example loops through all branches of a given BaseDocument.
// If possible the name of the first branch child object is printed.
BranchInfo info[20]; // 20 is just an arbitrary number, that should be enough to catch all branches
const Int32 branchCount = doc->GetBranchInfo(info, 20, GETBRANCHINFO::NONE);
for (Int32 i = 0; i < branchCount; ++i)
const String branchName = info[i].name;
ApplicationOutput(" - Name: " + branchName);
GeListHead* const branchHead = info[i].head;
if (branchHead != nullptr)
GeListNode* const child = branchHead->GetFirst();
// check if the child is a BaseList2D object
if (child && child->IsInstanceOf(Tbaselist2d))
BaseList2D* const child2D = static_cast<BaseList2D*>(child);
ApplicationOutput(" - First Child Element: " + child2D->GetName());
Definition: c4d_string.h:39
static String IntToString(Int32 v)
Definition: c4d_string.h:495
_Py_clock_info_t * info
Definition: pytime.h:197
Definition: c4d_baselist.h:1198

See also GeListNode Heads and Branches and BaseList2D::GetMain() at BaseList2D Read-Only Properties.


GeListHead itself is based on GeListNode. So instances of GeListHead can be organized in a list or tree:

See Edit Lists and Trees.


The parent of a GeListHead instance is typically the object that owns that instance/branch.

GeListHead::SetParent() is normally used directly after the creation of a GeListHead instance.

// This example allocates a new GeListHead in a custom object's "Init" function.
// The "node" argument of "Init" is used as the parent object.
_branchHead = GeListHead::Alloc();
if (_branchHead == nullptr)
return false;
_branchName = ::String { "My Branch" };
static GeListHead * Alloc()

List Content

A GeListHead is a root of a list of GeListNode elements. These elements can be obtained with:

New elements can be added to the list with:

All elements of a list can easily be deleted with:

// This example removes all existing markers using the list head.
BaseList2D* const marker = GetFirstMarker(doc);
if (marker != nullptr)
GeListHead* const head = marker->GetListHead();
if (head == nullptr)
return maxon::UnexpectedError(MAXON_SOURCE_LOCATION);
void FlushAll()
Clears the list, removing all nodes.
Definition: c4d_baselist.h:2093
GeListHead * GetListHead()
Definition: c4d_baselist.h:1910
BaseList2D * GetFirstMarker(BaseDocument *doc)

Further Reading