GetMergeNumber

Your Ad Here

Syntax

SapObject.SapModel.PointElm.GetMergeNumber

VB6 Procedure

Function GetMergeNumber(ByVal Name As String, ByRef MergeNumber As Long) As Long

Parameters

Name

The name of an existing point element.

MergeNumber

The merge number assigned to the specified point element.

Remarks

This function retrieves the merge number for a point element. By default the merge number for a point is zero. Points with different merge numbers are not automatically merged by the program.

The function returns zero if the merge number is successfully retrieved, otherwise it returns a nonzero value.

VBA Example

Sub GetPointElmMergeNumber()
   'dimension variables
      Dim SapObject As Sap2000.SapObject
      Dim SapModel As cSapModel
      Dim ret As Long
      Dim m As Long

   '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)

   'set merge number
      ret = SapModel.PointObj.SetMergeNumber("3", 2)

   'create analysis model
      ret = SapModel.Analyze.CreateAnalysisModel

   'get merge number
      ret = SapModel.PointElm.GetMergeNumber("3", m)

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

Release Notes

Initial release in version 11.00.