SolidWorksMakroprogrammierung

Objekt · SldWorks

Entity-Objekt

Die gemeinsame Schnittstelle von Fläche, Kante, Eckpunkt, Schleife und Feature: auswählen, Typ bestimmen, Attribute, sichere Verweise und Abstände.

Deklaration Dim x As SldWorks.Entity · in der englischen .NET-Hilfe: IEntity

Beschreibung

Ein Entity (Element) ist etwas, das du in SOLIDWORKS im Grafikbereich auswählen kannst, etwa ein Eckpunkt, eine Kante, eine Fläche oder ein Feature. Entity ist kein eigenes Ding im Modell, sondern eine zweite Schnittstelle dieser Objekte: Face2, Edge, Vertex, Loop2 und Feature sind zugleich Entity. Was alle gemeinsam haben, steht hier: auswählen, den Typ bestimmen, Attribute anhängen und suchen, einen Verweis über den Neuaufbau retten. Entity.GetType gibt es seit SOLIDWORKS 99, Entity.Select4 seit SOLIDWORKS 2004 und Entity.GetDistance seit SOLIDWORKS 2009 SP05.

Zugriff

Dazu kommen Eigenschaften von Feature-Daten, die Auswahlen liefern, etwa CoincidentMateFeatureData.EntitiesToMate oder SurfaceOffsetFeatureData.Entities.

In VBA wechselst du die Schnittstelle durch einfaches Zuweisen mit Set:

Dim swFace As SldWorks.Face2
Dim swEnt As SldWorks.Entity
Set swEnt = swFace        ' dieselbe Fläche, jetzt mit den Befehlen von Entity
Set swFace = swEnt        ' und zurück

Beispiel

' Wählt alle Kanten der ausgewählten Fläche mit Markierung 1 aus.
' Vorbedingung: In einem Teil oder einer Baugruppe ist eine Fläche ausgewählt.
' Ergebnis:     Die Kanten sind ausgewählt, ihre Zahl steht im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swSelData As SldWorks.SelectData
    Dim swFace As SldWorks.Face2
    Dim swEnt As SldWorks.Entity
    Dim vKanten As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then
        Debug.Print "Keine Fläche ausgewählt."
        Exit Sub
    End If
    Set swFace = swSelMgr.GetSelectedObject6(1, -1)

    ' Die Fläche ist zugleich Entity
    Set swEnt = swFace
    Debug.Print "Typ der Auswahl: " & swEnt.GetType & " (swSelFACES = " & swSelFACES & ")"

    vKanten = swFace.GetEdges
    If IsEmpty(vKanten) Then
        Debug.Print "Die Fläche hat keine Kanten."
        Exit Sub
    End If

    swModel.ClearSelection2 True
    Set swSelData = swSelMgr.CreateSelectData
    swSelData.Mark = 1
    For i = 0 To UBound(vKanten)
        Set swEnt = vKanten(i)          ' jede Kante ist zugleich Entity
        swEnt.Select4 True, swSelData
    Next i
    Debug.Print swSelMgr.GetSelectedObjectCount2(-1) & " Kanten ausgewählt."
End Sub

Bemerkungen

Welches Objekt dahintersteckt: Entity.GetType sagt dir, was die Entity-Variable enthält, etwa swSelFACES, swSelEDGES oder swSelVERTICES. Danach weist du sie mit Set einer Variable des passenden Typs zu, um dessen Befehle zu nutzen, etwa Face2.GetArea bei einer Fläche. Im Hilfebeispiel „Get Component from Feature“ liefert ein Feature swSelBODYFEATURES.

Auswählen: Entity.Select4 ersetzt die veralteten Befehle Select, Select2 und Select3. Die Markierung, die Zeichenansicht und den Auswahlpunkt gibst du über SelectData mit, ohne Zusatzangaben übergibst du Nothing. Das Element muss aus dem aktiven Dokument stammen: In einer Baugruppe holst du es aus der Auswahl oder über den Körper der Komponente (Component2.GetBody), nicht aus dem Teildokument der Komponente.

Gültigkeit: Ein Entity ist normalerweise nur bis zum nächsten Neuaufbau gültig, danach musst du es neu holen. Einen Verweis, der den Neuaufbau übersteht, liefert Entity.GetSafeEntity. Auch er gilt nicht über die SOLIDWORKS-Sitzung hinaus. Über Sitzungen hinaus findest du Elemente etwa über Namen (PartDoc.GetEntityByName) oder Attribute (Attribute).

Andere Elemente: Das Programmierhandbuch der Hilfe („Interface Inheritance“) nennt als Entity nur Fläche, Kante, Eckpunkt, Schleife und Feature. Komponenten, Körper, Skizzenelemente und Beschriftungen haben eigene Auswahlbefehle, etwa Component2.Select4, Body2.Select2, SketchSegment.Select4 oder Annotation.Select3. Auch der Kantenpunkt (EdgePoint) hat mit EdgePoint.Select einen eigenen.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
IsSafeDie Hilfe sagt, die Eigenschaft liefere, ob das Element einen Neuaufbau überstanden hat, also vermutlich ein sicheres Entity ist.
ModelNameLiest oder setzt den Parasolid-Namen des Elements.

Methoden 17, davon 14 beschrieben, 3 veraltet

NameBeschreibung
CreateStringAttributeHängt einen Text als einfaches Attribut an das Element, zu einer Definition aus CreateStringAttributeDefinition.
CreateStringAttributeDefinitionLegt eine Definition für einfache Text-Attribute an und liefert ihre Nummer.
DeleteModelNameLöscht den Parasolid-Namen des Elements, den ModelName setzt.
DeSelectHebt die Auswahl des Elements auf.
FindAttributeSucht am Element ein Attribut einer bestimmten Definition.
FindStringAttributeLiefert den Text eines einfachen Attributs am Element, zu einer Definition aus CreateStringAttributeDefinition.
GetComponentLiefert die Komponente der Baugruppe, zu der das Element gehört.
GetDistanceErmittelt den kleinsten oder größten Abstand zwischen diesem Element und einer anderen Fläche oder Kante.
GetDrawingComponentLiefert die Zeichnungskomponente, zu der das Element in einer Zeichenansicht gehört.
GetSafeEntityLiefert einen sicheren Verweis auf das Element, der auch nach einem Neuaufbau gültig bleibt.
GetTypeLiefert, welche Art Element sich hinter dem Entity verbirgt, etwa Fläche, Kante oder Eckpunkt.
RemoveStringAttributeEntfernt ein einfaches Text-Attribut vom Element, zu einer Definition aus CreateStringAttributeDefinition.
Selectveraltet ersetzt durch Entity.Select4
Select2veraltet ersetzt durch Entity.Select4
Select3veraltet ersetzt durch Entity.Select4
Select4Wählt das Element aus und gibt ihm über SelectData eine Markierung und weitere Angaben mit.
SelectByMarkWählt das Element aus und gibt ihm eine Markierung, ein älterer Befehl ohne SelectData.

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

Siehe auch

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

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