SolidWorksMakroprogrammierung

Objekt · SldWorks

MoveCopyBodyFeatureData-Objekt

Die Definition eines Features „Körper verschieben/kopieren“: die Körper, ob und wie oft sie kopiert werden, und wie sie verschoben oder gedreht werden, über Werte, Bezüge oder Verknüpfungen.

Deklaration Dim x As SldWorks.MoveCopyBodyFeatureData · in der englischen .NET-Hilfe: IMoveCopyBodyFeatureData

Beschreibung

MoveCopyBodyFeatureData gibt Zugriff auf ein Feature „Körper verschieben/kopieren“ (Move/Copy Body). Das Feature verschiebt oder dreht Körper eines Teils und kann sie dabei kopieren. Ein Feature verschiebt oder dreht, nicht beides (siehe FeatureManager.InsertMoveCopyBody2). Die Befehle gibt es seit SOLIDWORKS 2005, MoveCopyBodyFeatureData.AddMate seit SOLIDWORKS 2006.

Zugriff

Beispiel

' Gibt Körper, Kopien und Werte des ausgewählten Features „Körper verschieben/kopieren“
' aus. Verschiebt das Feature die Körper über Werte ohne Bezug, kommen 20 mm in X dazu.
' Vorbedingung: Ein Teil mit einem Feature „Körper verschieben/kopieren“ ist offen,
'               das Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G). Ein Feature, das über Werte
'               verschiebt, ist geändert.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.MoveCopyBodyFeatureData
    Dim swKoerper As SldWorks.Body2
    Dim vKoerper As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "MoveCopyBody" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetBodiesCount & " Körper"
    vKoerper = swDaten.Bodies
    If IsArray(vKoerper) Then
        For i = 0 To UBound(vKoerper)
            Set swKoerper = vKoerper(i)
            Debug.Print "  " & swKoerper.Name
        Next i
    End If
    If swDaten.Copy Then Debug.Print "Kopien: " & swDaten.NumberOfCopies

    Select Case swDaten.TransformType
        Case swTransformType_Translation
            Debug.Print "Verschieben in mm: " & swDaten.TransformX * 1000# & ", " & _
                swDaten.TransformY * 1000# & ", " & swDaten.TransformZ * 1000#
        Case swTransformType_Rotation
            Debug.Print "Drehen in Grad: " & swDaten.TransformX * 180# / PI & ", " & _
                swDaten.TransformY * 180# / PI & ", " & swDaten.TransformZ * 180# / PI
        Case Else
            Debug.Print "Keine Transformation"
    End Select

    If swDaten.TransformType = swTransformType_Translation And swDaten.TransformReferenceEntity Is Nothing Then
        swDaten.TransformX = swDaten.TransformX + 0.02
        If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
    Else
        swDaten.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Werte: Setze MoveCopyBodyFeatureData.TransformType, bevor du MoveCopyBodyFeatureData.TransformX, MoveCopyBodyFeatureData.TransformY und MoveCopyBodyFeatureData.TransformZ setzt. Beim Verschieben sind diese Werte Wege in Metern, beim Drehen Winkel in Bogenmaß.

Bezug: MoveCopyBodyFeatureData.TransformReferenceEntity muss Nothing sein, wenn du über TransformX bis TransformZ verschiebst oder einen Drehpunkt mit MoveCopyBodyFeatureData.RotationOriginX bis MoveCopyBodyFeatureData.RotationOriginZ angibst. Zum Drehen über TransformX bis TransformZ muss er ein Eckpunkt sein. Das Hilfebeispiel „Copy and Rotate Body Using Edge“ dreht dagegen um eine Kante und setzt den Winkel mit TransformX. MoveCopyBodyFeatureData.TransformValue beschreibt die Hilfe als Weg oder Winkel anhand der ausgewählten Kante, ein Beispiel dazu gibt es nicht.

Ändern: Nach MoveCopyBodyFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du MoveCopyBodyFeatureData.ReleaseSelectionAccess auf. Mehrere Hilfebeispiele rufen nach ModifyDefinition zusätzlich ReleaseSelectionAccess auf, nach dem Hilfetext ist das eine oder das andere nötig. Neue Körper, Kanten oder Eckpunkte wählen die Hilfebeispiele erst nach AccessSelections aus und weisen sie den Eigenschaften ohne Set zu.

Hilfebeispiele: „Modify Move/Copy Body Using Vertex“ legt das Feature mit zwei Eckpunkten an und ändert dann das Ziel und den Weg. „Copy and Rotate Body Using Edge“ dreht um eine Kante, „Move and Copy Body by Setting Transforms“ verschiebt um feste Werte, „Change Number of Copies for Move/Copy“ ändert die Zahl der Kopien und „Set Bodies for Move/Copy“ setzt den Körper.

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
BodiesLiest oder setzt die Körper, die das Feature „Körper verschieben/kopieren“ verschiebt, dreht oder kopiert.
CopyLiest oder setzt, ob das Feature „Körper verschieben/kopieren“ die Körper kopiert.
NumberOfCopiesLiest oder setzt, wie viele Kopien das Feature „Körper verschieben/kopieren“ erzeugt.
RotationOriginXLiest oder setzt die X-Koordinate des Punkts, um den das Feature „Körper verschieben/kopieren“ die Körper dreht.
RotationOriginYLiest oder setzt die Y-Koordinate des Punkts, um den das Feature „Körper verschieben/kopieren“ die Körper dreht.
RotationOriginZLiest oder setzt die Z-Koordinate des Punkts, um den das Feature „Körper verschieben/kopieren“ die Körper dreht.
TransformReferenceEntityLiest oder setzt den Bezug, an dem das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht: Kante, Eckpunkt, Skizzenpunkt oder Koordinatensystem.
TransformTypeLiest oder setzt, ob das Feature „Körper verschieben/kopieren“ die Körper verschiebt, dreht oder gar nicht transformiert.
TransformValueLiest oder setzt den Weg oder Winkel, um den das Feature „Körper verschieben/kopieren“ die Körper anhand der ausgewählten Kante verschiebt oder dreht.
TransformXLiest oder setzt den Wert in X, um den das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht.
TransformYLiest oder setzt den Wert in Y, um den das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht.
TransformZLiest oder setzt den Wert in Z, um den das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht.
TranslateToVertexLiest oder setzt das Element, zu dem das Feature „Körper verschieben/kopieren“ die Körper verschiebt: Koordinatensystem, Skizzenpunkt oder Eckpunkt.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Körper verschieben/kopieren“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
AddMateFügt dem Feature „Körper verschieben/kopieren“ eine Verknüpfung hinzu.
GetBodiesCountLiefert die Zahl der Körper, die das Feature „Körper verschieben/kopieren“ verschiebt, dreht oder kopiert.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Körper verschieben/kopieren“ nicht geändert hast.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IAddMate). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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