GetNameList

Your Ad Here

Syntax

SapObject.SapModel.RespCombo.GetNameList

VB6 Procedure

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

Parameters

NumberNames

The number of response combination names retrieved by the program.

MyName

This is a one-dimensional array of response combination 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 response combinations.

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

VBA Example

Sub GetComboNames()
   '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)

   'add combos
      ret = SapModel.RespCombo.Add("COMB1", 0)
      ret = SapModel.RespCombo.Add("COMB2", 2)

   'get combo names
      ret = SapModel.RespCombo.GetNameList(NumberNames, MyName)

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

Release Notes

Initial release in version 11.00.