SolidWorksMakroprogrammierung

Objekt · SldWorks

SelectionMgr-Objekt

Gibt Auskunft über die aktuelle Auswahl im Dokument: wie viele Objekte, welcher Art, und liefert die ausgewählten Objekte selbst.

Deklaration Dim x As SldWorks.SelectionMgr · in der englischen .NET-Hilfe: ISelectionMgr

Beschreibung

Der SelectionMgr ist die Verbindung zwischen dem, was der Benutzer in SOLIDWORKS anklickt, und dem Makro. Viele Makros arbeiten so: Der Benutzer wählt Flächen, Kanten oder Features aus, startet das Makro, und das Makro holt sich die Auswahl über den SelectionMgr.

Zugriff

Beispiel

' Zeigt Name und Typ des Features, das im FeatureManager ausgewählt ist.
' Vorbedingung: Ein Teil ist geöffnet, im FeatureManager ist ein Feature
'               wie eine Extrusion ausgewählt.
' Ergebnis:     Meldung mit Name und Typ.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager

    If swSelMgr.GetSelectedObjectCount2(-1) = 0 Then
        swApp.SendMsgToUser2 "Bitte zuerst ein Feature auswählen.", swMbWarning, swMbOk
        Exit Sub
    End If
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then
        swApp.SendMsgToUser2 "Das ausgewählte Objekt ist kein Feature.", swMbWarning, swMbOk
        Exit Sub
    End If

    Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
    swApp.SendMsgToUser2 "Name: " & swFeat.Name & vbCrLf & "Typ: " & swFeat.GetTypeName2, swMbInformation, swMbOk
End Sub

Bemerkungen

Die Auswahl zählt ab 1: Das erste ausgewählte Objekt hat den Index 1, das letzte den Index GetSelectedObjectCount2(-1). Der Wert -1 für Mark heißt in allen drei Befehlen „alle ausgewählten Objekte, egal mit welcher Markierung“.

Prüfe immer erst Anzahl und Art, bevor du ein Objekt holst und einer Variable mit festem Typ zuweist. Passt der Typ nicht, bricht VBA mit Laufzeitfehler 13 ab („Typen unverträglich“).

Der SelectionMgr wird ungültig, sobald eine neue Auswahl getroffen wird. Hol ihn dir deshalb dort, wo du ihn brauchst, und nicht einmal am Anfang eines langen Makros.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
EnableContourSelectionSchaltet die Konturauswahl in Skizzen ein oder aus.
EnableSelectionSchaltet das Auswählen ein oder aus.
SelectionColorLiefert oder setzt die Farbe, in der Objekte mit einer bestimmten Markierung ausgewählt erscheinen.

Methoden 47, davon 27 beschrieben, 20 veraltet

NameBeschreibung
AddSelectionListObjectNimmt ein Objekt in die Auswahlliste auf, ohne es in der Oberfläche auszuwählen.
AddSelectionListObjectsNimmt mehrere Objekte in die Auswahlliste auf, ohne sie in der Oberfläche auszuwählen.
ClearSelectionColorsSetzt alle mit SelectionColor vergebenen Auswahlfarben zurück.
CreateCalloutveraltet ersetzt durch SelectionMgr.CreateCallout2
CreateCallout2Legt eine Beschriftung (Callout) mit mehreren Zeilen für ausgewählte Objekte an.
CreateSelectDataLegt ein SelectData-Objekt an, mit dem du beim Auswählen eine Markierung mitgibst.
DeSelectveraltet ersetzt durch SelectionMgr.DeSelect2
DeSelect2Hebt die Auswahl eines oder mehrerer Objekte in der Auswahlliste auf.
GetPreSelectedObjectLiefert das vorgewählte Objekt, also das unter dem Mauszeiger, während das Ereignis für die Vorauswahl läuft.
GetSelectByIdSpecificationLiefert zu einem Objekt Name und Typ, wie SelectByID2 sie erwartet.
GetSelectedCoordSysElementLiefert ein ausgewähltes Element eines Koordinatensystems, etwa eine Achse.
GetSelectedObjectveraltet ersetzt durch SelectionMgr.GetSelectedObject6
GetSelectedObject2veraltet ersetzt durch SelectionMgr.GetSelectedObject6
GetSelectedObject3veraltet ersetzt durch SelectionMgr.GetSelectedObject6
GetSelectedObject4veraltet ersetzt durch SelectionMgr.GetSelectedObject6
GetSelectedObject5veraltet ersetzt durch SelectionMgr.GetSelectedObject6
GetSelectedObject6Liefert ein ausgewähltes Objekt selbst, zum Beispiel eine Fläche, eine Kante oder ein Feature, damit das Makro damit weiterarbeiten kann.
GetSelectedObjectCountveraltet ersetzt durch SelectionMgr.GetSelectedObjectCount2
GetSelectedObjectCount2Liefert, wie viele Objekte im Dokument ausgewählt sind.
GetSelectedObjectLoopveraltet ersetzt durch SelectionMgr.GetSelectedObjectLoop2
GetSelectedObjectLoop2Liefert die Schleife zu einer ausgewählten Kante, wenn die ganze Schleife ausgewählt ist.
GetSelectedObjectMarkLiefert die Markierung eines ausgewählten Objekts.
GetSelectedObjectsComponentveraltet ersetzt durch SelectionMgr.GetSelectedObjectsComponent4
GetSelectedObjectsComponent2veraltet ersetzt durch SelectionMgr.GetSelectedObjectsComponent4
GetSelectedObjectsComponent3veraltet ersetzt durch SelectionMgr.GetSelectedObjectsComponent4
GetSelectedObjectsComponent4Liefert die Komponente, zu der ein ausgewähltes Objekt gehört, in einer Baugruppe oder Zeichnung.
GetSelectedObjectsDrawingViewveraltet ersetzt durch SelectionMgr.GetSelectedObjectsDrawingView2
GetSelectedObjectsDrawingView2Liefert die Zeichenansicht, in der ein ausgewähltes Objekt liegt.
GetSelectedObjectsFaceLiefert die Fläche zu einer ausgewählten Silhouettenkante.
GetSelectedObjectTypeveraltet ersetzt durch SelectionMgr.GetSelectedObjectType3
GetSelectedObjectType2veraltet ersetzt durch SelectionMgr.GetSelectedObjectType3
GetSelectedObjectType3Liefert, welcher Art ein ausgewähltes Objekt ist, zum Beispiel Fläche, Kante, Ecke oder Feature.
GetSelectionPointveraltet ersetzt durch SelectionMgr.GetSelectionPoint2
GetSelectionPoint2Liefert den Punkt, an dem ein Objekt ausgewählt wurde, in Modellkoordinaten.
GetSelectionPointInSketchSpaceveraltet ersetzt durch SelectionMgr.GetSelectionPointInSketchSpace2
GetSelectionPointInSketchSpace2Liefert den Klickpunkt projiziert auf die aktive Skizze, in Skizzenkoordinaten.
GetSelectionSpecificationLiefert zu einem Eintrag der Auswahlliste Name, Typ und Koordinaten, wie SelectByID2 sie erwartet.
IsCoordSysElementSelectedLiefert, ob die Auswahl ein Element eines Koordinatensystems ist.
IsInEditTargetveraltet ersetzt durch SelectionMgr.IsInEditTarget2
IsInEditTarget2Liefert, ob ein ausgewähltes Objekt zu dem Teil gehört, das gerade im Kontext der Baugruppe bearbeitet wird.
ResumeSelectionListveraltet ersetzt durch SelectionMgr.ResumeSelectionList2
ResumeSelectionList2Holt die mit SuspendSelectionList beiseitegelegte Auswahlliste zurück.
SetCalloutHängt eine Beschriftung (Callout) an ein ausgewähltes Objekt.
SetSelectedObjectMarkSetzt, ergänzt oder entfernt die Markierung eines ausgewählten Objekts.
SetSelectionPointveraltet ersetzt durch SelectionMgr.SetSelectionPoint2
SetSelectionPoint2Setzt den Auswahlpunkt eines ausgewählten Objekts in Modellkoordinaten.
SuspendSelectionListLegt die aktuelle Auswahlliste beiseite und beginnt eine neue, leere.

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

Siehe auch

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

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