SetNonPrismatic Method

cPropFrame SetNonPrismatic Method

CSi API ETABS 2015

Assigns data to a nonprismatic frame section property.

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

Syntax

int SetNonPrismatic(
	string Name,
	int NumberItems,
	ref string[] StartSec,
	ref string[] EndSec,
	ref double[] MyLength,
	ref int[] MyType,
	ref int[] EI33,
	ref int[] EI22,
	int Color = -1,
	string Notes = "",
	string GUID = ""
)

int SetNonPrismatic(
	string Name,
	int NumberItems,
	ref string[] StartSec,
	ref string[] EndSec,
	ref double[] MyLength,
	ref int[] MyType,
	ref int[] EI33,
	ref int[] EI22,
	int Color = -1,
	string Notes = "",
	string GUID = ""
)

Function SetNonPrismatic ( _
	Name As String, _
	NumberItems As Integer, _
	ByRef StartSec As String(), _
	ByRef EndSec As String(), _
	ByRef MyLength As Double(), _
	ByRef MyType As Integer(), _
	ByRef EI33 As Integer(), _
	ByRef EI22 As Integer(), _
	Optional Color As Integer = -1, _
	Optional Notes As String = "", _
	Optional GUID As String = "" _
) As Integer

Function SetNonPrismatic ( _
	Name As String, _
	NumberItems As Integer, _
	ByRef StartSec As String(), _
	ByRef EndSec As String(), _
	ByRef MyLength As Double(), _
	ByRef MyType As Integer(), _
	ByRef EI33 As Integer(), _
	ByRef EI22 As Integer(), _
	Optional Color As Integer = -1, _
	Optional Notes As String = "", _
	Optional GUID As String = "" _
) As Integer

int SetNonPrismatic(
	String^ Name, 
	int NumberItems, 
	array<String^>^% StartSec, 
	array<String^>^% EndSec, 
	array<double>^% MyLength, 
	array<int>^% MyType, 
	array<int>^% EI33, 
	array<int>^% EI22, 
	int Color = -1, 
	String^ Notes = L"", 
	String^ GUID = L""
)

int SetNonPrismatic(
	String^ Name, 
	int NumberItems, 
	array<String^>^% StartSec, 
	array<String^>^% EndSec, 
	array<double>^% MyLength, 
	array<int>^% MyType, 
	array<int>^% EI33, 
	array<int>^% EI22, 
	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.

NumberItems: Type: System Int32
The number of segments assigned to the nonprismatic section.

StartSec: Type: System String
This is an array of the names of the frame section properties at the start of each segment.
Auto select lists and nonprismatic sections are not allowed in this array.

EndSec: Type: System String
This is an array of the names of the frame section properties at the end of each segment.
Auto select lists and nonprismatic sections are not allowed in this array.

MyLength: Type: System Double
This is an array that includes the length of each segment. The length may be variable or absolute as indicated by the MyType item. [L] when length is absolute.

MyType

Type:

System Int32
This is an array of either 1 or 2, indicating the length type for each segment:

Value	MyType
1	Variable (relative length)
2	Absolute

EI33

Type:

System Int32
This is an array of 1, 2 or 3, indicating the variation type for EI33 in each segment:

Value	EI33
1	Linear
2	Parabolic
2	Cubic

EI22

Type:

System Int32
This is an array of 1, 2 or 3, indicating the variation type for EI22 in each segment:

Value	EI22
1	Linear
2	Parabolic
2	Cubic

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 data is successfully filled; 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 
       Dim StartSec() As String 
       Dim EndSec() As String 
       Dim Length() As Double 
       Dim SegType() As Integer 
       Dim EI33() As Integer 
       Dim EI22() As Integer 

   '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("ISEC1", "A992Fy50", 24, 10, 0.5, 0.3, 14, 0.6)

   'set new I-type frame section property
       ret = SapModel.PropFrame.SetISection("ISEC2", "A992Fy50", 36, 15, 1, 0.5, 121, 0.9)

    'set new nonprismatic frame section property 
       ReDim StartSec(2)
       ReDim EndSec(2)
       ReDim Length(2)
       ReDim SegType(2)
       ReDim EI33(2)
       ReDim EI22(2)
       StartSec(0) = "ISEC2"
       EndSec(0) = "ISEC1"
       Length(0) = 60
       SegType(0) = 2
       EI33(0)= 2
       EI22(0)= 1

       StartSec(1) = "ISEC1"
       EndSec(1) = "ISEC1"
       Length(1) = 1
       SegType(1) = 1
       EI33(1)= 2
       EI22(1)= 1

       StartSec(2) = "ISEC1"
       EndSec(2) = "ISEC2"
       Length(2) = 60
       SegType(2) = 2
       EI33(2)= 2
       EI22(2)= 1

       ret = SapModel.PropFrame.SetNonPrismatic("NP1", 3, StartSec, EndSec, Length, SegType, EI33, EI22)

   '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 
       Dim StartSec() As String 
       Dim EndSec() As String 
       Dim Length() As Double 
       Dim SegType() As Integer 
       Dim EI33() As Integer 
       Dim EI22() As Integer 

   '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("ISEC1", "A992Fy50", 24, 10, 0.5, 0.3, 14, 0.6)

   'set new I-type frame section property
       ret = SapModel.PropFrame.SetISection("ISEC2", "A992Fy50", 36, 15, 1, 0.5, 121, 0.9)

    'set new nonprismatic frame section property 
       ReDim StartSec(2)
       ReDim EndSec(2)
       ReDim Length(2)
       ReDim SegType(2)
       ReDim EI33(2)
       ReDim EI22(2)
       StartSec(0) = "ISEC2"
       EndSec(0) = "ISEC1"
       Length(0) = 60
       SegType(0) = 2
       EI33(0)= 2
       EI22(0)= 1

       StartSec(1) = "ISEC1"
       EndSec(1) = "ISEC1"
       Length(1) = 1
       SegType(1) = 1
       EI33(1)= 2
       EI22(1)= 1

       StartSec(2) = "ISEC1"
       EndSec(2) = "ISEC2"
       Length(2) = 60
       SegType(2) = 2
       EI33(2)= 2
       EI22(2)= 1

       ret = SapModel.PropFrame.SetNonPrismatic("NP1", 3, StartSec, EndSec, Length, SegType, EI33, EI22)

   'close ETABS
       EtabsObject.ApplicationExit(False)

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