SolidWorksMakroprogrammierung

Objekt · SldWorks

Sheet-Objekt

Ein Zeichenblatt einer Zeichnung: Name, Papierformat, Maßstab, Blattformat, Zeichenansichten, Zonen, Schriftfeld, Tabellen und magnetische Linien.

Deklaration Dim x As SldWorks.Sheet · in der englischen .NET-Hilfe: ISheet

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

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 Sub

Bemerkungen

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

NameBeschreibung
CustomPropertyViewLiest oder setzt die Zeichenansicht, aus deren Modell das Blatt seine benutzerdefinierten Eigenschaften nimmt.
FocusLockedLiest oder setzt, ob der Fokus auf dem Blatt gesperrt ist.
PageSetupLiefert die Seiteneinrichtung des Blatts.
RevisionTableLiefert die Revisionstabelle des Blatts.
SheetFormatVisibleLiest oder setzt, ob das Blattformat auf dem Blatt sichtbar ist.
TableAnchorLiefert den Tabellenanker des Blatts für eine Tabellenart, etwa für Bohrungstabellen.
TitleBlockLiefert das Schriftfeld des Blatts.

Methoden 40, davon 32 beschrieben, 8 veraltet

NameBeschreibung
CreateOLEObjectveraltet ersetzt durch ModelDocExtension.CreateOLEObject
GetBomTableveraltet ersetzt durch View.GetBomTable
GetCustomColorsCountLiefert dem Namen nach die Zahl der eigenen Farben des Blatts.
GetDrawingZoneLiefert den Namen der Zone an einer Stelle des Blatts.
GetIDLiefert die Kennung des Blatts.
GetMagneticLinesLiefert die magnetischen Linien auf dem Blatt.
GetMagneticLinesCountLiefert die Zahl der magnetischen Linien auf dem Blatt.
GetNameLiefert den Namen des Blatts.
GetOLEObjectCountveraltet ersetzt durch ModelDocExtension.GetOLEObjectCount
GetOLEObjectDataveraltet ersetzt durch SwOLEObject
GetOLEObjectSettingsveraltet ersetzt durch SwOLEObject.Aspect, SwOLEObject.Boundaries und SwOLEObject.Buffer
GetPropertiesveraltet ersetzt durch Sheet.GetProperties2
GetProperties2Liefert die Eigenschaften des Blatts: Papierformat, Vorlage, Maßstab, Projektionsart, Größe und die Einstellung für benutzerdefinierte Eigenschaften.
GetSheetFormatNameLiefert den Namen des Blattformats, wie er im FeatureManager steht.
GetSizeLiefert Breite und Höhe des Blatts und das passende Papierformat.
GetTemplateNameLiefert Pfad und Dateiname der Blattformatvorlage des Blatts.
GetTemplateSketchLiefert die Skizze des Blattformats.
GetViewsLiefert die Zeichenansichten auf dem Blatt.
GetZoneMarginLiefert einen Rand der Zonen des Blatts.
GetZoneSizeDistributionLiefert, wie die Zonen des Blatts aufgeteilt sind, und bei gleich großen Zonen die Zahl der Zeilen und Spalten.
GetZoneSizeRegionLiefert, worauf sich die Zonengröße des Blatts bezieht: auf den Bereich innerhalb der Ränder oder auf das ganze Blatt.
InsertFamilyTableFügt eine Familientabelle in das Blatt ein.
InsertMagneticLineFügt eine magnetische Linie zwischen zwei Punkten auf dem Blatt ein.
InsertRevisionTableveraltet ersetzt durch Sheet.InsertRevisionTable2
InsertRevisionTable2Fügt eine Revisionstabelle in das Blatt ein.
InsertTitleBlockLegt auf dem Blatt ein Schriftfeld an, auf Wunsch mit Notizen.
IsLoadedLiefert, ob das Blatt geladen ist.
ReloadTemplateLädt das Blattformat neu aus seiner Vorlage, auf Wunsch unter Beibehaltung geänderter Notizen.
SaveFormatSpeichert das Blattformat des Blatts in eine Datei.
SetAsTableAnchorSetzt den Tabellenanker einer Tabellenart an einen ausgewählten Punkt im Blattformat.
SetNameBenennt das Blatt um.
SetPropertiesveraltet ersetzt durch Sheet.SetProperties2
SetProperties2Setzt die Eigenschaften des Blatts: Papierformat, Vorlage, Maßstab, Projektionsart, Größe und die Einstellung für benutzerdefinierte Eigenschaften.
SetScaleSetzt den Maßstab des Blatts und legt fest, ob Lage und Schrifthöhe der Beschriftungen mitskaliert werden.
SetSheetFormatNameSetzt den Namen des Blattformats, wie er im FeatureManager steht.
SetSizeSetzt das Papierformat und die Größe des Blatts.
SetTemplateNameSetzt die Blattformatvorlage des Blatts.
SetZoneMarginSetzt einen Rand der Zonen des Blatts.
SetZoneSizeDistributionSetzt, wie die Zonen des Blatts aufgeteilt sind, und bei gleich großen Zonen die Zahl der Zeilen und Spalten.
SetZoneSizeRegionSetzt, 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.