Methode · DrawingDoc
NewSheet4-Methode (DrawingDoc)
Legt in der Zeichnung ein neues Blatt an, auf Wunsch mit Zonen.
Syntax
Function NewSheet4( _
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 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.NewSheet4("Blatt2", swDwgPapersUserDefined, swDwgTemplateNone, 1, 2, True, "", 0.42, 0.297, "", 0.01, 0.01, 0.01, 0.01, 4, 8)Parameter
NameStringByVal- Der Name des neuen Blatts, zum Beispiel
"Blatt2". In einer englischen Zeichnung heißen die Blätter standardmäßig"Sheet1","Sheet2"und so weiter. 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.
1und2ergeben 1:2. FirstAngleBooleanByValTruefür die Projektionsart Erster Winkel (in Europa üblich),Falsefür Dritter Winkel.TemplateNameStringByVal- Vollständiger Pfad der Blattformat-Datei. Zählt nur, wenn TemplateIn
swDwgTemplateCustomist, sonst"". 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"). Was ein leerer Text bewirkt, sagt die Hilfe nicht. 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, und anders als bei Width und Height ist hier nicht einmal sicher, dass Meter gemeint sind.
ZoneRowLongByVal- Anzahl der Zonen-Zeilen.
ZoneColLongByVal- Anzahl der Zonen-Spalten.
Rückgabewert
True, wenn das Blatt angelegt wurde, sonst False.
Beispiel
' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swSheet As SldWorks.Sheet
Dim bErfolg As Boolean
' 420 x 297 mm ohne Blattformat, Maßstab 1:2, Erster Winkel,
' Zonenbereich 10 mm vom Rand, 4 Zeilen mal 8 Spalten
bErfolg = swDraw.NewSheet4("Blatt2", swDwgPapersUserDefined, swDwgTemplateNone, 1, 2, True, "", _
0.42, 0.297, "", 0.01, 0.01, 0.01, 0.01, 4, 8)
If bErfolg Then
bErfolg = swDraw.ActivateSheet("Blatt2")
Set swSheet = swDraw.GetCurrentSheet
Debug.Print "Zone in der Blattmitte: " & swSheet.GetDrawingZone(0.21, 0.1485)
Else
Debug.Print "Blatt wurde nicht angelegt."
End IfBemerkungen
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 bei 0 Zeilen oder Spalten passiert, sagt die Hilfe nicht.
Einheiten: Die Hilfe nennt weder für die Papiergröße noch für die Ränder eine Einheit. Das Beispiel geht von Metern aus, bei den Rändern ist das aber nur eine Annahme. Probier es im eigenen Modell aus, bevor du dich darauf verlässt.
Ob das neue Blatt gleich das aktuelle wird, sagt die Hilfe nicht. Das Beispiel aktiviert es deshalb mit DrawingDoc.ActivateSheet. Ein vorhandenes Blatt änderst du über DrawingDoc.SetupSheet6, das fast dieselben Parameter hat. Ersetzt DrawingDoc.NewSheet3, das noch keine Zonen kannte.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2015
Englisches Original: IDrawingDoc::NewSheet4 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.