SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateDetailViewAt4-Methode (DrawingDoc)

Erzeugt eine Detailansicht und legt dabei Stil, Maßstab, Beschriftung und Umriss fest.

Syntax

Function CreateDetailViewAt4( _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal Z As Double, _
   ByVal Style As Long, _
   ByVal Scale1 As Double, _
   ByVal Scale2 As Double, _
   ByVal LabelIn As String, _
   ByVal Showtype As Long, _
   ByVal FullOutline As Boolean, _
   ByVal JaggedOutline As Boolean, _
   ByVal NoOutline As Boolean, _
   ByVal ShapeIntensity As Long _
) As Object
Set swView = swDraw.CreateDetailViewAt4(0.3, 0.2, 0, swDetViewSTANDARD, 2, 1, "B", swDetCircleCIRCLE, False, False, False, 1)

Parameter

XDoubleByVal
X-Koordinate der Stelle für die Detailansicht. Die Hilfe nennt keine Einheit, vermutlich Blattkoordinaten in Metern ab der linken unteren Ecke des Blatts.
YDoubleByVal
Wie X, für die Y-Koordinate.
ZDoubleByVal
Wie X, für die Z-Koordinate. Auf dem Blatt vermutlich 0.
StyleLongByVal

Stil der Detailansicht als Wert aus swDetViewStyle_e:

  • swDetViewSTANDARD (0): Standard
  • swDetViewBROKEN (1): unterbrochen
  • swDetViewLEADER (2): mit Bezugslinie
  • swDetViewNOLEADER (3): ohne Bezugslinie
  • swDetViewCONNECTED (4): verbunden
Scale1DoubleByVal
Zähler des Maßstabs, bei 2:1 also 2.
Scale2DoubleByVal
Nenner des Maßstabs, bei 2:1 also 1.
LabelInStringByVal
Die Ansichtsbeschriftung, zum Beispiel "B".
ShowtypeLongByVal

Art des Detailkreises als Wert aus swDetCircleShowType_e:

  • swDetCirclePROFILE (0): den gezeichneten Umriss verwenden
  • swDetCircleCIRCLE (1): einen Kreis verwenden
  • swDetCircleDONTSHOW (2): keinen Umriss anzeigen
FullOutlineBooleanByVal
True zeigt den vollständigen Umriss, False nicht. Gilt nur, wenn NoOutline False ist.
JaggedOutlineBooleanByVal
True zeigt einen gezackten Umriss, False nicht. Gilt nur, wenn NoOutline False ist.
NoOutlineBooleanByVal
True zeigt keinen Umriss, False zeigt einen.
ShapeIntensityLongByVal
Stärke der Zacken beim gezackten Umriss, von 1 (am stärksten) bis 5 (am schwächsten). Gilt nur, wenn JaggedOutline True und NoOutline False ist.

Rückgabewert

Die neue Detailansicht als View. Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis mit Is Nothing.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
' In einer Zeichenansicht ist ein Skizzenkreis ausgewählt, der den Ausschnitt begrenzt.
Dim swView As SldWorks.View
Dim swKreis As SldWorks.DetailCircle
Set swView = swDraw.CreateDetailViewAt4(0.3, 0.2, 0, swDetViewSTANDARD, 2, 1, "B", swDetCircleCIRCLE, False, True, False, 3)
If swView Is Nothing Then
    Debug.Print "Keine Detailansicht erzeugt. Ist ein Kreis ausgewählt?"
Else
    Set swKreis = swView.GetDetail
    Debug.Print swView.GetName2 & ": Detail " & swKreis.GetLabel & ", Maßstab " & swView.ScaleDecimal
End If

Bemerkungen

Die Befehlsseite sagt nicht, was vorher ausgewählt sein muss. Die veralteten Vorgänger beschreibt die Hilfe so, dass sie den ausgewählten geschlossenen Umriss als Grenze der Detailansicht nehmen. Zeichne also in der aktiven Zeichenansicht (DrawingDoc.ActivateView) einen Kreis, etwa mit SketchManager.CreateCircle, und lass ihn ausgewählt.

Den Detailkreis der neuen Ansicht liefert View.GetDetail als DetailCircle. Dort kannst du Umriss und Zacken auch nachträglich ändern, etwa mit DetailCircle.JaggedOutline und DetailCircle.ShapeIntensity.

Ersetzt DrawingDoc.CreateDetailViewAt3, dem JaggedOutline, NoOutline und ShapeIntensity noch fehlten.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2017

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

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