Objekt · SldWorks
DetailCircle-Objekt
Der Detailkreis einer Detailansicht in einer Zeichnung: Beschriftung, Name, Stil, Kreis oder Profil, Umriss, Lage, Größe, Layer und Textformat.
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
View.GetDetail: aus einer Detailansicht ihr DetailkreisView.GetDetailCircles: aus einer Ausgangsansicht alle ihre Detailkreise als Array, die Anzahl mitView.GetDetailCircleCount2Feature.GetSpecificFeature2: aus dem Feature des Detailkreises im FeatureManager (TypnameDetailCircle)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| JaggedOutline | Liest oder setzt, ob die Detailansicht einen gezackten Umriss hat. |
| Layer | Liest oder setzt den Layer, auf dem der Detailkreis liegt. |
| NoOutline | Liest oder setzt, ob die Detailansicht ohne Umriss angezeigt wird. |
| PinPosition | Liest oder setzt, ob die Detailansicht an ihrer Stelle bleibt, wenn sich die Größe der Ausgangsansicht ändert. |
| ScaleHatchPattern | Liest oder setzt, ob die Schraffur in der Detailansicht nach ihrem Maßstab skaliert wird. |
| ShapeIntensity | Liest oder setzt, wie stark der gezackte Umriss der Detailansicht gezackt ist. |
Methoden 24, davon 24 beschrieben
| Name | Beschreibung |
|---|---|
| GetArrowInfo | Liefert die Lage der Pfeile des Detailkreises. |
| GetConnectingLine | Liefert die Endpunkte der Verbindungslinie zwischen Detailkreis und Detailansicht. |
| GetDetailView | Liefert die Zeichenansicht, die zum Detailkreis gehört, vermutlich die Detailansicht. |
| GetDisplay | Liefert, ob der Detailkreis als Kreis oder als Profil angezeigt wird. |
| GetLabel | Liefert die Beschriftung des Detailkreises, etwa „A“. |
| GetLabelPosition | Liefert die Lage der Beschriftung des Detailkreises. |
| GetLeaderInfo | Liefert die Punkte der Bezugslinie des Detailkreises. |
| GetName | Liefert den Namen des Detailkreises, wie er im FeatureManager steht. |
| GetProfileItems | Liefert die Skizzensegmente, aus denen das Profil des Detailkreises besteht. |
| GetProfileItemsCount | Liefert die Zahl der Skizzensegmente, aus denen das Profil des Detailkreises besteht. |
| GetStyle | Liefert den Stil des Detailkreises, etwa Standard, unterbrochen oder verbunden. |
| GetTextFormat | Liefert das Textformat der Beschriftung des Detailkreises. |
| GetUseDocTextFormat | Liefert, ob die Beschriftung des Detailkreises das Textformat aus dem Dokument benutzt. |
| GetView | Liefert die Zeichenansicht, in der der Detailkreis liegt und aus der die Detailansicht abgeleitet ist. |
| HasFullOutline | Liefert, ob die Detailansicht den vollständigen Umriss des Detailkreises oder Profils zeigt. |
| Select | Wählt den Detailkreis aus. |
| SetDisplay | Stellt ein, ob der Detailkreis als Kreis oder als Profil angezeigt wird. |
| SetFullOutline | Stellt ein, ob die Detailansicht den vollständigen Umriss des Detailkreises oder Profils zeigt oder nur den Teil, der die Geometrie schneidet. |
| SetLabel | Setzt die Beschriftung des Detailkreises und damit auch die der Detailansicht. |
| SetLabelPosition | Setzt die Lage der Beschriftung des Detailkreises. |
| SetName | Setzt den Namen des Detailkreises, wie er im FeatureManager steht. |
| SetParameters | Setzt Lage und Radius des Detailkreises. |
| SetStyle | Setzt den Stil des Detailkreises, etwa Standard, unterbrochen, mit oder ohne Bezugslinie oder verbunden. |
| SetTextFormat | Setzt 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.