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.
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
- Jede Fläche (
Face2), Kante (Edge), jeder Eckpunkt (Vertex), jede Schleife (Loop2) und jedesFeature: mitSetan eine Variable vom TypSldWorks.Entityzuweisen SelectionMgr.GetSelectedObject6: ein ausgewähltes Element, direkt an eine Entity-Variable, wenn die Auswahl eine Fläche, Kante, ein Eckpunkt oder Feature istPartDoc.GetEntityByNameundPartDoc.GetNamedEntities: benannte Elemente eines TeilsAttribute.GetEntity: das Element, an dem ein Attribut hängtComponent2.GetCorrespondingEntity,ModelDocExtension.GetCorrespondingEntity2undView.GetCorrespondingEntity: das passende Element in einer Baugruppe oder ZeichenansichtView.GetVisibleEntities2: die sichtbaren Elemente einer Komponente in einer ZeichenansichtEntity.GetSafeEntity: der sichere Verweis auf ein Element
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ückBeispiel
' 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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| IsSafe | Die Hilfe sagt, die Eigenschaft liefere, ob das Element einen Neuaufbau überstanden hat, also vermutlich ein sicheres Entity ist. |
| ModelName | Liest oder setzt den Parasolid-Namen des Elements. |
Methoden 17, davon 14 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| CreateStringAttribute | Hängt einen Text als einfaches Attribut an das Element, zu einer Definition aus CreateStringAttributeDefinition. |
| CreateStringAttributeDefinition | Legt eine Definition für einfache Text-Attribute an und liefert ihre Nummer. |
| DeleteModelName | Löscht den Parasolid-Namen des Elements, den ModelName setzt. |
| DeSelect | Hebt die Auswahl des Elements auf. |
| FindAttribute | Sucht am Element ein Attribut einer bestimmten Definition. |
| FindStringAttribute | Liefert den Text eines einfachen Attributs am Element, zu einer Definition aus CreateStringAttributeDefinition. |
| GetComponent | Liefert die Komponente der Baugruppe, zu der das Element gehört. |
| GetDistance | Ermittelt den kleinsten oder größten Abstand zwischen diesem Element und einer anderen Fläche oder Kante. |
| GetDrawingComponent | Liefert die Zeichnungskomponente, zu der das Element in einer Zeichenansicht gehört. |
| GetSafeEntity | Liefert einen sicheren Verweis auf das Element, der auch nach einem Neuaufbau gültig bleibt. |
| GetType | Liefert, welche Art Element sich hinter dem Entity verbirgt, etwa Fläche, Kante oder Eckpunkt. |
| RemoveStringAttribute | Entfernt ein einfaches Text-Attribut vom Element, zu einer Definition aus CreateStringAttributeDefinition. |
| Select | veraltet ersetzt durch Entity.Select4 |
| Select2 | veraltet ersetzt durch Entity.Select4 |
| Select3 | veraltet ersetzt durch Entity.Select4 |
| Select4 | Wählt das Element aus und gibt ihm über SelectData eine Markierung und weitere Angaben mit. |
| SelectByMark | Wä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.