SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfaceExtendFeatureData-Objekt

Die Definition des Features „Oberfläche verlängern“: verlängerte Flächen und Kanten, Art der Verlängerung und Endbedingung.

Deklaration Dim x As SldWorks.SurfaceExtendFeatureData · in der englischen .NET-Hilfe: ISurfaceExtendFeatureData

Beschreibung

SurfaceExtendFeatureData gibt Zugriff auf ein Feature „Oberfläche verlängern“. Es verlängert Flächen oder Randkanten einer Oberfläche, entweder linear oder entlang der bestehenden Fläche. Wie weit, legt die Endbedingung fest: um einen Abstand, bis zu einem Punkt oder bis zu einer Fläche. Die Befehle gibt es seit SOLIDWORKS 2001Plus SP01.

Zugriff

Beispiel

' Gibt die Daten des ausgewählten Features „Oberfläche verlängern“ aus und
' vergrößert den Abstand um 5 mm, wenn die Endbedingung ein Abstand ist.
' Vorbedingung: Ein Teil mit einem Feature „Oberfläche verlängern“ ist offen,
'               das Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, der Abstand ist größer.
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.SurfaceExtendFeatureData

    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 <> "ExtendRefSurface" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": " & IIf(swDaten.Type = 0, "linear", "entlang der Fläche") & _
                ", " & swDaten.GetItemsCount & " Fläche(n)/Kante(n)"
    If swDaten.EndCondition <> swSurfaceExtendEndCondDistance Then Exit Sub
    Debug.Print "Abstand: " & swDaten.Distance * 1000 & " mm"

    If swDaten.AccessSelections(swModel, Nothing) Then
        swDaten.Distance = swDaten.Distance + 0.005
        If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Anlegen: Das Feature legst du mit ModelDoc2.InsertExtendSurface an, nachdem du die Flächen oder Kanten ausgewählt hast. Einen temporären verlängerten Körper ohne Feature liefert Body2.ExtendSurface.

Ändern: Nach SurfaceExtendFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SurfaceExtendFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Get Data for Surface-extend Feature“ liest nur Abstand und Art aus.

Einheiten: Für den Abstand nennt die Hilfe keine Einheit. Es sind Meter (0,01 verlängerte die Fläche um 10 mm).

Einen geänderten Abstand (SurfaceExtendFeatureData.Distance) übernimmt Feature.ModifyDefinition in SOLIDWORKS 2024 nicht: Das Feature behält den alten Abstand.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
DistanceLiest oder setzt, um wie viel das Feature „Oberfläche verlängern“ die Fläche verlängert.
EndConditionLiest oder setzt die Endbedingung des Features „Oberfläche verlängern“: Abstand, bis Punkt oder bis Fläche.
FaceLiest oder setzt die Fläche, bis zu der das Feature „Oberfläche verlängern“ verlängert.
ItemsLiest oder setzt die Flächen und Kanten, die das Feature „Oberfläche verlängern“ verlängert.
PropagatingEdgesLiest oder setzt die fortgesetzten Kanten des Features „Oberfläche verlängern“.
TypeLiest oder setzt, ob das Feature „Oberfläche verlängern“ linear oder entlang der bestehenden Fläche verlängert.
VertexLiest oder setzt den Punkt, bis zu dem das Feature „Oberfläche verlängern“ verlängert.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Oberfläche verlängern“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetItemsCountLiefert die Zahl der Flächen und Kanten, die das Feature „Oberfläche verlängern“ verlängert.
GetPropagatingEdgesCountLiefert die Zahl der fortgesetzten Kanten des Features „Oberfläche verlängern“.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Oberfläche verlängern“ nicht geändert hast.

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

Siehe auch

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

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