SolidWorksMakroprogrammierung

Methode · ModelDoc2

ClearSelection2-Methode (ModelDoc2)

Hebt die Auswahl im Dokument auf.

Syntax

Sub ClearSelection2( _
   ByVal All As Boolean _
)
swModel.ClearSelection2 True

Parameter

AllBooleanByVal
True hebt die gesamte Auswahl auf. False leert nur das gerade aktive Auswahlfeld eines offenen PropertyManagers. Ist kein PropertyManager mit Auswahlfeld offen, wirkt auch False wie True.

Beispiel

' Zeigt, wie viele Objekte ausgewählt sind, und hebt die Auswahl dann auf.
' Vorbedingung: Ein Dokument ist geöffnet, etwas ist ausgewählt.
' Ergebnis:     Meldung mit der Anzahl, danach ist nichts mehr ausgewählt.
Option Explicit

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

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

    Set swSelMgr = swModel.SelectionManager
    swApp.SendMsgToUser2 swSelMgr.GetSelectedObjectCount2(-1) & " Objekte ausgewählt, die Auswahl wird aufgehoben.", swMbInformation, swMbOk
    swModel.ClearSelection2 True
End Sub

Bemerkungen

ClearSelection2 ist ein Sub: Du rufst es ohne Klammern auf und bekommst nichts zurück.

Bevor ein Makro selbst etwas auswählt, ist ein ClearSelection2 True oft sinnvoll. Sonst bleibt ausgewählt, was der Benutzer vorher angeklickt hat, und das Makro arbeitet mit einer größeren Auswahl als gedacht. Bei ModelDocExtension.SelectByID2 mit Append = False ist das nicht nötig: Dort ersetzt die neue Auswahl die alte ohnehin.

Der ältere Befehl ModelDoc2.ClearSelection ohne Parameter ist veraltet.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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