SetNameOfPropertyWEx
Error return codes:
0 successful
1 argument model or rdfProperty is incorrect (not a proper handle to an active property)
2 argument name is incorrect (nullptr or zero length name)
3 the name of rdfProperty is locked
4 name is already used by another class
5 name is already used by a property
6 name is already used by an instance
7 undefined error
This call has the same behavior as SetNameOfPropertyW, however needs to be
used in case properties are exchanged as a successive series of integers.
Syntax
public const string enginedll = @"engine.dll"; [DllImport(enginedll, EntryPoint = "SetNameOfPropertyWEx")] public static extern Int64 SetNameOfPropertyWEx(Int64 model, Int64 rdfProperty, string name); [DllImport(enginedll, EntryPoint = "SetNameOfPropertyWEx")] public static extern Int64 SetNameOfPropertyWEx(Int64 model, Int64 rdfProperty, byte[] name);
Property model
Size: 64 bit / 8 byte (value)Property rdfProperty
Size: 64 bit / 8 byte (value)Property name
Size: 32 bit / 4 byte (reference)
Example (based on pure API calls)
Here you can find code snippits that show how the API call SetNameOfPropertyWEx can be used.
using RDF; // include at least engine.cs within your solution static void Main(string[] args) { Int64 model = RDF.engine.CreateModel(); if (model != 0) { // // The following setting makes sure all properties handled are in an ordered list // In certain cases where several models are open or in case of conversion // between formats this can be handy and / or time efficient. // Int64 propertyCnt = 0; RDF.engine.OrderedHandles(model, (IntPtr) null, out propertyCnt, (IntPtr) null, 2, 2); // // Classes // Int64 classCollection = RDF.engine.GetClassByNameW(model, System.Text.Encoding.Unicode.GetBytes("Collection")), classCube = RDF.engine.GetClassByNameW(model, System.Text.Encoding.Unicode.GetBytes("Cube")); // // Object Properties (relations) // Int64 propertyAbcd = RDF.engine.CreatePropertyW(model, RDF.engine.OBJECTPROPERTY_TYPE, System.Text.Encoding.Unicode.GetBytes("abcd")), propertyObjects = RDF.engine.GetPropertyByNameW(model, System.Text.Encoding.Unicode.GetBytes("objects")); System.Diagnostics.Debug.Assert(propertyAbcd == propertyCnt + 1); System.Diagnostics.Debug.Assert(propertyObjects > 0 && propertyObjects <= propertyCnt); // // Datatype Properties (attributes) // Int64 propertyLength = RDF.engine.GetPropertyByNameW(model, System.Text.Encoding.Unicode.GetBytes("length")), propertyEfgh = RDF.engine.CreatePropertyW(model, RDF.engine.DATATYPEPROPERTY_TYPE_DOUBLE, System.Text.Encoding.Unicode.GetBytes("efgh")); System.Diagnostics.Debug.Assert(propertyLength > 0 && propertyLength <= propertyCnt); System.Diagnostics.Debug.Assert(propertyEfgh == propertyCnt + 2); // // Instances (creating) // Int64 instanceCollection = RDF.engine.CreateInstance(classCollection, (string) null), instanceCube = RDF.engine.CreateInstance(classCube, (string) null); double length = 2.0, efgh = 1.7; RDF.engine.SetDatatypeProperty(instanceCube, propertyLength, ref length, 1); RDF.engine.SetDatatypeProperty(instanceCollection, propertyEfgh, ref efgh, 1); System.Diagnostics.Debug.Assert(RDF.engine.GetVolume(instanceCollection, (IntPtr) 0, (IntPtr) 0) == 0.0); IntPtr propertyNamePtrI = IntPtr.Zero; RDF.engine.GetNameOfPropertyWEx(model, propertyAbcd, out propertyNamePtrI); string propertyNameI = System.Runtime.InteropServices.Marshal.PtrToStringUni(propertyNamePtrI); IntPtr propertyNamePtrII = IntPtr.Zero; RDF.engine.GetNameOfPropertyWEx(model, propertyEfgh, out propertyNamePtrII); string propertyNameII = System.Runtime.InteropServices.Marshal.PtrToStringUni(propertyNamePtrII); RDF.engine.SetNameOfPropertyWEx(model, propertyAbcd, System.Text.Encoding.Unicode.GetBytes("InverseRelationControledByThirdParty")); RDF.engine.SetObjectProperty(instanceCube, propertyAbcd, ref instanceCollection, 1); RDF.engine.SetObjectProperty(instanceCollection, propertyObjects, ref instanceCube, 1); System.Diagnostics.Debug.Assert(RDF.engine.GetVolume(instanceCollection, (IntPtr) 0, (IntPtr) 0) == 8.0); IntPtr propertyNamePtrIII = IntPtr.Zero; RDF.engine.GetNameOfPropertyWEx(model, propertyAbcd, out propertyNamePtrIII); string propertyNameIII = System.Runtime.InteropServices.Marshal.PtrToStringUni(propertyNamePtrIII); // // The retrieved property names have the following values // propertyNameI : 'abcd' // propertyNameII : 'efgh' // propertyNameIII : 'InverseRelationControledByThirdParty' // // // The resulting model can be viewed in 3D-Editor.exe // RDF.engine.SaveModelW(model, System.Text.Encoding.Unicode.GetBytes("c:\\created\\myFile.bin")); RDF.engine.CloseModel(model); } }