SolidWorksMakroprogrammierung

Objekt · SldWorks

DetailCircle-Objekt

Der Detailkreis einer Detailansicht in einer Zeichnung: Beschriftung, Name, Stil, Kreis oder Profil, Umriss, Lage, Größe, Layer und Textformat.

Deklaration Dim x As SldWorks.DetailCircle · in der englischen .NET-Hilfe: IDetailCircle

Beschreibung

DetailCircle gibt Zugriff auf einen Detailkreis. Der Detailkreis liegt in einer Zeichenansicht, der Ausgangsansicht, und begrenzt den Ausschnitt, den die zugehörige Detailansicht vergrößert zeigt. Er ist ein Kreis oder ein Skizzenprofil und trägt eine Beschriftung, etwa „A“, die auch die Detailansicht kennzeichnet. Die Grundbefehle gibt es seit SOLIDWORKS 2001. Die Setzbefehle für Stil, Anzeige, Beschriftung und Name kamen mit SOLIDWORKS 2004 SP01, die Befehle für den Umriss der Detailansicht (DetailCircle.NoOutline, DetailCircle.JaggedOutline, DetailCircle.ShapeIntensity) mit SOLIDWORKS 2017.

Zugriff

Beispiel

' Gibt Beschriftung, Name, Stil, Anzeige, Umriss und Detailansicht aller
' Detailkreise der ausgewählten Zeichenansicht aus.
' Vorbedingung: Eine Zeichnung ist offen. Eine Zeichenansicht mit mindestens
'               einem Detailkreis ist ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swView As SldWorks.View
    Dim swDetailkreis As SldWorks.DetailCircle
    Dim swDetailansicht As SldWorks.View
    Dim vKreise As Variant
    Dim dX As Double
    Dim dY 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 swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelDRAWINGVIEWS Then
        Debug.Print "Bitte eine Zeichenansicht auswählen."
        Exit Sub
    End If
    Set swView = swSelMgr.GetSelectedObject6(1, -1)

    vKreise = swView.GetDetailCircles
    If Not IsArray(vKreise) Then
        Debug.Print swView.GetName2 & " hat keine Detailkreise."
        Exit Sub
    End If

    For i = 0 To UBound(vKreise)
        Set swDetailkreis = vKreise(i)
        Set swDetailansicht = swDetailkreis.GetDetailView
        swDetailkreis.GetLabelPosition dX, dY
        Debug.Print swDetailkreis.GetName & ", Beschriftung " & swDetailkreis.GetLabel
        Debug.Print "  Detailansicht:  " & swDetailansicht.GetName2
        Debug.Print "  Stil:           " & swDetailkreis.GetStyle      ' swDetViewStyle_e
        Debug.Print "  Anzeige:        " & swDetailkreis.GetDisplay    ' swDetCircleShowType_e
        Debug.Print "  Beschriftung bei " & dX * 1000# & ", " & dY * 1000# & " (vermutlich mm)"
        Debug.Print "  Profilsegmente: " & swDetailkreis.GetProfileItemsCount
        Debug.Print "  Layer:          " & swDetailkreis.Layer
        If swDetailkreis.NoOutline Then
            Debug.Print "  Umriss:         keiner"
        Else
            Debug.Print "  Umriss:         vollständig " & swDetailkreis.HasFullOutline & _
                        ", gezackt " & swDetailkreis.JaggedOutline
        End If
    Next i
End Sub

Bemerkungen

Hilfebeispiele: „Create Detail Circle and Detail View“ skizziert in einer Ansicht einen Kreis, legt mit DrawingDoc.CreateDetailViewAt4 eine Detailansicht an, holt ihren Detailkreis mit View.GetDetail und gibt Beschriftung, deren Lage, Anzeige, Name, Stil und Textformat aus. Bei gezacktem Umriss setzt es DetailCircle.ShapeIntensity auf 2. „Get Detail Circle Information“ liest dagegen Lage, Layer und Pfeile aller Detailkreise einer Ansicht als Zahlen mit View.GetDetailCircleInfo2, ohne DetailCircle.

Zwei Ansichten: DetailCircle.GetView liefert die Ansicht, in der der Detailkreis liegt und aus der die Detailansicht abgeleitet ist. DetailCircle.GetDetailView liefert die Ansicht, „die den Detailkreis besitzt“, vermutlich die Detailansicht selbst. Die Hilfe beschreibt beide als besitzende Ansicht, eindeutig ist das nicht.

Auswählen: Mit ModelDocExtension.SelectByID2 wählst du einen Detailkreis über den Typ DETAILCIRCLE aus (swSelDETAILCIRCLES aus swSelectType_e), direkt mit DetailCircle.Select.

Einheiten: Für Lage, Radius und die Koordinaten der Linien nennt die Hilfe keine Einheit, vermutlich Meter in Blattkoordinaten. Das Hilfebeispiel zu View.GetDetailCircleInfo2 rechnet die Werte dort mit dem Faktor 1000 in mm um.

Neu aufbauen: Nach DetailCircle.SetParameters aktualisierst du die Zeichnung mit ModelDoc2.EditRebuild3. DetailCircle.SetStyle und DetailCircle.SetFullOutline laden das Modell der Detailansicht bei Bedarf ohne Rückfrage.

Die Lage der Beschriftung aus DetailCircle.GetLabelPosition ist in Metern, aber nicht in Blattkoordinaten: Der y-Wert kann über dem Blattrand liegen.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
JaggedOutlineLiest oder setzt, ob die Detailansicht einen gezackten Umriss hat.
LayerLiest oder setzt den Layer, auf dem der Detailkreis liegt.
NoOutlineLiest oder setzt, ob die Detailansicht ohne Umriss angezeigt wird.
PinPositionLiest oder setzt, ob die Detailansicht an ihrer Stelle bleibt, wenn sich die Größe der Ausgangsansicht ändert.
ScaleHatchPatternLiest oder setzt, ob die Schraffur in der Detailansicht nach ihrem Maßstab skaliert wird.
ShapeIntensityLiest oder setzt, wie stark der gezackte Umriss der Detailansicht gezackt ist.

Methoden 24, davon 24 beschrieben

NameBeschreibung
GetArrowInfoLiefert die Lage der Pfeile des Detailkreises.
GetConnectingLineLiefert die Endpunkte der Verbindungslinie zwischen Detailkreis und Detailansicht.
GetDetailViewLiefert die Zeichenansicht, die zum Detailkreis gehört, vermutlich die Detailansicht.
GetDisplayLiefert, ob der Detailkreis als Kreis oder als Profil angezeigt wird.
GetLabelLiefert die Beschriftung des Detailkreises, etwa „A“.
GetLabelPositionLiefert die Lage der Beschriftung des Detailkreises.
GetLeaderInfoLiefert die Punkte der Bezugslinie des Detailkreises.
GetNameLiefert den Namen des Detailkreises, wie er im FeatureManager steht.
GetProfileItemsLiefert die Skizzensegmente, aus denen das Profil des Detailkreises besteht.
GetProfileItemsCountLiefert die Zahl der Skizzensegmente, aus denen das Profil des Detailkreises besteht.
GetStyleLiefert den Stil des Detailkreises, etwa Standard, unterbrochen oder verbunden.
GetTextFormatLiefert das Textformat der Beschriftung des Detailkreises.
GetUseDocTextFormatLiefert, ob die Beschriftung des Detailkreises das Textformat aus dem Dokument benutzt.
GetViewLiefert die Zeichenansicht, in der der Detailkreis liegt und aus der die Detailansicht abgeleitet ist.
HasFullOutlineLiefert, ob die Detailansicht den vollständigen Umriss des Detailkreises oder Profils zeigt.
SelectWählt den Detailkreis aus.
SetDisplayStellt ein, ob der Detailkreis als Kreis oder als Profil angezeigt wird.
SetFullOutlineStellt ein, ob die Detailansicht den vollständigen Umriss des Detailkreises oder Profils zeigt oder nur den Teil, der die Geometrie schneidet.
SetLabelSetzt die Beschriftung des Detailkreises und damit auch die der Detailansicht.
SetLabelPositionSetzt die Lage der Beschriftung des Detailkreises.
SetNameSetzt den Namen des Detailkreises, wie er im FeatureManager steht.
SetParametersSetzt Lage und Radius des Detailkreises.
SetStyleSetzt den Stil des Detailkreises, etwa Standard, unterbrochen, mit oder ohne Bezugslinie oder verbunden.
SetTextFormatSetzt das Textformat der Beschriftung des Detailkreises oder schaltet auf das Textformat des Dokuments.

Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IGetArrowInfo). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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