mdlIObject GetObjectHandle

Obtains the handle to an object.

Syntax

mdlIObject_handle GetObjectHandle

Application

MotionView Tcl Query

Description

This command obtains the handle to an object. This handle can further be used to perform functions like add, cut, etc.

Inputs

handle_name
The name of the handle to the object.

Example

To create a point, get its object handle, and then cut the object:
hwi OpenStack
hwi GetSessionHandle mySessionName 
mySessionName GetProjectHandle myProjectName 
set activePageNum [myProjectName GetActivePage]
myProjectName GetPageHandle myPageName $activePageNum
set activeWinNum [myPageName GetActiveWindow]
myPageName GetWindowHandle myWindowName $activeWinNum
myWindowName GetClientHandle myClientName 
myClientName GetModelHandle myModelName 
myModelName InterpretEntity newpt Point test_point "\"Test Point\"";
myModelName InterpretSet SetPoint test_point 50.0 50.0 50.0;
newpt ReleaseHandle;
myModelName Evaluate
myModelName GetChildHandle point_handle test_point
point_handle GetObjectHandle obj
obj CutObject
obj ReleaseHandle
point_handle ReleaseHandle
myModelName ReleaseHandle
myClientName ReleaseHandle
myWindowName ReleaseHandle
myPageName ReleaseHandle
myProjectName ReleaseHandle
mySessionName ReleaseHandle
hwi CloseStack

Errors

Returns the name of the handle if successful, otherwise an error message.