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

---

// set group as parent bc. SetData ( DESC_PARENTGROUP , GeData { CUSTOMDATATYPE_DESCID , groupID }); ddesc-> Alloc (bc); }

Access

The DynamicDescription object can be obtained from every C4DAtom :

• C4DAtom::GetDynamicDescription() : Returns the user data parameter description of the entity.

The description of a specific user data parameter can be directly accessed:

• DynamicDescription::Find() : Returns the description of the user data parameter with the given ID.

It is also possible to iterate through all user data parameter descriptions:

• DynamicDescription::BrowseInit() : Returns the handle used to browse the parameter descriptions.
• DynamicDescription::BrowseGetNext() : Retrieves the next parameter description.
• DynamicDescription::BrowseFree() : Frees the given browse handles.

// get user data DynamicDescription * const ddesc = object ->GetDynamicDescription(); if (ddesc == nullptr ) return maxon::UnknownError( MAXON_SOURCE_LOCATION );

// browse user data void * handle = ddesc-> BrowseInit (); if (handle == nullptr ) return maxon::UnknownError( MAXON_SOURCE_LOCATION ); DescID ID; const BaseContainer * bc = nullptr ;

// loop through all user data parameter descriptions while (ddesc-> BrowseGetNext (handle, &ID, &bc)) { // print name if (bc != nullptr ) ApplicationOutput ( "Name: " + bc-> GetString ( DESC_NAME )); } ddesc-> BrowseFree (handle);

Edit User Data

User data parameter descriptions can be added or removed:

• DynamicDescription::Alloc() : Allocates a new user data parameter and returns its ID.
• DynamicDescription::Set() : Inserts a new user data parameter with the given ID.
• DynamicDescription::Remove() : Removes the user data parameter with the given ID.
• DynamicDescription::FillDefaultContainer() : Fills the given BaseContainer with the default settings of the given data type.

// get user data DynamicDescription * const ddesc = object ->GetDynamicDescription(); if (ddesc == nullptr ) return maxon::UnknownError( MAXON_SOURCE_LOCATION );

// configure type as vector BaseContainer bc( DTYPE_VECTOR ); ddesc-> FillDefaultContainer (bc, DTYPE_VECTOR , "Position" );

// create new userdata parameter ddesc-> Alloc (bc);

注意

An empty DescID 作为 DESC_PARENTGROUP of a user data group will create a new tab in the Attribute Manager.

交互

User data parameters can include buttons. When such a button is pressed a message is sent to NodeData::Message() ，见 NodeData::Message() Manual .

// check if the DescID has two levels (expected for user data) if (dc-> _descId . GetDepth () == 2) { // check if it is a user data button if (dc-> _descId [0].id == ID_USERDATA ) { const maxon::String stringID = maxon::String::IntToString(dc-> _descId [1].id); MessageDialog ( "User Data Button clicked: " _s + stringID); } } break ; }

杂项

Further functions of the DynamicDescription class are:

• DynamicDescription::CopyTo() : Copies the dynamic description to the given object.
• DynamicDescription::GetDirty() : Returns a dirty count of the parameter descriptions (not the parameter values).

User Data Editor

The user data manager can be opened with these functions:

• EditDescription() : Shows the edit dialog for a dynamic description.
• AddDescription() : Shows the add dialog for a dynamic description.
• PasteDescription() : Shows the paste dialog for a dynamic description.

延伸阅读

• Description Manual
• Description Settings Manual
• DescID Manual
• C4DAtom Manual
• NodeData::Message() Manual