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 Mate2Set swMate = swDaten.AddMate(vElemente, swMateCOINCIDENT, swMateAlignALIGNED, 0, 0, nFehler)Parameter
MateEntVarVariantByVal- Array der Elemente, die verknüpft werden, oder
Nothing. BeiNothingwählst du die Elemente vorher mitModelDocExtension.SelectByID2und der Markierung1aus. 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_ezurück, bei ErfolgswAddMateError_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 IfBemerkungen
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.