SolidWorksMakroprogrammierung

Methode · MoveCopyBodyFeatureData

AddMate-Methode (MoveCopyBodyFeatureData)

Fügt dem Feature „Körper verschieben/kopieren“ eine Verknüpfung hinzu.

Syntax

Function AddMate( _
   ByVal MateEntVar As Variant, _
   ByVal MateTypeFromEnum As Long, _
   ByVal AlignFromEnum As Long, _
   ByVal Distance As Double, _
   ByVal Angle As Double, _
   ByRef ErrorStatus As Long _
) As Mate2
Set swMate = swDaten.AddMate(vElemente, swMateCOINCIDENT, swMateAlignALIGNED, 0, 0, nFehler)

Parameter

MateEntVarVariantByVal
Array der Elemente, die verknüpft werden, oder Nothing. Bei Nothing wählst du die Elemente vorher mit ModelDocExtension.SelectByID2 und der Markierung 1 aus.
MateTypeFromEnumLongByVal
Art der Verknüpfung, ein Wert aus swMateType_e.
AlignFromEnumLongByVal
Ausrichtung, ein Wert aus swMateAlign_e.
DistanceDoubleByVal
Abstand bei Abstandsverknüpfungen und Verknüpfungen mit Grenzen. Die Einheit nennt die Hilfe nicht, vermutlich Meter.
AngleDoubleByVal
Winkel bei Winkelverknüpfungen. Die Einheit nennt die Hilfe nicht, vermutlich Bogenmaß.
ErrorStatusLongByRef · Rückgabe
Gibt Erfolg oder Fehler als Wert aus swAddMateError_e zurück, bei Erfolg swAddMateError_NoError (1).

Rückgabewert

Die neue Verknüpfung (Mate2).

Beispiel

' swModel ist das Teil (ModelDoc2), swFeat ein Feature „Körper verschieben/kopieren“ (Feature).
' dX1 bis dZ2 sind Punkte in Metern auf einer Fläche des verschobenen Körpers und auf einer Fläche eines anderen Körpers.
Dim swDaten As SldWorks.MoveCopyBodyFeatureData
Dim swSelMgr As SldWorks.SelectionMgr
Dim swMate As SldWorks.Mate2
Dim aElemente(1) As Object
Dim vElemente As Variant
Dim nFehler As Long
Set swDaten = swFeat.GetDefinition
If swDaten.AccessSelections(swModel, Nothing) Then
    Set swSelMgr = swModel.SelectionManager
    swModel.Extension.SelectByID2 "", "FACE", dX1, dY1, dZ1, False, 0, Nothing, 0
    swModel.Extension.SelectByID2 "", "FACE", dX2, dY2, dZ2, True, 0, Nothing, 0
    Set aElemente(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set aElemente(1) = swSelMgr.GetSelectedObject6(2, -1)
    swModel.ClearSelection2 True
    vElemente = aElemente
    Set swMate = swDaten.AddMate(vElemente, swMateCOINCIDENT, swMateAlignALIGNED, 0, 0, nFehler)
    If nFehler = swAddMateError_NoError Then
        If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
    Else
        Debug.Print "Fehler " & nFehler
        swDaten.ReleaseSelectionAccess
    End If
End If

Bemerkungen

Ein Hilfebeispiel gibt es nicht. Für den Ablauf verweist die Hilfe auf das Thema „Accessing Selections that Define Features“, also erst MoveCopyBodyFeatureData.AccessSelections und danach Feature.ModifyDefinition. Ob die Verknüpfung schon mit AddMate entsteht oder erst mit ModifyDefinition, sagt die Hilfe nicht. Welche Arten aus swMateType_e erlaubt sind, sagt sie ebenfalls nicht.

Für die Ausrichtung nimmst du swMateAlignALIGNED, swMateAlignANTI_ALIGNED oder swMateAlignCLOSEST. Die übrigen Werte von swMateAlign_e sind veraltet.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2006

Englisches Original: IMoveCopyBodyFeatureData::AddMate in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.