Object_Id - cObject

Returns the object handle of the object, can be used to determine if an object exists

Type: Property

Access: Read-Only

Data Type: Handle

Parameters: None

Syntax

 Property Handle Object_Id

Read Access: Get Object_Id to HandleVariable

Description

The Object_Id property returns the object handle identifier of the object.

Normally you will not use this since it essentially returns itself. It returns the object handle of the passed object handle. You can accomplish the same thing by simply using the object's name or handle. For example, these two samples will do the same thing:

// move ID of oMyObjectName to hoID, the easy way
Move oMyObjectName to hoID

// move ID of oMyObjectName to hoID, the hard way
Get Object_Id of oMyObjectName to hoID

This property is really only ever used to determine if an object still exists. If an object has been created and destroyed, you can test if the object still exists by getting the object_id. If the value returned is non-zero, it exists.

Procedure DoTest
     Handle hoArray hoObject

     Get Create U_Array of hoArray
     Get Object_Id of hoArray to hoObject  // will return hoArray - object exists
     Send Destroy of hoArray
     Get Object_Id of hoArray to hoObject  // will return 0 - object does not exist
End_Procedure