SolidWorksMakroprogrammierung

Objekt · SldWorks

SelectData-Objekt

Zusatzangaben für eine Auswahl per API: Markierung, Zeichenansicht, Auswahlpunkt und Tabellenzellen.

Deklaration Dim x As SldWorks.SelectData · in der englischen .NET-Hilfe: ISelectData

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

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 Sub

Bemerkungen

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

NameBeschreibung
CalloutLiefert oder ändert die Beschriftung (Callout), die an ein ausgewähltes Element angehängt wird.
MarkLiefert oder ändert die Markierung, die ein ausgewähltes Element in der Auswahlliste bekommt.
ViewLiefert oder ändert die Zeichenansicht, in der ein Element ausgewählt wird.
XLiefert oder ändert die X-Koordinate des Auswahlpunkts.
YLiefert oder ändert die Y-Koordinate des Auswahlpunkts.
ZLiefert oder ändert die Z-Koordinate des Auswahlpunkts.

Methoden 2, davon 2 beschrieben

NameBeschreibung
GetCellRangeLiefert den Bereich von Tabellenzellen, der für diese Auswahl eingestellt ist.
SetCellRangeLegt 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.