SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.MoveFaceFeatureData · in der englischen .NET-Hilfe: IMoveFaceFeatureData

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

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 Sub

Bemerkungen

Arten: Welche Werte gelten, hängt von MoveFaceFeatureData.MoveType ab:

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

NameBeschreibung
AngleLiest oder setzt den Winkel, um den das Feature „Fläche verschieben“ die Flächen dreht.
DistanceLiest oder setzt den Abstand, um den das Feature „Fläche verschieben“ die Flächen versetzt oder verschiebt.
EndConditionLiest oder setzt die Endbedingung, mit der das Feature „Fläche verschieben“ die Flächen verschiebt.
FacesLiest oder setzt die Flächen, die das Feature „Fläche verschieben“ verschiebt.
MoveTypeLiest oder setzt, ob das Feature „Fläche verschieben“ die Flächen versetzt, verschiebt oder dreht.
OffsetDistanceLiest oder setzt den Abstand von der Fläche, wenn das Feature „Fläche verschieben“ mit der Endbedingung „Abstand von Fläche“ verschiebt.
ReverseDirectionLiest oder setzt, ob das Feature „Fläche verschieben“ in die Gegenrichtung arbeitet.
TriadRotationParametersLiest oder setzt Drehpunkt und Drehwinkel, mit denen das Feature „Fläche verschieben“ die Flächen über die Triade dreht.
TriadTranslationParametersLiest 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

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Fläche verschieben“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetDirectionReferenceLiefert die Richtungsreferenz des Features „Fläche verschieben“: die Richtung beim Verschieben oder die Achse beim Drehen.
GetEndConditionEntityLiefert das Element, bis zu dem das Feature „Fläche verschieben“ die Flächen verschiebt.
GetFacesCountLiefert die Zahl der Flächen, die das Feature „Fläche verschieben“ verschiebt.
GetFromEntityLiefert das Element, von dem aus das Feature „Fläche verschieben“ die Flächen verschiebt, und die Endbedingung.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Fläche verschieben“ nicht geändert hast.
SetDirectionReferenceSetzt die Richtungsreferenz des Features „Fläche verschieben“: die Richtung beim Verschieben oder die Achse beim Drehen.
SetEndConditionEntitySetzt das Element, bis zu dem das Feature „Fläche verschieben“ die Flächen verschiebt.
SetFromEntitySetzt 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.