SolidWorksMakroprogrammierung

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 Boolean
bErfolg = 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 liefert Sheet.GetName.
PaperSizeLongByVal

Das Papierformat, ein Wert aus swDwgPaperSizes_e, zum Beispiel:

  • swDwgPaperA4size (6): A4 quer
  • swDwgPaperA4sizeVertical (7): A4 hoch
  • swDwgPaperA3size (8): A3
  • swDwgPapersUserDefined (12): eigene Größe aus Width und Height

Der Wert zählt nur, wenn TemplateIn swDwgTemplateNone ist.

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, etwa swDwgTemplateA3size (8).
Scale1DoubleByVal
Zähler des Blattmaßstabs.
Scale2DoubleByVal
Nenner des Blattmaßstabs. 1 und 5 ergeben 1:5.
FirstAngleBooleanByVal
True für die Projektionsart Erster Winkel (in Europa üblich), False für Dritter Winkel.
TemplateNameStringByVal
Die Blattformat-Datei mit vollständigem Pfad. Zählt nur, wenn TemplateIn swDwgTemplateCustom ist. 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 swDwgTemplateNone oder PaperSize swDwgPapersUserDefined ist. 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 liefert Sheet.CustomPropertyView.
RemoveModifiedNotesBooleanByVal
True löscht geänderte Hinweise, False lä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 If

Bemerkungen

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.