Hide Table of Contents
AddForce3 Method (ICWLoadsAndRestraintsManager)

Creates a force.

.NET Syntax

Visual Basic (Declaration) 
Function AddForce3( _
   ByVal ForceType As System.Integer, _
   ByVal SelectionType As System.Integer, _
   ByVal RefDirType As System.Integer, _
   ByVal InterpolationMode As System.Integer, _
   ByVal DistPercentageOpt As System.Integer, _
   ByVal NumOfRows As System.Integer, _
   ByVal DistValue As System.Object, _
   ByVal ForceValue As System.Object, _
   ByVal NonUniformLoading As System.Boolean, _
   ByVal NULoadingOnBeam As System.Boolean, _
   ByVal NonUniformLoadDistDef As System.Integer, _
   ByVal NonUniformLoadDistType As System.Integer, _
   ByVal Ucode As System.Integer, _
   ByVal TorqueNFVal As System.Double, _
   ByVal Comps As System.Object, _
   ByVal FlipOrigin As System.Boolean, _
   ByVal IsCurvedBeam As System.Boolean, _
   ByVal DispArray As System.Object, _
   ByVal RefGeom As System.Object, _
   ByVal PerUnitLength As System.Boolean, _
   ByRef ErrorCode As System.Integer _
) As CWForce
Visual Basic (Usage) 
Dim instance As ICWLoadsAndRestraintsManager
Dim ForceType As System.Integer
Dim SelectionType As System.Integer
Dim RefDirType As System.Integer
Dim InterpolationMode As System.Integer
Dim DistPercentageOpt As System.Integer
Dim NumOfRows As System.Integer
Dim DistValue As System.Object
Dim ForceValue As System.Object
Dim NonUniformLoading As System.Boolean
Dim NULoadingOnBeam As System.Boolean
Dim NonUniformLoadDistDef As System.Integer
Dim NonUniformLoadDistType As System.Integer
Dim Ucode As System.Integer
Dim TorqueNFVal As System.Double
Dim Comps As System.Object
Dim FlipOrigin As System.Boolean
Dim IsCurvedBeam As System.Boolean
Dim DispArray As System.Object
Dim RefGeom As System.Object
Dim PerUnitLength As System.Boolean
Dim ErrorCode As System.Integer
Dim value As CWForce
 
value = instance.AddForce3(ForceType, SelectionType, RefDirType, InterpolationMode, DistPercentageOpt, NumOfRows, DistValue, ForceValue, NonUniformLoading, NULoadingOnBeam, NonUniformLoadDistDef, NonUniformLoadDistType, Ucode, TorqueNFVal, Comps, FlipOrigin, IsCurvedBeam, DispArray, RefGeom, PerUnitLength, ErrorCode)
C# 
CWForce AddForce3( 
   System.int ForceType,
   System.int SelectionType,
   System.int RefDirType,
   System.int InterpolationMode,
   System.int DistPercentageOpt,
   System.int NumOfRows,
   System.object DistValue,
   System.object ForceValue,
   System.bool NonUniformLoading,
   System.bool NULoadingOnBeam,
   System.int NonUniformLoadDistDef,
   System.int NonUniformLoadDistType,
   System.int Ucode,
   System.double TorqueNFVal,
   System.object Comps,
   System.bool FlipOrigin,
   System.bool IsCurvedBeam,
   System.object DispArray,
   System.object RefGeom,
   System.bool PerUnitLength,
   out System.int ErrorCode
)
C++/CLI 
CWForce^ AddForce3( 
&   System.int ForceType,
&   System.int SelectionType,
&   System.int RefDirType,
&   System.int InterpolationMode,
&   System.int DistPercentageOpt,
&   System.int NumOfRows,
&   System.Object^ DistValue,
&   System.Object^ ForceValue,
&   System.bool NonUniformLoading,
&   System.bool NULoadingOnBeam,
&   System.int NonUniformLoadDistDef,
&   System.int NonUniformLoadDistType,
&   System.int Ucode,
&   System.double TorqueNFVal,
&   System.Object^ Comps,
&   System.bool FlipOrigin,
&   System.bool IsCurvedBeam,
&   System.Object^ DispArray,
&   System.Object^ RefGeom,
&   System.bool PerUnitLength,
&   [Out] System.int ErrorCode
) 

Parameters

ForceType

Type of force as defined in swsForceType_e

SelectionType

Type of selection as defined in swsSelectionType_e

RefDirType

Reference geometry entity to specify direction:

  • 0 = edge
  • 1 = axis
  • 2 = face or plane
InterpolationMode

Interpolation mode as defined in swsTableDrivenInterpolationType_e; only used in calculation if NonUniformLoadDistDef is swsBeamNonUniformLoadDef_e.swsTableDrivenLoad

DistPercentageOpt

Table-driven distribution option as defined in swsTableDrivenDistOption_e; only used in calculation if NonUniformLoadDistDef is swsBeamNonUniformLoadDef_e.swsTableDrivenLoad

NumOfRows
Number of rows for a table-driven nonuniform distribution; only used in calculation if NonUniformLoadDistDef is swsBeamNonUniformLoadDef_e.swsTableDrivenLoad
DistValue
Array of the percentage or absolute distances of the forces along the beam for a table-driven nonuniform distribution; only used in calculation if NonUniformLoadDistDef is swsBeamNonUniformLoadDef_e.swsTableDrivenLoad
ForceValue
Array of the values of the forces along the beam for a table-driven nonuniform distribution; only used in calculation if NonUniformLoadDistDef is swsBeamNonUniformLoadDef_e.swsTableDrivenLoad
NonUniformLoading
True for nonuniform distribution, false for uniform distribution
NULoadingOnBeam
True for nonuniform distribution along a beam, false for uniform distribution along a beam
NonUniformLoadDistDef
Definition of nonuniform distribution along a beam as defined in swsBeamNonUniformLoadDef_e
NonUniformLoadDistType
Type of nonuniform distribution type as defined in swsBeamNonUniformLoadType_e
Ucode

Loading directions:

  • 1 = Fx
  • 2 = Fy
  • 4 = Fz
  • 8 = Mx
  • 16 = My
  • 32 = Mz

For multiple combinations of force and moments in various directions, add up related values.

TorqueNFVal
Torque value for swsBeamNonUniformLoadDef_e.swsTotalLoad or swsBeamNonUniformLoadDef_e.swsCentralLoad
Comps
Array of force values for swsBeamNonUniformLoadDef_e.swsTotalLoad or swsBeamNonUniformLoadDef_e.swsCentralLoad
FlipOrigin
True to flip the beam origin, false to not; only used if NonUniformLoadDistDef is swsBeamNonUniformLoadDef_e.swsTableDrivenLoad
IsCurvedBeam
True if the beam is curved, false if the beam is straight
DispArray
Array of entities to which to apply the load
RefGeom
Geometry selected for the reference direction
PerUnitLength
True for swsBeamNonUniformLoadDef_e.swsCentralLoad and swsBeamNonUniformLoadDef_e.swsTableDrivenLoad; true or false for swsBeamNonUniformLoadDef_e.swsTotalLoad
ErrorCode

Error as defined in swsForceError_e

Return Value

Force

Example

Remarks

Pass null if reference geometry is not used. If you pass an IDispatch pointer, it is ignored.

 

See Also

Availability

SolidWorks Simulation API 2011 SP0


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   AddForce3 Method (ICWLoadsAndRestraintsManager)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:




x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2014 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.