SolidWorksMakroprogrammierung

Methode · ModelDocExtension

SelectByRay-Methode (ModelDocExtension)

Wählt die erste Fläche, Kante oder Ecke aus, die ein Strahl von einem Punkt aus in eine bestimmte Richtung trifft, unabhängig von der Ansicht.

Syntax

Function SelectByRay( _
   ByVal WorldX As Double, _
   ByVal WorldY As Double, _
   ByVal WorldZ As Double, _
   ByVal RayVecX As Double, _
   ByVal RayVecY As Double, _
   ByVal RayVecZ As Double, _
   ByVal RayRadius As Double, _
   ByVal TypeWanted As Long, _
   ByVal Append As Boolean, _
   ByVal Mark As Long, _
   ByVal Option As Long _
) As Boolean
bErfolg = swModel.Extension.SelectByRay(X, Y, Z, dX, dY, dZ, Radius, TypeWanted, Append, Mark, Option)

Parameter

WorldXDoubleByVal
X des Startpunkts in Metern, im Koordinatensystem des Modells.
WorldYDoubleByVal
Y des Startpunkts in Metern.
WorldZDoubleByVal
Z des Startpunkts in Metern.
RayVecXDoubleByVal
X der Richtung, in die der Strahl läuft. -1, 0, 0 heißt zum Beispiel „in Richtung minus X“.
RayVecYDoubleByVal
Y der Richtung.
RayVecZDoubleByVal
Z der Richtung.
RayRadiusDoubleByVal
Wie dick der Strahl ist, in Metern, höchstens 2,9 m. Hilft beim Treffen dünner Kanten und kleiner Ecken. Bei Flächen ignoriert SOLIDWORKS den Wert.
TypeWantedLongByVal
Was ausgewählt werden soll, ein Wert aus swSelectType_e: swSelFACES (Fläche), swSelEDGES (Kante) oder swSelVERTICES (Ecke).
AppendBooleanByVal
False hebt die bisherige Auswahl auf, True fügt hinzu, wie bei ModelDocExtension.SelectByID2.
MarkLongByVal
Eine Markierung für Befehle, die mehrere Auswahlen in bestimmten Rollen brauchen. Sonst 0.
OptionLongByVal
swSelectOptionDefault aus swSelectOption_e.

Rückgabewert

True, wenn etwas getroffen und ausgewählt wurde, sonst False.

Beispiel

' Schickt einen Strahl von x = 1 m in Richtung minus X und wählt die erste Fläche,
' die er trifft, zum Beispiel die rechte Stirnfläche einer Welle entlang der X-Achse.
' Vorbedingung: Ein Teil ist geöffnet, auf der X-Achse liegt ein Körper, kürzer als 1 m.
' Ergebnis:     Die getroffene Fläche ist ausgewählt.
Option Explicit

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

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

    If False = swModel.Extension.SelectByRay(1, 0, 0, -1, 0, 0, 0.001, swSelFACES, False, 0, swSelectOptionDefault) Then
        swApp.SendMsgToUser2 "Keine Fläche getroffen.", swMbWarning, swMbOk
    End If
End Sub

Bemerkungen

Der Strahl beginnt am Startpunkt und läuft unendlich weit in die angegebene Richtung. Ausgewählt wird nur das erste passende Objekt, das er trifft. Leg den Startpunkt deshalb außerhalb des Körpers. Liegt er innerhalb, trifft der Strahl zuerst die Fläche, durch die er den Körper wieder verlässt.

SelectByRay ist zuverlässiger als ModelDocExtension.SelectByID2 mit Koordinaten, weil die Richtung im Makro steht und nicht von der Ansicht abhängt. Deshalb zeichnet SOLIDWORKS beim Aufnehmen eines Makros oft SelectByRay statt SelectByID2 auf.

SelectByRay wählt nur Flächen, Kanten und Ecken aus. Skizzenelemente, Achsen oder Mittellinien gehen damit nicht. Der Vorgänger ModelDoc2.SelectByRay ist veraltet.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2017

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

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