Objekt · SldWorks
SelectionMgr-Objekt
Gibt Auskunft über die aktuelle Auswahl im Dokument: wie viele Objekte, welcher Art, und liefert die ausgewählten Objekte selbst.
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
ModelDoc2.SelectionManager: der SelectionMgr eines Dokuments
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| EnableContourSelection | Schaltet die Konturauswahl in Skizzen ein oder aus. |
| EnableSelection | Schaltet das Auswählen ein oder aus. |
| SelectionColor | Liefert oder setzt die Farbe, in der Objekte mit einer bestimmten Markierung ausgewählt erscheinen. |
Methoden 47, davon 27 beschrieben, 20 veraltet
| Name | Beschreibung |
|---|---|
| AddSelectionListObject | Nimmt ein Objekt in die Auswahlliste auf, ohne es in der Oberfläche auszuwählen. |
| AddSelectionListObjects | Nimmt mehrere Objekte in die Auswahlliste auf, ohne sie in der Oberfläche auszuwählen. |
| ClearSelectionColors | Setzt alle mit SelectionColor vergebenen Auswahlfarben zurück. |
| CreateCallout | veraltet ersetzt durch SelectionMgr.CreateCallout2 |
| CreateCallout2 | Legt eine Beschriftung (Callout) mit mehreren Zeilen für ausgewählte Objekte an. |
| CreateSelectData | Legt ein SelectData-Objekt an, mit dem du beim Auswählen eine Markierung mitgibst. |
| DeSelect | veraltet ersetzt durch SelectionMgr.DeSelect2 |
| DeSelect2 | Hebt die Auswahl eines oder mehrerer Objekte in der Auswahlliste auf. |
| GetPreSelectedObject | Liefert das vorgewählte Objekt, also das unter dem Mauszeiger, während das Ereignis für die Vorauswahl läuft. |
| GetSelectByIdSpecification | Liefert zu einem Objekt Name und Typ, wie SelectByID2 sie erwartet. |
| GetSelectedCoordSysElement | Liefert ein ausgewähltes Element eines Koordinatensystems, etwa eine Achse. |
| GetSelectedObject | veraltet ersetzt durch SelectionMgr.GetSelectedObject6 |
| GetSelectedObject2 | veraltet ersetzt durch SelectionMgr.GetSelectedObject6 |
| GetSelectedObject3 | veraltet ersetzt durch SelectionMgr.GetSelectedObject6 |
| GetSelectedObject4 | veraltet ersetzt durch SelectionMgr.GetSelectedObject6 |
| GetSelectedObject5 | veraltet ersetzt durch SelectionMgr.GetSelectedObject6 |
| GetSelectedObject6 | Liefert ein ausgewähltes Objekt selbst, zum Beispiel eine Fläche, eine Kante oder ein Feature, damit das Makro damit weiterarbeiten kann. |
| GetSelectedObjectCount | veraltet ersetzt durch SelectionMgr.GetSelectedObjectCount2 |
| GetSelectedObjectCount2 | Liefert, wie viele Objekte im Dokument ausgewählt sind. |
| GetSelectedObjectLoop | veraltet ersetzt durch SelectionMgr.GetSelectedObjectLoop2 |
| GetSelectedObjectLoop2 | Liefert die Schleife zu einer ausgewählten Kante, wenn die ganze Schleife ausgewählt ist. |
| GetSelectedObjectMark | Liefert die Markierung eines ausgewählten Objekts. |
| GetSelectedObjectsComponent | veraltet ersetzt durch SelectionMgr.GetSelectedObjectsComponent4 |
| GetSelectedObjectsComponent2 | veraltet ersetzt durch SelectionMgr.GetSelectedObjectsComponent4 |
| GetSelectedObjectsComponent3 | veraltet ersetzt durch SelectionMgr.GetSelectedObjectsComponent4 |
| GetSelectedObjectsComponent4 | Liefert die Komponente, zu der ein ausgewähltes Objekt gehört, in einer Baugruppe oder Zeichnung. |
| GetSelectedObjectsDrawingView | veraltet ersetzt durch SelectionMgr.GetSelectedObjectsDrawingView2 |
| GetSelectedObjectsDrawingView2 | Liefert die Zeichenansicht, in der ein ausgewähltes Objekt liegt. |
| GetSelectedObjectsFace | Liefert die Fläche zu einer ausgewählten Silhouettenkante. |
| GetSelectedObjectType | veraltet ersetzt durch SelectionMgr.GetSelectedObjectType3 |
| GetSelectedObjectType2 | veraltet ersetzt durch SelectionMgr.GetSelectedObjectType3 |
| GetSelectedObjectType3 | Liefert, welcher Art ein ausgewähltes Objekt ist, zum Beispiel Fläche, Kante, Ecke oder Feature. |
| GetSelectionPoint | veraltet ersetzt durch SelectionMgr.GetSelectionPoint2 |
| GetSelectionPoint2 | Liefert den Punkt, an dem ein Objekt ausgewählt wurde, in Modellkoordinaten. |
| GetSelectionPointInSketchSpace | veraltet ersetzt durch SelectionMgr.GetSelectionPointInSketchSpace2 |
| GetSelectionPointInSketchSpace2 | Liefert den Klickpunkt projiziert auf die aktive Skizze, in Skizzenkoordinaten. |
| GetSelectionSpecification | Liefert zu einem Eintrag der Auswahlliste Name, Typ und Koordinaten, wie SelectByID2 sie erwartet. |
| IsCoordSysElementSelected | Liefert, ob die Auswahl ein Element eines Koordinatensystems ist. |
| IsInEditTarget | veraltet ersetzt durch SelectionMgr.IsInEditTarget2 |
| IsInEditTarget2 | Liefert, ob ein ausgewähltes Objekt zu dem Teil gehört, das gerade im Kontext der Baugruppe bearbeitet wird. |
| ResumeSelectionList | veraltet ersetzt durch SelectionMgr.ResumeSelectionList2 |
| ResumeSelectionList2 | Holt die mit SuspendSelectionList beiseitegelegte Auswahlliste zurück. |
| SetCallout | Hängt eine Beschriftung (Callout) an ein ausgewähltes Objekt. |
| SetSelectedObjectMark | Setzt, ergänzt oder entfernt die Markierung eines ausgewählten Objekts. |
| SetSelectionPoint | veraltet ersetzt durch SelectionMgr.SetSelectionPoint2 |
| SetSelectionPoint2 | Setzt den Auswahlpunkt eines ausgewählten Objekts in Modellkoordinaten. |
| SuspendSelectionList | Legt 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.