SolidWorksMakroprogrammierung

Objekt · SldWorks

ReplaceFaceFeatureData-Objekt

Die Definition eines Features „Fläche ersetzen“: die Flächen, die ersetzt werden, und die Ersatzflächen.

Deklaration Dim x As SldWorks.ReplaceFaceFeatureData · in der englischen .NET-Hilfe: IReplaceFaceFeatureData

Beschreibung

ReplaceFaceFeatureData gibt Zugriff auf die Daten eines Features „Fläche ersetzen“ (Replace Face). Das Feature ersetzt Flächen eines Körpers durch andere Flächen, etwa durch einen Flächenkörper. Du liest und setzt die Flächen, die ersetzt werden, und die Ersatzflächen. Die Befehle gibt es seit SOLIDWORKS 2001Plus.

Zugriff

Beispiel

' Gibt aus, wie viele Flächen das ausgewählte Feature ersetzt, zu welchen Features
' sie gehören und wie viele Ersatzflächen es hat.
' Vorbedingung: Ein Teil mit einem Feature „Fläche ersetzen“ ist offen, das Feature
'               ist im FeatureManager ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.ReplaceFaceFeatureData
    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
    If swFeat.GetTypeName2 <> "ReplaceFace" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetFacesForReplacementCount & " Fläche(n) ersetzt, " & _
                swDaten.GetReplacementSurfacesCount & " Ersatzfläche(n)"
    vFlaechen = swDaten.FacesForReplacement
    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
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Ein neues Feature legst du mit ModelDoc2.InsertFeatureReplaceFace an. Vorher wählst du die Flächen, die ersetzt werden, mit der Markierung 1 aus und die Ersatzflächen mit 2. So macht es das Hilfebeispiel „Create Replace Face Feature“, das als Ersatz einen Flächenkörper auswählt.

Ändern: Nach ReplaceFaceFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du ReplaceFaceFeatureData.ReleaseSelectionAccess auf.

Mehr dazu: Für die Arrays verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
FacesForReplacementLiest oder setzt die Flächen, die das Feature „Fläche ersetzen“ ersetzt.
ReplacementSurfacesLiest oder setzt die Ersatzflächen des Features „Fläche ersetzen“.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Fläche ersetzen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetFacesForReplacementCountLiefert die Zahl der Flächen, die das Feature „Fläche ersetzen“ ersetzt.
GetReplacementSurfacesCountLiefert die Zahl der Ersatzflächen des Features „Fläche ersetzen“.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Fläche ersetzen“ nicht geändert hast.

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

Siehe auch

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

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