SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.MagneticLine · in der englischen .NET-Hilfe: IMagneticLine

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngleLiest oder setzt den Winkel der magnetischen Linie zur Waagerechten.
EndPointLiest oder setzt den Endpunkt der magnetischen Linie.
EqualSpacingLiest oder setzt, ob die Notizen auf der magnetischen Linie mit gleichen Abständen verteilt werden.
LengthLiest oder setzt die Länge der magnetischen Linie.
StartPointLiest oder setzt den Anfangspunkt der magnetischen Linie.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AddNoteHängt eine Notiz an der angegebenen Stelle an die magnetische Linie.
GetNotesLiefert die Notizen, die an der magnetischen Linie hängen.
GetNotesCountLiefert die Zahl der Notizen, die an der magnetischen Linie hängen.
RemoveNoteLö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.