SolidWorksMakroprogrammierung

Eigenschaft · DrawingDoc

Sheet-Eigenschaft (DrawingDoc)

Liefert ein Blatt der Zeichnung über seinen Namen.

Syntax

Property Sheet( _
   ByVal Name As String _
) As Sheet    ' nur lesen
Set swSheet = swDraw.Sheet("Blatt2")

Parameter

NameStringByVal
Der Name des Blatts, zum Beispiel "Blatt2". In einer englischen Zeichnung heißen die Blätter standardmäßig "Sheet1", "Sheet2" und so weiter. Alle Namen liefert DrawingDoc.GetSheetNames.

Wert

Das Blatt (Sheet) mit diesem Namen. Was bei einem Namen zurückkommt, den es nicht gibt, sagt die Hilfe nicht. Vermutlich Nothing, deshalb prüft das Beispiel darauf.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swSheet As SldWorks.Sheet
Dim vNamen As Variant
Dim dBreite As Double, dHoehe As Double
Dim i As Long
vNamen = swDraw.GetSheetNames
For i = 0 To UBound(vNamen)
    Set swSheet = swDraw.Sheet(vNamen(i))
    If swSheet Is Nothing Then
        Debug.Print vNamen(i) & ": nicht gefunden"
    Else
        swSheet.GetSize dBreite, dHoehe
        Debug.Print vNamen(i) & ": " & dBreite * 1000 & " x " & dHoehe * 1000 & " mm"
    End If
Next i

Bemerkungen

Mit dem Namen kommst du direkt an ein bestimmtes Blatt. DrawingDoc.GetCurrentSheet liefert dagegen nur das aktuelle Blatt. Ob das gesuchte Blatt dafür aktiv sein muss, sagt die Hilfe nicht ausdrücklich. Das Beispiel geht davon aus, dass nicht. Prüf das in deiner Zeichnung, sonst aktivierst du es vorher mit DrawingDoc.ActivateSheet.

Du bekommst das Blatt auch dann, wenn es beim Öffnen der Zeichnung nicht geladen wurde. Ob es geladen ist, sagt dir Sheet.IsLoaded.

Die Eigenschaft kann nur gelesen werden.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2010

Englisches Original: IDrawingDoc::Sheet in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.