GetNameList

Your Ad Here

Syntax

SapObject.SapModel.ConstraintDef.GetNameList

VB6 Procedure

Function GetNameList(ByRef NumberNames As Long, ByRef MyName() As String) As Long

Parameters

NumberNames

The number of joint constraint names retrieved by the program.

MyName

This is a one-dimensional array of joint constraint names. The MyName array is created as a dynamic, zero-based, array by the API user:

Dim MyName() as String

The array is dimensioned to (NumberNames – 1) inside the Sap2000 program, filled with the names, and returned to the API user.

Remarks

This function retrieves the names of all defined joint constraints.

The function returns zero if the names are successfully retrieved, otherwise it returns nonzero.

VBA Example

Sub GetJointConstraintNames()
   'dimension variables
      Dim SapObject As Sap2000.SapObject
      Dim SapModel As cSapModel
      Dim ret As Long
      Dim NumberNames As Long
      Dim MyName() As String

   'create Sap2000 object
      Set SapObject = New SAP2000.SapObject

   'start Sap2000 application
      SapObject.ApplicationStart

   'create SapModel object
      Set SapModel = SapObject.SapModel

   'initialize model
      ret = SapModel.InitializeNewModel

   'create model from template
      ret = SapModel.File.New2DFrame(PortalFrame, 3, 124, 3, 200)

   'define new constraint
      ret = SapModel.ConstraintDef.SetDiaphragm("Diaph1", AutoAxis)

   'get constraint names
      ret = SapModel.ConstraintDef.GetNameList(NumberNames, MyName)

   'close Sap2000
      SapObject.ApplicationExit False
      Set SapModel = Nothing
      Set SapObject = Nothing
End Sub

Release Notes

Initial release in version 11.00.