Methode · DrawingDoc
SetupSheet6-Methode (DrawingDoc)
Ändert die Einrichtung eines vorhandenen Blatts: Papierformat, Blattformat, Maßstab, Projektionsart und Zonen.
Syntax
Function SetupSheet6( _
ByVal Name As String, _
ByVal PaperSize As Long, _
ByVal TemplateIn As Long, _
ByVal Scale1 As Double, _
ByVal Scale2 As Double, _
ByVal FirstAngle As Boolean, _
ByVal TemplateName As String, _
ByVal Width As Double, _
ByVal Height As Double, _
ByVal PropertyViewName As String, _
ByVal RemoveModifiedNotes As Boolean, _
ByVal ZoneLeftMargin As Double, _
ByVal ZoneRightMargin As Double, _
ByVal ZoneTopMargin As Double, _
ByVal ZoneBottomMargin As Double, _
ByVal ZoneRow As Long, _
ByVal ZoneCol As Long _
) As BooleanbErfolg = swDraw.SetupSheet6("Blatt1", swDwgPapersUserDefined, swDwgTemplateNone, 1, 2, True, "", 0.42, 0.297, "", False, 0, 0, 0, 0, 0, 0)Parameter
NameStringByVal- Der Name des Blatts, das du einrichten willst, zum Beispiel
"Blatt1". In einer englischen Zeichnung heißt es standardmäßig"Sheet1". Den Namen des aktuellen Blatts liefertSheet.GetName. PaperSizeLongByValDas Papierformat, ein Wert aus
swDwgPaperSizes_e, zum Beispiel:swDwgPaperA4size(6): A4 querswDwgPaperA4sizeVertical(7): A4 hochswDwgPaperA3size(8): A3swDwgPapersUserDefined(12): eigene Größe aus Width und Height
Der Wert zählt nur, wenn TemplateIn
swDwgTemplateNoneist.TemplateInLongByVal- Das Blattformat, ein Wert aus
swDwgTemplates_e.swDwgTemplateNone(13): kein Blattformat,swDwgTemplateCustom(12): eigenes Blattformat aus TemplateName. Daneben gibt es Werte für die Standardgrößen, etwaswDwgTemplateA3size(8). Scale1DoubleByVal- Zähler des Blattmaßstabs.
Scale2DoubleByVal- Nenner des Blattmaßstabs.
1und5ergeben 1:5. FirstAngleBooleanByValTruefür die Projektionsart Erster Winkel (in Europa üblich),Falsefür Dritter Winkel.TemplateNameStringByVal- Die Blattformat-Datei mit vollständigem Pfad. Zählt nur, wenn TemplateIn
swDwgTemplateCustomist. Nennst du eine andere Datei als die, die das Blatt gerade benutzt, tauscht SOLIDWORKS das Blattformat aus. WidthDoubleByVal- Breite des Papiers. Zählt nur, wenn TemplateIn
swDwgTemplateNoneoder PaperSizeswDwgPapersUserDefinedist. Die Hilfe nennt keine Einheit, vermutlich Meter wie sonst in der API. HeightDoubleByVal- Höhe des Papiers, sonst wie Width.
PropertyViewNameStringByVal- Name der Zeichenansicht, aus deren Modell das Blatt die benutzerdefinierten Eigenschaften holt, zum Beispiel
"Zeichenansicht1"(englisch"Drawing View1"). Den aktuell eingestellten Namen liefertSheet.CustomPropertyView. RemoveModifiedNotesBooleanByValTruelöscht geänderte Hinweise,Falselässt sie stehen. Welche Hinweise genau gemeint sind, sagt die Hilfe nicht. Dem Namen nach vermutlich Hinweise im Blattformat, die du geändert hast.ZoneLeftMarginDoubleByVal- Abstand des Zonenbereichs vom linken Blattrand.
ZoneRightMarginDoubleByVal- Abstand des Zonenbereichs vom rechten Blattrand.
ZoneTopMarginDoubleByVal- Abstand des Zonenbereichs vom oberen Blattrand.
ZoneBottomMarginDoubleByVal- Abstand des Zonenbereichs vom unteren Blattrand. Für alle vier Ränder nennt die Hilfe keine Einheit.
ZoneRowLongByVal- Anzahl der Zonen-Zeilen im Zonenbereich.
ZoneColLongByVal- Anzahl der Zonen-Spalten im Zonenbereich.
Rückgabewert
True, wenn das Blatt eingerichtet wurde, sonst False.
Beispiel
' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
' Papier, Blattformat und Eigenschaftsansicht bleiben, wie sie sind.
Dim swSheet As SldWorks.Sheet
Dim vWerte As Variant
Dim bErfolg As Boolean
Set swSheet = swDraw.GetCurrentSheet
vWerte = swSheet.GetProperties2 ' Papier, Format, Maßstab, Projektion, Breite, Höhe ...
bErfolg = swDraw.SetupSheet6(swSheet.GetName, CLng(vWerte(0)), CLng(vWerte(1)), 1, 5, True, _
swSheet.GetTemplateName, vWerte(5), vWerte(6), swSheet.CustomPropertyView, False, _
0, 0, 0, 0, 0, 0)
If bErfolg Then
swModel.ForceRebuild3 False ' Ansichten an die Projektionsart anpassen
Debug.Print swSheet.GetName & ": jetzt 1:5, Erster Winkel"
Else
Debug.Print "Das Blatt ließ sich nicht einrichten."
End IfBemerkungen
Ruf danach ModelDoc2.ForceRebuild3 auf, damit die Zeichenansichten eine geänderte Projektionsart (Erster oder Dritter Winkel) übernehmen.
Der Befehl braucht alle Angaben auf einmal. Werte, die gleich bleiben sollen, holst du vorher mit Sheet.GetProperties2 (Papierformat und Blattformat als Zahl, Maßstab, Projektion, Breite, Höhe), Sheet.GetTemplateName und Sheet.CustomPropertyView. GetProperties2 liefert lauter Double-Werte, die Enumerationen wandelst du deshalb mit CLng um.
Zonen: Der Zonenbereich liegt innerhalb der vier Ränder und wird in ZoneRow mal ZoneCol Zonen geteilt. Beschriftungen in anderen Ansichten können sich auf diese Zonen beziehen. Die Bezeichnung der einzelnen Zonen legst du in der Oberfläche fest, nicht mit diesem Befehl. In welcher Zone ein Punkt liegt, liefert Sheet.GetDrawingZone. Was 0 für Zeilen und Spalten bei einem Blatt mit vorhandenen Zonen bewirkt, sagt die Hilfe nicht.
Mehrere Blätter: Rufst du vorher DrawingDoc.SetSheetsSelected auf, ändert ein einziger Aufruf von SetupSheet6 mehrere Blätter. Die Hilfe nennt den Befehl an dieser Stelle SetSelectedSheets, gemeint ist offenbar SetSheetsSelected.
Ob das Blatt dafür aktiv sein muss, sagt die Hilfe nicht. Ein neues Blatt legst du mit DrawingDoc.NewSheet4 an. Ersetzt DrawingDoc.SetupSheet5.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2015
Englisches Original: IDrawingDoc::SetupSheet6 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.