Hide Table of Contents
AddForce3 Method (ICWLoadsAndRestraintsManager)

Creates a force.

.NET Syntax

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