SetCoverPlatedI Method

cPropFrame SetCoverPlatedI Method

CSi API ETABS 2015

Initializes a cover plated I-type frame section property. If this function is called for an existing frame section property, all items for the section are reset to their default value.

Namespace: ETABS2015
Assembly: ETABS2015 (in ETABS2015.dll) Version: 15.0.0.0 (15.0.0.0)

Syntax

C++

Copy to Clipboard Print

int SetCoverPlatedI(
	string Name,
	string SectName,
	double FyTopFlange,
	double FyWeb,
	double FyBotFlange,
	double Tc,
	double Bc,
	string MatPropTop,
	double Tcb,
	double Bcb,
	string MatPropBot,
	int Color = -1,
	string Notes = "",
	string GUID = ""
)

int SetCoverPlatedI(
	string Name,
	string SectName,
	double FyTopFlange,
	double FyWeb,
	double FyBotFlange,
	double Tc,
	double Bc,
	string MatPropTop,
	double Tcb,
	double Bcb,
	string MatPropBot,
	int Color = -1,
	string Notes = "",
	string GUID = ""
)

Function SetCoverPlatedI ( _
	Name As String, _
	SectName As String, _
	FyTopFlange As Double, _
	FyWeb As Double, _
	FyBotFlange As Double, _
	Tc As Double, _
	Bc As Double, _
	MatPropTop As String, _
	Tcb As Double, _
	Bcb As Double, _
	MatPropBot As String, _
	Optional Color As Integer = -1, _
	Optional Notes As String = "", _
	Optional GUID As String = "" _
) As Integer

Function SetCoverPlatedI ( _
	Name As String, _
	SectName As String, _
	FyTopFlange As Double, _
	FyWeb As Double, _
	FyBotFlange As Double, _
	Tc As Double, _
	Bc As Double, _
	MatPropTop As String, _
	Tcb As Double, _
	Bcb As Double, _
	MatPropBot As String, _
	Optional Color As Integer = -1, _
	Optional Notes As String = "", _
	Optional GUID As String = "" _
) As Integer

int SetCoverPlatedI(
	String^ Name, 
	String^ SectName, 
	double FyTopFlange, 
	double FyWeb, 
	double FyBotFlange, 
	double Tc, 
	double Bc, 
	String^ MatPropTop, 
	double Tcb, 
	double Bcb, 
	String^ MatPropBot, 
	int Color = -1, 
	String^ Notes = L"", 
	String^ GUID = L""
)

int SetCoverPlatedI(
	String^ Name, 
	String^ SectName, 
	double FyTopFlange, 
	double FyWeb, 
	double FyBotFlange, 
	double Tc, 
	double Bc, 
	String^ MatPropTop, 
	double Tcb, 
	double Bcb, 
	String^ MatPropBot, 
	int Color = -1, 
	String^ Notes = L"", 
	String^ GUID = L""
)

Parameters

Name: Type: System String
The name of an existing or new frame section property. If this is an existing property, that property is modified; otherwise, a new property is added.

SectName: Type: System String

FyTopFlange: Type: System Double
The yield strength of the top flange of the I-section. [F/L2]
If this item is 0, the yield strength of the I-section specified by the SectName item is used.

FyWeb: Type: System Double
The yield strength of the web of the I-section. [F/L2]
If this item is 0, the yield strength of the I-section specified by the SectName item is used.

FyBotFlange: Type: System Double
The yield strength of the bottom flange of the I-section. [F/L2]
If this item is 0, the yield strength of the I-section specified by the SectName item is used.

Tc: Type: System Double

Bc: Type: System Double

MatPropTop: Type: System String
The name of the material property for the bottom cover plate.
This item applies only if both the tcb and the bcb items are greater than 0.

Tcb: Type: System Double

Bcb: Type: System Double

MatPropBot: Type: System String
The name of the material property for the bottom cover plate.
This item applies only if both the tcb and the bcb items are greater than 0.

Color (Optional): Type: System Int32

Notes (Optional): Type: System String

GUID (Optional): Type: System String
The GUID (global unique identifier), if any, assigned to the section. If this item is input as Default, the program assigns a GUID to the section.

Return Value

Returns zero if the section property is successfully initialized; otherwise it returns a nonzero value.

Remarks

Examples

C++

Copy to Clipboard Print

Public Sub Example()
       Dim SapModel As cSapModel
       Dim EtabsObject As cOAPI
       Dim ret As Integer = -1 

   '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 new I-type frame section property
       ret = SapModel.PropFrame.SetISection("ISEC", "A992Fy50", 24, 8, 0.5, 0.3, 8, 0.5)

   'set new cover plated I-type frame section property
       ret = SapModel.PropFrame.SetCoverPlatedI("CPI1", "ISEC", 0, 36, 0, 0.75, 14, "A992Fy50", 0.5, 6, "A992Fy50")

   'close ETABS
       EtabsObject.ApplicationExit(False)

   'clean up variables
       SapModel = Nothing
       EtabsObject = Nothing 
   End Sub

Public Sub Example()
       Dim SapModel As cSapModel
       Dim EtabsObject As cOAPI
       Dim ret As Integer = -1 

   '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 new I-type frame section property
       ret = SapModel.PropFrame.SetISection("ISEC", "A992Fy50", 24, 8, 0.5, 0.3, 8, 0.5)

   'set new cover plated I-type frame section property
       ret = SapModel.PropFrame.SetCoverPlatedI("CPI1", "ISEC", 0, 36, 0, 0.75, 14, "A992Fy50", 0.5, 6, "A992Fy50")

   'close ETABS
       EtabsObject.ApplicationExit(False)

   'clean up variables
       SapModel = Nothing
       EtabsObject = Nothing 
   End Sub