Objekt · SldWorks
MagneticLine-Objekt
Eine magnetische Linie auf einem Zeichenblatt, an der sich Notizen wie Positionsnummern (Ballons) in einer Reihe ausrichten: Lage, Länge, Winkel, gleiche Abstände und die angehängten Notizen.
Beschreibung
MagneticLine gibt Zugriff auf eine magnetische Linie. Das ist eine Linie auf dem Zeichenblatt, an die du Notizen hängst, etwa Positionsnummern (Ballons). Sie richten sich dann auf der Linie aus, mit gleichen Abständen oder an frei gewählten Stellen. Die Befehle gibt es seit SOLIDWORKS 2012.
Zugriff
Sheet.InsertMagneticLine: fügt eine neue magnetische Linie zwischen zwei Punkten auf dem Blatt einSheet.GetMagneticLinesundSheet.GetMagneticLinesCount: die magnetischen Linien eines Blatts
Beim automatischen Einfügen von Positionsnummern legt AutoBalloonOptions.InsertMagneticLine fest, ob dabei magnetische Linien entstehen.
Beispiel
' Fügt auf dem aktiven Blatt eine magnetische Linie ein, schaltet gleiche
' Abstände ein und hängt die beiden ausgewählten Notizen an.
' Vorbedingung: Eine Zeichnung ist offen. Zwei Notizen, etwa Positionsnummern,
' derselben Zeichenansicht sind ausgewählt.
' Ergebnis: Die Notizen stehen auf der Linie. Das Direktfenster zeigt
' Anzahl, Länge und Winkel.
Option Explicit
Sub main()
Const PI As Double = 3.14159265358979
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swZeichnung As SldWorks.DrawingDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swMathUtil As SldWorks.MathUtility
Dim swBlatt As SldWorks.Sheet
Dim swLinie As SldWorks.MagneticLine
Dim swNotiz As SldWorks.Note
Dim dStart(2) As Double, dEnde(2) As Double
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swZeichnung = swModel
Set swSelMgr = swModel.SelectionManager
Set swMathUtil = swApp.GetMathUtility
Set swBlatt = swZeichnung.GetCurrentSheet
' Blattkoordinaten in Meter
dStart(0) = 0.05: dStart(1) = 0.05
dEnde(0) = 0.2: dEnde(1) = 0.05
Set swLinie = swBlatt.InsertMagneticLine(swMathUtil.CreatePoint(dStart), _
swMathUtil.CreatePoint(dEnde))
If swLinie Is Nothing Then Exit Sub
swLinie.EqualSpacing = True
For i = 1 To swSelMgr.GetSelectedObjectCount2(-1)
If swSelMgr.GetSelectedObjectType3(i, -1) = swSelNOTES Then
Set swNotiz = swSelMgr.GetSelectedObject6(i, -1)
' Position wird bei EqualSpacing = True nicht beachtet
If False = swLinie.AddNote(swNotiz, 0) Then Debug.Print "Notiz " & i & " nicht angehängt"
End If
Next i
Debug.Print "Notizen an der Linie: " & swLinie.GetNotesCount
Debug.Print "Länge: " & swLinie.Length * 1000 & " mm"
Debug.Print "Winkel: " & swLinie.Angle * 180 / PI & "°"
End SubBemerkungen
Eine Ansicht je Linie: Alle Notizen an einer magnetischen Linie müssen aus derselben Zeichenansicht stammen. Im Hilfebeispiel „Insert Magnetic Line“ liefert MagneticLine.AddNote für eine Notiz aus einer anderen Ansicht False.
Lage der Notizen: Ist MagneticLine.EqualSpacing True, verteilt die Linie die Notizen mit gleichen Abständen, und AddNote beachtet den Parameter Position nicht. Ist es False, gibt Position die Stelle auf der Linie an, von 0 bis 1.
Einheiten: MagneticLine.Length ist in Meter, MagneticLine.Angle in Bogenmaß zur Waagerechten. Für Anfangs- und Endpunkt nennt die Hilfe keine Einheit. Das Hilfebeispiel gibt sie als Blattkoordinaten in Meter an; das gilt auch für MagneticLine.StartPoint und MagneticLine.EndPoint.
Einfache Notizen aus ModelDoc2.InsertNote nimmt MagneticLine.AddNote nicht an und liefert False, auch wenn sie zur selben Ansicht gehören. Stücklisten-Positionsnummern nimmt es an.
Eigenschaften und Methoden
Eigenschaften 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel der magnetischen Linie zur Waagerechten. |
| EndPoint | Liest oder setzt den Endpunkt der magnetischen Linie. |
| EqualSpacing | Liest oder setzt, ob die Notizen auf der magnetischen Linie mit gleichen Abständen verteilt werden. |
| Length | Liest oder setzt die Länge der magnetischen Linie. |
| StartPoint | Liest oder setzt den Anfangspunkt der magnetischen Linie. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AddNote | Hängt eine Notiz an der angegebenen Stelle an die magnetische Linie. |
| GetNotes | Liefert die Notizen, die an der magnetischen Linie hängen. |
| GetNotesCount | Liefert die Zahl der Notizen, die an der magnetischen Linie hängen. |
| RemoveNote | Löst eine Notiz von der magnetischen Linie und setzt sie an die angegebene Stelle. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetNotes). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMagneticLine in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.