VCGetCurrentEntityUID
VCSetCurrentEntityUID


Version:

2.0

Description:

Specifies the current entities UID (unique identifier).

Declaration:

 

C/C++

extern "C" UID WINAPI VCGetCurrentEntityUID(short* iError);
extern "C" void WINAPI VCSetCurrentEntityUID(short* iError, UID uid);

Delphi

function VCGetCurrentEntityUID(var iError: Smallint):Longint; stdcall;
procedure VCSetCurrentEntity3DFlag0(var iError: Smallint; iFlag: Smallint);

ActiveX/COM

Function GetCurrentEntityUID() As Long
Sub SetCurrentEntityUID(ByVal n As Long)

Parameters:

uid - the unique identifier for the current entity

Notes:

Each entity in Visual CADD™ 2.0 maintains a unique entity identifier in order to track the entity. This is in addition to the dynamic entity handle which changes as entities are deleted and modified in the database. As entities are added to the drawing both an entity handle and a UID are assigned to the entity. The entity handle will change as items are deleted and modified on the database while the UID will remain constant. Whenever linking entities to external databases or arrays, the application should utilize the UID due to its unchanging value with each entity. The entity handle is used when parsing the database or setting specific entities within the drawing session. The UID should be audited prior to any external storage in order to ensure uniqueness in the ID.

See Also:

VCGetCurrentEntityHandle, VCAddCurrentEntityUserDataChunk, VCAddCurrentEntityUserDataByte, VCAddCurrentEntityUserDataDouble, VCAddCurrentEntityUserDataFloat, VCAddCurrentEntityUserDataLong, VCAddCurrentEntityUserDataShort, VCGetUserDataName, VCGetCurrentEntityUserDataChunk, VCGetCurrentEntityUserDataCount, VCGetCurrentEntityUserDataDouble, VCGetCurrentEntityUserDataKind, VCGetCurrentEntityUserDataLong, VCGetCurrentEntityUserDataFloat, VCGetCurrentEntityUserDataShort, VCGetCurrentEntityUserDataString, VCGetCurEntUserDataChunkSize, VCSetEntityUserData, VCSetHeaderUserData