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 ObjectSet 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. StyleLongByValStil der Detailansicht als Wert aus
swDetViewStyle_e:swDetViewSTANDARD(0): StandardswDetViewBROKEN(1): unterbrochenswDetViewLEADER(2): mit BezugslinieswDetViewNOLEADER(3): ohne BezugslinieswDetViewCONNECTED(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". ShowtypeLongByValArt des Detailkreises als Wert aus
swDetCircleShowType_e:swDetCirclePROFILE(0): den gezeichneten Umriss verwendenswDetCircleCIRCLE(1): einen Kreis verwendenswDetCircleDONTSHOW(2): keinen Umriss anzeigen
FullOutlineBooleanByValTruezeigt den vollständigen Umriss,Falsenicht. Gilt nur, wenn NoOutlineFalseist.JaggedOutlineBooleanByValTruezeigt einen gezackten Umriss,Falsenicht. Gilt nur, wenn NoOutlineFalseist.NoOutlineBooleanByValTruezeigt keinen Umriss,Falsezeigt einen.ShapeIntensityLongByVal- Stärke der Zacken beim gezackten Umriss, von
1(am stärksten) bis5(am schwächsten). Gilt nur, wenn JaggedOutlineTrueund NoOutlineFalseist.
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 IfBemerkungen
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.