SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfacePlanarFeatureData-Objekt

Die Definition des Features „Planare Oberfläche“: die Elemente, die die ebene Fläche begrenzen.

Deklaration Dim x As SldWorks.SurfacePlanarFeatureData · in der englischen .NET-Hilfe: ISurfacePlanarFeatureData

Beschreibung

SurfacePlanarFeatureData gibt Zugriff auf ein Feature „Planare Oberfläche“. Es legt eine ebene Fläche an, die von einer geschlossenen ebenen Skizze oder von Kanten begrenzt wird. Die Befehle gibt es seit SOLIDWORKS 2001Plus SP01.

Zugriff

Beispiel

' Gibt Zahl und Art der Elemente aus, die das ausgewählte Feature
' „Planare Oberfläche“ begrenzen.
' Vorbedingung: Ein Teil mit einem Feature „Planare Oberfläche“ ist offen, das
'               Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G).
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.SurfacePlanarFeatureData
    Dim swEnt As SldWorks.Entity
    Dim vGrenze 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 <> "PlanarSurface" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetBoundingEntitiesCount & " begrenzende(s) Element(e)"
    vGrenze = swDaten.BoundingEntities
    If Not IsEmpty(vGrenze) Then
        For i = 0 To UBound(vGrenze)
            Set swEnt = vGrenze(i)
            Debug.Print "  Element " & i & ": Art " & swEnt.GetType   ' swSelectType_e
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Das Feature legst du mit ModelDoc2.InsertPlanarRefSurface an, nachdem du die Begrenzung mit der Markierung 1 ausgewählt hast. So macht es das Hilfebeispiel „Create Planar Surface Feature“, das zuvor auch eine Ausstrahlungsfläche anlegt und ausliest.

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

Elemente: Das Hilfebeispiel weist die begrenzenden Elemente einer Variablen vom Typ Entity zu und gibt ihre Art als Wert aus swSelectType_e aus.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
BoundingEntitiesLiest oder setzt die Elemente, die das Feature „Planare Oberfläche“ begrenzen.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Planare Oberfläche“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBoundingEntitiesCountLiefert die Zahl der Elemente, die das Feature „Planare Oberfläche“ begrenzen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Planare Oberfläche“ nicht geändert hast.

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

Siehe auch

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

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