就业培训     下载中心     Wiki     联络 登录   注册

---

// check if a BaseList2D element is linked and if it is a BaseObject if (linkedEntity != nullptr && linkedEntity-> IsInstanceOf ( Obase )) { const BaseObject * const linkedObject = static_cast< BaseObject * > (linkedEntity); ApplicationOutput ( "Linked Object: " + linkedObject-> GetName ()); }

Allocation/Deallocation

BaseLink objects can be created with the usual functions:

• BaseLink::Alloc() : Creates a new BaseLink 对象。
• BaseLink::Free() : Destroys the given BaseLink 对象。

拷贝

BaseLink objects can be cloned or copied:

• BaseLink::GetClone() : Returns a copy of the BaseLink 对象。
• BaseLink::CopyTo() : Copies the BaseLink object into the given object.

特性

A BaseLink object stores a reference to an entity. This reference can be handled with these function:

• BaseLink::GetLink() : Evaluates the link and returns a pointer to the linked entity.
• BaseLink::GetLinkAtom() : Evaluates the link and returns a pointer to the linked C4DAtomGoal .
• BaseLink::SetLink() : Sets the link to point to the given C4DAtomGoal .
• BaseLink::IsCacheLink() : Returns true if the referenced object is inside the cache of another object.

The stored reference is typically resolved using the BaseDocument that contains the referenced entity. If the linked entity is not part of a BaseDocument the BaseLink can be forced to be resolved:

• BaseLink::ForceGetLink() : Returns the stored link independent of a document.
• BaseLink::ForceGetLinkAtom() : Returns the stored C4DAtomGoal independent of a document.

// insert "cube" into the document tempDoc-> InsertObject (cube, nullptr , nullptr ); AutoAlloc<BaseLink> link; if (link == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// store link link-> SetLink (cube); BaseObject * const resultA = static_cast< BaseObject * > (link-> GetLink (tempDoc)); if (resultA != nullptr ) ApplicationOutput ( "Could access the linked object." );

// removes the cube from the document cube-> 移除 (); BaseObject * const resultB = static_cast< BaseObject * > (link-> GetLink (tempDoc)); if (resultB == nullptr ) ApplicationOutput ( "Could not access the linked object." ); BaseObject * const resultC = static_cast< BaseObject * > (link-> ForceGetLink ()); if (resultC != nullptr ) ApplicationOutput ( "Could access the linked object." );

Disc I/O

BaseLink objects can be stored in a HyperFile using:

• BaseLink::Read() : Reads the BaseLink from the given HyperFile .
• BaseLink::Write() : Writes the BaseLink into the given HyperFile .

注意

This is typically used in NodeData::Read() and NodeData::Write() .

BaseLinkArray

A BaseLinkArray can be used to handle multiple BaseLink 对象。

Add And Remove

References to entities can easily be added to and removed from the array using:

• BaseLinkArray::Append() : Appends the given C4DAtomGoal to the array.
• BaseLinkArray::Remove() : Removes the link at the given index from the array.

Access

References to entities and other relevant data can easily be retrieved from the array using:

• BaseLinkArray::GetRealCount() : Returns the number of valid base links in the array.
• BaseLinkArray::Find() : Returns the index of the link to the given C4DAtomGoal .
• BaseLinkArray::GetIndexLink() : Returns the link stored at the given index.
• BaseLinkArray::GetIndex() ：返回 C4DAtomGoal referenced in the link stored at the given index.
• BaseLinkArray::GetIndexBl() ：返回 BaseList2D referenced in the link stored at the given index.

// check if the referenced element is a BaseObject if (goal-> IsInstanceOf ( Obase )) { const BaseObject * const obj = static_cast< BaseObject * > (goal); ApplicationOutput (obj-> GetName ()); } }

转换

The BaseLinkArray can be converted into and built from an AtomArray .

• BaseLinkArray::GetAtomArray() : Sets the atom array with entities referenced in the stored links.
• BaseLinkArray::FromAtomArray() : Constructs the array from the given AtomArray .

延伸阅读

• GeData Manual
• BaseContainer Manual