DEPRECATED Retrieves the mass source for the model.
Namespace: ETABS2015Assembly: ETABS2015 (in ETABS2015.dll) Version: 15.0.0.0 (15.0.0.0)
int GetMassSource(
ref int MyOption,
ref int NumberLoads,
ref string[] LoadPat,
ref double[] SF
)
Function GetMassSource ( _
ByRef MyOption As Integer, _
ByRef NumberLoads As Integer, _
ByRef LoadPat As String(), _
ByRef SF As Double() _
) As Integer
int GetMassSource(
int% MyOption,
int% NumberLoads,
array<String^>^% LoadPat,
array<double>^% SF
)
Parameters
- MyOption
- Type:
System Int32
This is 1, 2 or 3, indicating the mass source option.
| Value | Option |
|---|
| 1 | From element self mass and additional masses |
| 2 | From loads |
| 3 | From element self mass and additional masses and loads |
- NumberLoads
- Type: System Int32
The number of load patterns from which mass is obtained.
This item applies only when MyOption is 2 or 3.
- LoadPat
- Type: System String
This is an array of the names of the load patterns from which mass is obtained.
This item applies only when MyOption is 2 or 3.
- SF
- Type: System Double
Return Value
Returns zero if the mass source is successfully retrieved;
otherwise it returns a nonzero value.
This function is DEPRECATED. Please use
GetMassSource_1(Boolean , Boolean , Boolean , Int32 , String , Double )Public Sub Example()
Dim SapModel As cSapModel
Dim EtabsObject As cOAPI
Dim ret As Integer = -1
Dim MyLoadPat() As String
Dim MySF() As Double
Dim MyOption As Integer
Dim NumberLoads As Integer
Dim LoadPat() As String
Dim sf() As Double
EtabsObject = CreateObject("CSI.ETABS.API.ETABSObject")
ret = EtabsObject.ApplicationStart()
SapModel = EtabsObject.SapModel
ret = SapModel.InitializeNewModel()
ret = SapModel.File.NewSteelDeck(4,12,12,4,4,24,24)
ReDim MyLoadPat(1)
ReDim MySF(1)
MyLoadPat(0) = "DEAD"
MyLoadPat(1) = "LIVE"
MySF(0) = 1
MySF(1) = 0.2
ret = SapModel.PropMaterial.SetMassSource(3, 2, MyLoadPat, MySF)
ret = SapModel.PropMaterial.GetMassSource(MyOption, NumberLoads, LoadPat, sf)
EtabsObject.ApplicationExit(False)
SapModel = Nothing
EtabsObject = Nothing
End SubPublic Sub Example()
Dim SapModel As cSapModel
Dim EtabsObject As cOAPI
Dim ret As Integer = -1
Dim MyLoadPat() As String
Dim MySF() As Double
Dim MyOption As Integer
Dim NumberLoads As Integer
Dim LoadPat() As String
Dim sf() 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)
'set mass source
ReDim MyLoadPat(1)
ReDim MySF(1)
MyLoadPat(0) = "DEAD"
MyLoadPat(1) = "LIVE"
MySF(0) = 1
MySF(1) = 0.2
ret = SapModel.PropMaterial.SetMassSource(3, 2, MyLoadPat, MySF)
'get mass source
ret = SapModel.PropMaterial.GetMassSource(MyOption, NumberLoads, LoadPat, sf)
'close ETABS
EtabsObject.ApplicationExit(False)
'clean up variables
SapModel = Nothing
EtabsObject = Nothing
End Sub