Hide Table of Contents
EditMate4 Method (IAssemblyDoc)

Edits the selected assembly component mate relationship.

.NET Syntax

Visual Basic (Declaration) 
Sub EditMate4( _
   ByVal MateTypeFromEnum As System.Integer, _
   ByVal AlignFromEnum As System.Integer, _
   ByVal Flip As System.Boolean, _
   ByVal Distance As System.Double, _
   ByVal DistanceAbsUpperLimit As System.Double, _
   ByVal DistanceAbsLowerLimit As System.Double, _
   ByVal GearRatioNumerator As System.Double, _
   ByVal GearRatioDenominator As System.Double, _
   ByVal Angle As System.Double, _
   ByVal AngleAbsUpperLimit As System.Double, _
   ByVal AngleAbsLowerLimit As System.Double, _
   ByVal ForPositioningOnly As System.Boolean, _
   ByVal LockRotation As System.Boolean, _
   ByVal WidthMateOption As System.Integer, _
   ByVal RepairMatesWithSameMissingEntity As System.Boolean, _
   ByRef ErrorStatus As System.Integer _
) 
Visual Basic (Usage) 
Dim instance As IAssemblyDoc
Dim MateTypeFromEnum As System.Integer
Dim AlignFromEnum As System.Integer
Dim Flip As System.Boolean
Dim Distance As System.Double
Dim DistanceAbsUpperLimit As System.Double
Dim DistanceAbsLowerLimit As System.Double
Dim GearRatioNumerator As System.Double
Dim GearRatioDenominator As System.Double
Dim Angle As System.Double
Dim AngleAbsUpperLimit As System.Double
Dim AngleAbsLowerLimit As System.Double
Dim ForPositioningOnly As System.Boolean
Dim LockRotation As System.Boolean
Dim WidthMateOption As System.Integer
Dim RepairMatesWithSameMissingEntity As System.Boolean
Dim ErrorStatus As System.Integer
 
instance.EditMate4(MateTypeFromEnum, AlignFromEnum, Flip, Distance, DistanceAbsUpperLimit, DistanceAbsLowerLimit, GearRatioNumerator, GearRatioDenominator, Angle, AngleAbsUpperLimit, AngleAbsLowerLimit, ForPositioningOnly, LockRotation, WidthMateOption, RepairMatesWithSameMissingEntity, ErrorStatus)
C# 
void EditMate4( 
   System.int MateTypeFromEnum,
   System.int AlignFromEnum,
   System.bool Flip,
   System.double Distance,
   System.double DistanceAbsUpperLimit,
   System.double DistanceAbsLowerLimit,
   System.double GearRatioNumerator,
   System.double GearRatioDenominator,
   System.double Angle,
   System.double AngleAbsUpperLimit,
   System.double AngleAbsLowerLimit,
   System.bool ForPositioningOnly,
   System.bool LockRotation,
   System.int WidthMateOption,
   System.bool RepairMatesWithSameMissingEntity,
   out System.int ErrorStatus
)
C++/CLI 
void EditMate4( 
&   System.int MateTypeFromEnum,
&   System.int AlignFromEnum,
&   System.bool Flip,
&   System.double Distance,
&   System.double DistanceAbsUpperLimit,
&   System.double DistanceAbsLowerLimit,
&   System.double GearRatioNumerator,
&   System.double GearRatioDenominator,
&   System.double Angle,
&   System.double AngleAbsUpperLimit,
&   System.double AngleAbsLowerLimit,
&   System.bool ForPositioningOnly,
&   System.bool LockRotation,
&   System.int WidthMateOption,
&   System.bool RepairMatesWithSameMissingEntity,
&   [Out] System.int ErrorStatus
) 

Parameters

MateTypeFromEnum
Type of mate as defined in swMateType_e
AlignFromEnum
Type of alignment as defined in swMateAlign_e
Flip
True to flip the mate components, false to not
Distance
Distance value; valid only if MateTypeFromEnum is swMateType_e.swMateDISTANCE
DistanceAbsUpperLimit
Absolute maximum distance allowed; valid only if MateTypeFromEnum is swMateType_e.swMateDISTANCE
DistanceAbsLowerLimit
Absolute minimum distance allowed; valid only if MateTypeFromEnum is swMateType_e.swMateDISTANCE
GearRatioNumerator
Gear ratio numerator value; valid only if MateTypeFromEnum is swMateType_e.swMateGEAR
GearRatioDenominator
Gear ratio denominator value; valid only if MateTypeFromEnum is swMateType_e.swMateGEAR
Angle
Angle value; valid only if MateTypeFromEnum is swMateType_e.swMateANGLE
AngleAbsUpperLimit
Absolute maximum angle allowed; valid only if MateTypeFromEnum is swMateType_e.swMateANGLE
AngleAbsLowerLimit
Absolute minimum angle allowed; valid only if MateTypeFromEnum is swMateType_e.swMateANGLE
ForPositioningOnly
True to only position the components according to the mating relationship and not return a mate, false to return a mate
LockRotation
True to lock component rotation, false to not
WidthMateOption
Width mate options as defined in swMateWidthOptions_e; valid only if MateTypeFromEnum is swMateType_e.swMateWIDTH
RepairMatesWithSameMissingEntity
True to repair all mates missing the same mate entity, false to not
ErrorStatus
Success or error as defined by swAddMateError_e

Example

Remarks

To edit:

If repairing all mates missing the same mate entity, then select the following items in the following order before calling this method:

  1. Mate feature to repair.
  2. Two model items to mate (that is, two faces, edge and face, and so on). The two model items must be selected with a selection mark of 1. See ISelectData or IModelDocExtension::SelectByID2 for details on using selection marks.

If MateTypeFromEnum is swMateType_e.swMateDISTANCE or swMateType_e.swMateANGLE, and the mate is applied to the closest position that meets the mate condition specified by Distance or Angle, then setting Flip to true moves the components to the other possible mate position.

 

This method does not support editing Inplace mates.

 

See Also

Availability

SOLIDWORKS 2016 FCS, Revision Number 24.0


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:   EditMate4 Method (IAssemblyDoc)
*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) 2018 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.