Objekt · SldWorks
Sheet-Objekt
Ein Zeichenblatt einer Zeichnung: Name, Papierformat, Maßstab, Blattformat, Zeichenansichten, Zonen, Schriftfeld, Tabellen und magnetische Linien.
Beschreibung
Sheet gibt Zugriff auf ein Blatt einer Zeichnung und auf Objekte darauf. Eine Zeichnung hat ein oder mehrere Blätter, auf jedem stehen meist eine oder mehrere Zeichenansichten. Zu jedem Blatt gehören ein Papierformat, ein Maßstab, eine Projektionsart und meist ein Blattformat mit Schriftfeld. Die Befehle gibt es seit SOLIDWORKS 2001Plus, die für Zonen seit SOLIDWORKS 2022 und InsertFamilyTable seit SOLIDWORKS 2026.
Zugriff
DrawingDoc.GetCurrentSheet: das aktive BlattDrawingDoc.Sheet: ein Blatt über seinen Namen, die Namen liefertDrawingDoc.GetSheetNamesView.Sheet: das Blatt einer ZeichenansichtFamilyTableAnnotation.GetSheetundRevisionTableAnnotation.GetSheet: das Blatt einer Familientabelle oder Revisionstabelle
Beispiel
' Gibt für jedes Blatt der aktiven Zeichnung Name, Papierformat, Größe, Maßstab,
' Blattformat und die Zahl der Zeichenansichten aus.
' Vorbedingung: Eine Zeichnung ist offen.
' Ergebnis: Die Werte stehen im Direktfenster, die Zeichnung bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swBlatt As SldWorks.Sheet
Dim vNamen As Variant
Dim vEigenschaften As Variant
Dim vAnsichten As Variant
Dim dBreite As Double, dHoehe As Double
Dim nAnsichten As Long
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swDraw = swModel
vNamen = swDraw.GetSheetNames
For i = 0 To UBound(vNamen)
Set swBlatt = swDraw.Sheet(vNamen(i))
vEigenschaften = swBlatt.GetProperties2
swBlatt.GetSize dBreite, dHoehe
vAnsichten = swBlatt.GetViews
If IsEmpty(vAnsichten) Then nAnsichten = 0 Else nAnsichten = UBound(vAnsichten) + 1
Debug.Print swBlatt.GetName & " (ID " & swBlatt.GetID & ")"
Debug.Print " Papier " & vEigenschaften(0) & ", " & dBreite * 1000 & " x " & dHoehe * 1000 & " mm, " & _
"Maßstab " & vEigenschaften(2) & ":" & vEigenschaften(3) & _
IIf(vEigenschaften(4) <> 0, ", Erstwinkelprojektion", "")
Debug.Print " Blattformat " & swBlatt.GetSheetFormatName & ", Vorlage " & swBlatt.GetTemplateName
Debug.Print " " & nAnsichten & " Zeichenansicht(en), geladen: " & swBlatt.IsLoaded
Next i
End SubBemerkungen
Hilfebeispiele: „Get and Set Sheet Properties“ liest die Eigenschaften und schaltet die Projektionsart um, „Set Drawing Sheet Properties“ macht das mit Sheet.GetProperties2 und Sheet.SetProperties2. „Modify and Reload Sheet Format Template“ speichert ein geändertes Blattformat und lädt es auf einem anderen Blatt neu. „Create Drawing Sheet Zones“ legt ein Blatt mit Zonen an und fügt eine Revisionstabelle ein. Weitere Beispiele gibt es zu Schriftfeld, Tabellenankern, magnetischen Linien, Zonennamen und geladenen Blättern.
Veraltete Befehle: GetProperties, SetProperties und InsertRevisionTable sind durch Sheet.GetProperties2, Sheet.SetProperties2 und Sheet.InsertRevisionTable2 ersetzt. Für OLE-Objekte und Stücklisten gibt es neue Befehle an ModelDocExtension.CreateOLEObject, SwOLEObject und View.GetBomTable. Einige Hilfeseiten verweisen noch auf die alten Befehle oder auf DrawingDoc.SetupSheet4; aktuell ist DrawingDoc.SetupSheet6.
Einheiten: Größen, Ränder und Koordinaten auf dem Blatt nennt die Hilfe meist ohne Einheit. Es sind wie sonst in der API Meter, die Hilfebeispiele setzen etwa 0.2794 und 0.2159 für ein Blatt im Format A (Letter).
Eigenschaften und Methoden
Eigenschaften 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| CustomPropertyView | Liest oder setzt die Zeichenansicht, aus deren Modell das Blatt seine benutzerdefinierten Eigenschaften nimmt. |
| FocusLocked | Liest oder setzt, ob der Fokus auf dem Blatt gesperrt ist. |
| PageSetup | Liefert die Seiteneinrichtung des Blatts. |
| RevisionTable | Liefert die Revisionstabelle des Blatts. |
| SheetFormatVisible | Liest oder setzt, ob das Blattformat auf dem Blatt sichtbar ist. |
| TableAnchor | Liefert den Tabellenanker des Blatts für eine Tabellenart, etwa für Bohrungstabellen. |
| TitleBlock | Liefert das Schriftfeld des Blatts. |
Methoden 40, davon 32 beschrieben, 8 veraltet
| Name | Beschreibung |
|---|---|
| CreateOLEObject | veraltet ersetzt durch ModelDocExtension.CreateOLEObject |
| GetBomTable | veraltet ersetzt durch View.GetBomTable |
| GetCustomColorsCount | Liefert dem Namen nach die Zahl der eigenen Farben des Blatts. |
| GetDrawingZone | Liefert den Namen der Zone an einer Stelle des Blatts. |
| GetID | Liefert die Kennung des Blatts. |
| GetMagneticLines | Liefert die magnetischen Linien auf dem Blatt. |
| GetMagneticLinesCount | Liefert die Zahl der magnetischen Linien auf dem Blatt. |
| GetName | Liefert den Namen des Blatts. |
| GetOLEObjectCount | veraltet ersetzt durch ModelDocExtension.GetOLEObjectCount |
| GetOLEObjectData | veraltet ersetzt durch SwOLEObject |
| GetOLEObjectSettings | veraltet ersetzt durch SwOLEObject.Aspect, SwOLEObject.Boundaries und SwOLEObject.Buffer |
| GetProperties | veraltet ersetzt durch Sheet.GetProperties2 |
| GetProperties2 | Liefert die Eigenschaften des Blatts: Papierformat, Vorlage, Maßstab, Projektionsart, Größe und die Einstellung für benutzerdefinierte Eigenschaften. |
| GetSheetFormatName | Liefert den Namen des Blattformats, wie er im FeatureManager steht. |
| GetSize | Liefert Breite und Höhe des Blatts und das passende Papierformat. |
| GetTemplateName | Liefert Pfad und Dateiname der Blattformatvorlage des Blatts. |
| GetTemplateSketch | Liefert die Skizze des Blattformats. |
| GetViews | Liefert die Zeichenansichten auf dem Blatt. |
| GetZoneMargin | Liefert einen Rand der Zonen des Blatts. |
| GetZoneSizeDistribution | Liefert, wie die Zonen des Blatts aufgeteilt sind, und bei gleich großen Zonen die Zahl der Zeilen und Spalten. |
| GetZoneSizeRegion | Liefert, worauf sich die Zonengröße des Blatts bezieht: auf den Bereich innerhalb der Ränder oder auf das ganze Blatt. |
| InsertFamilyTable | Fügt eine Familientabelle in das Blatt ein. |
| InsertMagneticLine | Fügt eine magnetische Linie zwischen zwei Punkten auf dem Blatt ein. |
| InsertRevisionTable | veraltet ersetzt durch Sheet.InsertRevisionTable2 |
| InsertRevisionTable2 | Fügt eine Revisionstabelle in das Blatt ein. |
| InsertTitleBlock | Legt auf dem Blatt ein Schriftfeld an, auf Wunsch mit Notizen. |
| IsLoaded | Liefert, ob das Blatt geladen ist. |
| ReloadTemplate | Lädt das Blattformat neu aus seiner Vorlage, auf Wunsch unter Beibehaltung geänderter Notizen. |
| SaveFormat | Speichert das Blattformat des Blatts in eine Datei. |
| SetAsTableAnchor | Setzt den Tabellenanker einer Tabellenart an einen ausgewählten Punkt im Blattformat. |
| SetName | Benennt das Blatt um. |
| SetProperties | veraltet ersetzt durch Sheet.SetProperties2 |
| SetProperties2 | Setzt die Eigenschaften des Blatts: Papierformat, Vorlage, Maßstab, Projektionsart, Größe und die Einstellung für benutzerdefinierte Eigenschaften. |
| SetScale | Setzt den Maßstab des Blatts und legt fest, ob Lage und Schrifthöhe der Beschriftungen mitskaliert werden. |
| SetSheetFormatName | Setzt den Namen des Blattformats, wie er im FeatureManager steht. |
| SetSize | Setzt das Papierformat und die Größe des Blatts. |
| SetTemplateName | Setzt die Blattformatvorlage des Blatts. |
| SetZoneMargin | Setzt einen Rand der Zonen des Blatts. |
| SetZoneSizeDistribution | Setzt, wie die Zonen des Blatts aufgeteilt sind, und bei gleich großen Zonen die Zahl der Zeilen und Spalten. |
| SetZoneSizeRegion | Setzt, worauf sich die Zonengröße des Blatts bezieht: auf den Bereich innerhalb der Ränder oder auf das ganze Blatt. |
Nicht aufgeführt sind 8 C++-Varianten (Namen mit I davor, zum Beispiel ICreateOLEObject). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISheet in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.