Changename: Syntax

The ChangeName function changes the name of a defined load combination in SAP2000. It takes in the existing name as a string and the new name as a string. It returns 0 if successful or a non-zero value if unsuccessful. The new name must be unique from all other combinations and load cases. The example code shows how to start SAP2000, create a model, add a combination, and change its name.

Uploaded by

Tony Park

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

17 views2 pages

Changename: Syntax

Uploaded by

Tony Park

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 2

ChangeName {Combinations} Page 1 of 2

ChangeName
Syntax
SapObject.SapModel.RespCombo.ChangeName

VB6 Procedure
Function ChangeName(ByVal Name As String, ByVal NewName As String) As Long

Parameters
Name
The existing name of a defined load combination.
NewName
The new name for the combination.

Remarks
The function returns zero if the new name is successfully applied, otherwise it returns a
nonzero value.
The new load combination name must be different from all other load combinations and
all load cases. If the name is not unique, an error will be returned.

VBA Example
Sub ChangeComboName()
'dimension variables
Dim SapObject as cOAPI
Dim SapModel As cSapModel
Dim ret As Long

'create Sap2000 object

Set SapObject = CreateObject("CSI.SAP2000.API.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 combo
ret = SapModel.RespCombo.Add("COMB1", 1)

'change combo name

ret = SapModel.RespCombo.ChangeName("COMB1", "MyCombo")

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

Release Notes

mk:@MSITStore:C:\Program%20Files\Computers%20and%20Structures\SAP2000%202... 19/10/2019
ChangeName {Combinations} Page 2 of 2

Initial release in version 11.00.

Changed nomenclature from Load Cases, Analysis Cases and Response Combinations
to Load Patterns, Load Cases and Load Combinations, respectively, in version 12.00.

Changename: Syntax

Uploaded by

Changename: Syntax

Uploaded by

ChangeName {Combinations} Page 1 of 2

'create Sap2000 object

'start Sap2000 application

'create SapModel object

'create model from template

'change combo name

Initial release in version 11.00.

You might also like