Objekt · SldWorks
MoveFaceFeatureData-Objekt
Die Definition eines Features „Fläche verschieben“: die Flächen, die Art (versetzen, verschieben, drehen), Abstand, Winkel, Endbedingung, Richtungsreferenz und die Werte der Triade.
Beschreibung
MoveFaceFeatureData gibt Zugriff auf ein Feature „Fläche verschieben“ (Move Face). Das Feature versetzt Flächen eines Körpers um einen Abstand, verschiebt sie in eine Richtung oder dreht sie um eine Achse. Die meisten Befehle gibt es seit SOLIDWORKS 2007, die Werte der Triade seit 2010, die Befehle zur Endbedingung und zum Ausgangselement seit 2015.
Zugriff
Feature.GetDefinition: bei einem Feature „Fläche verschieben“. Den Typnamen ausFeature.GetTypeName2nennt die Hilfe nicht, ihre Beispiele wählen das Feature über seinen Namen aus.- Neu anlegen kannst du das Feature mit
FeatureManager.InsertMoveFace3.
Beispiel
' Gibt Art, Flächen und Abstand oder Winkel des ausgewählten Features „Fläche verschieben“
' aus. Versetzt das Feature Flächen, wird der Abstand um 1 mm größer.
' Vorbedingung: Ein Teil mit einem Feature „Fläche verschieben“ ist offen, das Feature ist
' im FeatureManager ausgewählt.
' Ergebnis: Die Angaben stehen im Direktfenster (Strg+G). Ein Feature, das Flächen
' versetzt, 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 swDef As Object
Dim swDaten As SldWorks.MoveFaceFeatureData
Dim swFace As SldWorks.Face2
Dim vFlaechen 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
Set swDef = swFeat.GetDefinition
If Not TypeOf swDef Is SldWorks.MoveFaceFeatureData Then Exit Sub
Set swDaten = swDef
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": " & swDaten.GetFacesCount & " Fläche(n), Richtung umgekehrt: " & swDaten.ReverseDirection
vFlaechen = swDaten.Faces
If IsArray(vFlaechen) Then
For i = 0 To UBound(vFlaechen)
Set swFace = vFlaechen(i)
Debug.Print " Fläche aus " & swFace.GetFeature.Name
Next i
End If
Select Case swDaten.MoveType
Case swMoveFaceTypeOffset
Debug.Print "Versetzen um " & swDaten.Distance * 1000# & " mm"
Case swMoveFaceTypeTranslate
If swDaten.EndCondition = swEndCondOffsetFromSurface Then
Debug.Print "Verschieben mit Abstand von Fläche " & swDaten.OffsetDistance * 1000# & " mm"
Else
Debug.Print "Verschieben, Endbedingung " & swDaten.EndCondition & ", Abstand " & swDaten.Distance * 1000# & " mm"
End If
Case swMoveFaceTypeRotate
Debug.Print "Drehen um " & swDaten.Angle * 180# / PI & " Grad"
End Select
If swDaten.MoveType = swMoveFaceTypeOffset Then
swDaten.Distance = swDaten.Distance + 0.001
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
Else
swDaten.ReleaseSelectionAccess
End If
End SubBemerkungen
Arten: Welche Werte gelten, hängt von MoveFaceFeatureData.MoveType ab:
swMoveFaceTypeOffset: Versetzen umMoveFaceFeatureData.Distance.swMoveFaceTypeTranslate: Verschieben in Richtung der Richtungsreferenz, mit einer Endbedingung ausMoveFaceFeatureData.EndCondition. Bei „Abstand von Fläche“ giltMoveFaceFeatureData.OffsetDistance, sonstMoveFaceFeatureData.Distance. Das Ziel bei den Endbedingungen „bis …“ liefertMoveFaceFeatureData.GetEndConditionEntity.swMoveFaceTypeRotate: Drehen um die Achse ausMoveFaceFeatureData.GetDirectionReferenceum den WinkelMoveFaceFeatureData.Angle.
Triade: Beim Anlegen mit FeatureManager.InsertMoveFace3 gibst du entweder Abstand bzw. Winkel oder die Werte der Triade an. Aus Abstand bzw. Winkel berechnet SOLIDWORKS die Werte der Triade selbst. Die Hilfebeispiele „Translate Move Face Feature“ und „Rotate Move Face Feature“ ändern ein vorhandenes Feature über MoveFaceFeatureData.TriadTranslationParameters und MoveFaceFeatureData.TriadRotationParameters.
Ändern: Nach MoveFaceFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du MoveFaceFeatureData.ReleaseSelectionAccess auf. Die Hilfebeispiele wählen neue Flächen und Kanten erst nach AccessSelections aus, also im zurückgesetzten Modell.
Einheiten: MoveFaceFeatureData.Angle ist in Bogenmaß. Die Abstände sind Meter, das Hilfebeispiel „Translate Move Face Feature“ rechnet sie mit dem Faktor 39,37 in Zoll um. Für die Werte der Triade nennt die Hilfe keine Einheit; die Verschiebung ist in Metern und die Drehwinkel sind im Bogenmaß.
Typname: Welchen Typnamen Feature.GetTypeName2 für dieses Feature liefert, sagt die Hilfe nicht. Das Beispiel oben prüft deshalb mit TypeOf, ob Feature.GetDefinition ein MoveFaceFeatureData liefert.
Eigenschaften und Methoden
Eigenschaften 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel, um den das Feature „Fläche verschieben“ die Flächen dreht. |
| Distance | Liest oder setzt den Abstand, um den das Feature „Fläche verschieben“ die Flächen versetzt oder verschiebt. |
| EndCondition | Liest oder setzt die Endbedingung, mit der das Feature „Fläche verschieben“ die Flächen verschiebt. |
| Faces | Liest oder setzt die Flächen, die das Feature „Fläche verschieben“ verschiebt. |
| MoveType | Liest oder setzt, ob das Feature „Fläche verschieben“ die Flächen versetzt, verschiebt oder dreht. |
| OffsetDistance | Liest oder setzt den Abstand von der Fläche, wenn das Feature „Fläche verschieben“ mit der Endbedingung „Abstand von Fläche“ verschiebt. |
| ReverseDirection | Liest oder setzt, ob das Feature „Fläche verschieben“ in die Gegenrichtung arbeitet. |
| TriadRotationParameters | Liest oder setzt Drehpunkt und Drehwinkel, mit denen das Feature „Fläche verschieben“ die Flächen über die Triade dreht. |
| TriadTranslationParameters | Liest oder setzt die Verschiebung in X, Y und Z, mit der das Feature „Fläche verschieben“ die Flächen über die Triade verschiebt. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Fläche verschieben“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetDirectionReference | Liefert die Richtungsreferenz des Features „Fläche verschieben“: die Richtung beim Verschieben oder die Achse beim Drehen. |
| GetEndConditionEntity | Liefert das Element, bis zu dem das Feature „Fläche verschieben“ die Flächen verschiebt. |
| GetFacesCount | Liefert die Zahl der Flächen, die das Feature „Fläche verschieben“ verschiebt. |
| GetFromEntity | Liefert das Element, von dem aus das Feature „Fläche verschieben“ die Flächen verschiebt, und die Endbedingung. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Fläche verschieben“ nicht geändert hast. |
| SetDirectionReference | Setzt die Richtungsreferenz des Features „Fläche verschieben“: die Richtung beim Verschieben oder die Achse beim Drehen. |
| SetEndConditionEntity | Setzt das Element, bis zu dem das Feature „Fläche verschieben“ die Flächen verschiebt. |
| SetFromEntity | Setzt das Element, von dem aus das Feature „Fläche verschieben“ die Flächen verschiebt. |
Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IGetFaces). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMoveFaceFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.