mdlIObject AddAssemblyPlaceholder

Syntax

mdlIObject_handle AddAssemblyPlaceholder new_handle, varname, label, assembly_type, assembly_tag

Application

MotionView Tcl Modify

Description

This command adds an assembly placeholder using the ‘varname’, ‘label’, and ‘assembly_type’ arguments. As the name suggests, the AssemblyPlaceholder is just a place holder for an assembly. It can be understood as an assembly (void) where the data file and the definition file are not yet selected.

Inputs

new_handle: The handle of the newly created assembly placeholder.
varname: The variable name of the assembly placeholder.
label: The label for the assembly placeholder.
assembly_type: The definition type that should be selected to create the assembly. The data file should have the same ‘assembly_type’ so that it can be selected to assembly placeholder.
assembly_tag: The tag for the assembly placeholder.

Example

To add an assembly placeholder:

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 GetObjectHandle obj_handle
obj_handle AddAssemblyPlaceholder assem_handle assem_0 "\"Assembly Placeholder 0\"" Front_Half  Front_Half;
assem_handle ReleaseHandle;
obj_handle ReleaseHandle;
myModelName ReleaseHandle
myClientName ReleaseHandle
myWindowName ReleaseHandle
myPageName ReleaseHandle
myProjectName ReleaseHandle
mySessionName ReleaseHandle

Errors

Returns the handle of the newly created assembly if successful. If there is an error, an error code will be returned.