Objekt · SldWorks
SelectData-Objekt
Zusatzangaben für eine Auswahl per API: Markierung, Zeichenansicht, Auswahlpunkt und Tabellenzellen.
Beschreibung
Viele Auswahlbefehle wie Entity.Select4, Body2.Select2, Component2.Select4 oder ModelDocExtension.MultiSelect2 nehmen ein SelectData-Objekt an. Darin gibst du der Auswahl Angaben mit, die der Befehl selbst nicht als Parameter hat. Das wichtigste ist die Markierung (SelectData.Mark): Features wie Muster, Austragungen oder Verknüpfungen erkennen an ihr, welche Rolle ein ausgewähltes Element spielt.
Zugriff
SelectionMgr.CreateSelectData: ein neues, leeres SelectData-Objekt
Ein SelectData-Objekt kannst du für mehrere Auswahlen nacheinander verwenden. Ändere zwischendurch nur die Werte, die anders sein sollen.
Beispiel
' Wählt die ersten beiden Kanten des ersten Körpers mit Markierung 1 und 2 aus.
' Vorbedingung: Ein Teil mit mindestens einem Volumenkörper ist geöffnet.
' Ergebnis: Zwei ausgewählte Kanten, die Markierungen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swPart As SldWorks.PartDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swSelData As SldWorks.SelectData
Dim swBody As SldWorks.Body2
Dim swEnt As SldWorks.Entity
Dim vBodies As Variant, vEdges As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swPart = swModel
Set swSelMgr = swModel.SelectionManager
vBodies = swPart.GetBodies2(swSolidBody, True)
If IsEmpty(vBodies) Then Exit Sub
Set swBody = vBodies(0)
vEdges = swBody.GetEdges
If UBound(vEdges) < 1 Then Exit Sub
swModel.ClearSelection2 True
Set swSelData = swSelMgr.CreateSelectData
swSelData.Mark = 1
Set swEnt = vEdges(0)
swEnt.Select4 True, swSelData
swSelData.Mark = 2
Set swEnt = vEdges(1)
swEnt.Select4 True, swSelData
Debug.Print "Markierung 1. Auswahl: " & swSelMgr.GetSelectedObjectMark(1)
Debug.Print "Markierung 2. Auswahl: " & swSelMgr.GetSelectedObjectMark(2)
End SubBemerkungen
Welche Markierung ein Feature erwartet, steht in der Hilfe des jeweiligen Befehls, oft bei den Bemerkungen. Ohne SelectData wählen die Befehle mit Markierung 0 aus. Statt eines SelectData-Objekts übergibst du dann Nothing.
In Zeichnungen sagt SelectData.View, in welcher Ansicht ein Modellelement ausgewählt werden soll. Ohne diese Angabe weiß SOLIDWORKS nicht, welche der Ansichten gemeint ist, in denen die Kante zu sehen ist.
Eigenschaften und Methoden
Eigenschaften 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| Callout | Liefert oder ändert die Beschriftung (Callout), die an ein ausgewähltes Element angehängt wird. |
| Mark | Liefert oder ändert die Markierung, die ein ausgewähltes Element in der Auswahlliste bekommt. |
| View | Liefert oder ändert die Zeichenansicht, in der ein Element ausgewählt wird. |
| X | Liefert oder ändert die X-Koordinate des Auswahlpunkts. |
| Y | Liefert oder ändert die Y-Koordinate des Auswahlpunkts. |
| Z | Liefert oder ändert die Z-Koordinate des Auswahlpunkts. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| GetCellRange | Liefert den Bereich von Tabellenzellen, der für diese Auswahl eingestellt ist. |
| SetCellRange | Legt fest, welcher Bereich von Tabellenzellen ausgewählt wird. |
Siehe auch
Englisches Original: ISelectData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.