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 BooleanbErfolg = 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, 0heiß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) oderswSelVERTICES(Ecke). AppendBooleanByValFalsehebt die bisherige Auswahl auf,Truefügt hinzu, wie beiModelDocExtension.SelectByID2.MarkLongByVal- Eine Markierung für Befehle, die mehrere Auswahlen in bestimmten Rollen brauchen. Sonst
0. OptionLongByValswSelectOptionDefaultausswSelectOption_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 SubBemerkungen
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.