Methode · ModelDoc2
ClearSelection2-Methode (ModelDoc2)
Hebt die Auswahl im Dokument auf.
Syntax
Sub ClearSelection2( _
ByVal All As Boolean _
)swModel.ClearSelection2 TrueParameter
AllBooleanByValTruehebt die gesamte Auswahl auf.Falseleert nur das gerade aktive Auswahlfeld eines offenen PropertyManagers. Ist kein PropertyManager mit Auswahlfeld offen, wirkt auchFalsewieTrue.
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 SubBemerkungen
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.