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.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenMoveCopyBody- Neu anlegen kannst du das Feature mit
FeatureManager.InsertMoveCopyBody2.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Bodies | Liest oder setzt die Körper, die das Feature „Körper verschieben/kopieren“ verschiebt, dreht oder kopiert. |
| Copy | Liest oder setzt, ob das Feature „Körper verschieben/kopieren“ die Körper kopiert. |
| NumberOfCopies | Liest oder setzt, wie viele Kopien das Feature „Körper verschieben/kopieren“ erzeugt. |
| RotationOriginX | Liest oder setzt die X-Koordinate des Punkts, um den das Feature „Körper verschieben/kopieren“ die Körper dreht. |
| RotationOriginY | Liest oder setzt die Y-Koordinate des Punkts, um den das Feature „Körper verschieben/kopieren“ die Körper dreht. |
| RotationOriginZ | Liest oder setzt die Z-Koordinate des Punkts, um den das Feature „Körper verschieben/kopieren“ die Körper dreht. |
| TransformReferenceEntity | Liest oder setzt den Bezug, an dem das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht: Kante, Eckpunkt, Skizzenpunkt oder Koordinatensystem. |
| TransformType | Liest oder setzt, ob das Feature „Körper verschieben/kopieren“ die Körper verschiebt, dreht oder gar nicht transformiert. |
| TransformValue | Liest 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. |
| TransformX | Liest oder setzt den Wert in X, um den das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht. |
| TransformY | Liest oder setzt den Wert in Y, um den das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht. |
| TransformZ | Liest oder setzt den Wert in Z, um den das Feature „Körper verschieben/kopieren“ die Körper verschiebt oder dreht. |
| TranslateToVertex | Liest 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
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Körper verschieben/kopieren“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| AddMate | Fügt dem Feature „Körper verschieben/kopieren“ eine Verknüpfung hinzu. |
| GetBodiesCount | Liefert die Zahl der Körper, die das Feature „Körper verschieben/kopieren“ verschiebt, dreht oder kopiert. |
| ReleaseSelectionAccess | Hebt 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.