SolidWorksMakroprogrammierung

Methode · Entity

Select4-Methode (Entity)

Wählt das Element aus und gibt ihm über SelectData eine Markierung und weitere Angaben mit.

Syntax

Function Select4( _
   ByVal Append As Boolean, _
   ByVal Data As SelectData _
) As Boolean
bErfolg = swEnt.Select4(True, swSelData)

Parameter

AppendBooleanByVal
True hängt das Element an die vorhandene Auswahl an, False ersetzt die Auswahl durch das Element.
DataSelectDataByVal
Zusatzangaben (SelectData) wie Markierung und Zeichenansicht, oder Nothing.

Rückgabewert

True, wenn das Element ausgewählt ist, sonst False.

Beispiel

' swSelMgr ist der Auswahl-Manager (SelectionMgr), swFace eine Fläche (Face2).
Dim swEnt As SldWorks.Entity
Dim swSelData As SldWorks.SelectData
Set swSelData = swSelMgr.CreateSelectData
swSelData.Mark = 1
Set swEnt = swFace
If False = swEnt.Select4(False, swSelData) Then Debug.Print "Nicht ausgewählt."

Bemerkungen

Das Verhalten hängt davon ab, ob in SOLIDWORKS gerade ein Befehl mit PropertyManager und Auswahlliste läuft, etwa „Verrundung einfügen“:

  • Läuft ein solcher Befehl, hängt Select4 ein neues Element immer an die Auswahl an, Append wird übergangen. Ist das Element schon ausgewählt, wird es abgewählt.
  • Läuft kein Befehl, gilt Append wie beschrieben.

Das Element muss aus dem aktiven Dokument stammen. Ist eine Baugruppe aktiv, holst du es aus der Auswahl (SelectionMgr.GetSelectedObject6) oder über den Körper der Komponente (Component2.GetBody, dann etwa Body2.GetFirstFace), nicht aus dem Teildokument der Komponente.

Damit wählst du auch Features aus: Ein Feature weist du dazu einer Entity-Variable zu. In Zeichnungen gibst du mit SelectData.View die Zeichenansicht an. Select4 ersetzt die veralteten Befehle Select, Select2 und Select3.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2004

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

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