cFrameObjSetInsertionPoint Method

Assigns frame object insertion point data. The assignments include the cardinal point and end joint offsets.

Namespace:  ETABS2016
Assembly:  ETABS2016 (in ETABS2016.dll) Version: 16.0.0.0 (16.0.0.0)
Syntax
Copy
int SetInsertionPoint(
	string Name,
	int CardinalPoint,
	bool Mirror2,
	bool StiffTransform,
	ref double[] Offset1,
	ref double[] Offset2,
	string CSys = "Local",
	eItemType ItemType = eItemType.Objects
)

Parameters

Name
Type: SystemString
The name of an existing frame object or group, depending on the value of the ItemType item.
CardinalPoint
Type: SystemInt32
This is a numeric value from 1 to 11 that specifies the cardinal point for the frame object. The cardinal point specifies the relative position of the frame section on the line representing the frame object.
  1. bottom left
  2. bottom center
  3. bottom right
  4. middle left
  5. middle center
  6. middle right
  7. top left
  8. top center
  9. top right
  10. centroid
  11. shear center
Mirror2
Type: SystemBoolean
If this item is True, the frame object section is assumed to be mirrored (flipped) about its local 2-axis.
StiffTransform
Type: SystemBoolean
If this item is True, the frame object stiffness is transformed for cardinal point and joint offsets from the frame section centroid.
Offset1
Type: SystemDouble
This is an array of three joint offset distances, in the coordinate directions specified by CSys, at the I-End of the frame object. [L]
  • Offset1(0) = Offset in the 1-axis or X-axis direction
  • Offset1(1) = Offset in the 2-axis or Y-axis direction
  • Offset1(2) = Offset in the 3-axis or Z-axis direction
Offset2
Type: SystemDouble
This is an array of three joint offset distances, in the coordinate directions specified by CSys, at the J-End of the frame object. [L]
  • Offset2(0) = Offset in the 1-axis or X-axis direction
  • Offset2(1) = Offset in the 2-axis or Y-axis direction
  • Offset2(2) = Offset in the 3-axis or Z-axis direction
CSys (Optional)
Type: SystemString
This is Local or the name of a defined coordinate system. It is the coordinate system in which the Offset1 and Offset2 items are specified.
ItemType (Optional)
Type: ETABS2016eItemType
This is one of the following items in the eItemType enumeration:
  • Object = 0
  • Group = 1
  • SelectedObjects = 2

If this item is Objects, the assignment is made to the frame object specified by the Name item.

If this item is Group, the assignment is made to all frame objects in the group specified by the Name item.

If this item is SelectedObjects, the assignment is made to all selected frame objects and the Name item is ignored.

Return Value

Type: Int32
Returns zero if the insertion point data is successfully assigned, otherwise it returns a nonzero value.
Remarks
Examples
VB
Copy
Public Sub Example()
   Dim SapModel As cSapModel
   Dim EtabsObject As cOAPI
   Dim ret As Integer = -1
   Dim i As integer
   Dim Offset1() As Double
   Dim Offset2() As Double

'create ETABS object
   EtabsObject = CreateObject("CSI.ETABS.API.ETABSObject")

'start ETABS application
  ret = EtabsObject.ApplicationStart()

'create SapModel object
   SapModel = EtabsObject.SapModel

'initialize model
   ret = SapModel.InitializeNewModel()

'create steel deck template model
   ret = SapModel.File.NewSteelDeck(4, 12, 12, 4, 4, 24, 24)

'assign frame insertion point
   ReDim Offset1(2)
   ReDim Offset2(2)
   For i=0 To 2
      Offset1(i)=10 + i
      Offset2(i)=20 + i
   Next i
   ret = SapModel.FrameObj.SetInsertionPoint("15", 7, False, True, Offset1, Offset2)

'close ETABS
   EtabsObject.ApplicationExit(False)

'clean up variables
   SapModel = Nothing
   EtabsObject = Nothing

End Sub
See Also