SolidWorksMakroprogrammierung

Methode · DrawingDoc

ActivateSheet-Methode (DrawingDoc)

Macht das Blatt mit dem angegebenen Namen zum aktuellen Blatt der Zeichnung.

Syntax

Function ActivateSheet( _
   ByVal Name As String _
) As Boolean
bErfolg = swDraw.ActivateSheet("Blatt2")

Parameter

NameStringByVal
Der Name des Blatts, zum Beispiel "Blatt2". Die Standardnamen hängen von der Sprache ab, in einer englischen Zeichnung heißt dasselbe Blatt "Sheet2". Die Namen aller Blätter der Zeichnung liefert DrawingDoc.GetSheetNames.

Rückgabewert

True, wenn das Blatt aktiviert wurde. False heißt, dass SOLIDWORKS einen Fehler gemeldet hat.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swSheet As SldWorks.Sheet
Dim swView As SldWorks.View
Dim vBlaetter As Variant
Dim sStart As String
Dim lAnzahl As Long
Dim i As Long
Dim bErfolg As Boolean
Set swSheet = swDraw.GetCurrentSheet
sStart = swSheet.GetName
vBlaetter = swDraw.GetSheetNames
For i = 0 To UBound(vBlaetter)
    If swDraw.ActivateSheet(vBlaetter(i)) Then
        lAnzahl = 0
        Set swView = swDraw.GetFirstView      ' zuerst das Blatt selbst
        Set swView = swView.GetNextView       ' dann die erste Zeichenansicht
        Do While Not swView Is Nothing
            lAnzahl = lAnzahl + 1
            Set swView = swView.GetNextView
        Loop
        Debug.Print vBlaetter(i) & ": " & lAnzahl & " Zeichenansichten"
    End If
Next i
bErfolg = swDraw.ActivateSheet(sStart)        ' zurück zum Startblatt

Bemerkungen

Das Blatt wird zum aktuellen Blatt, so wie beim Blättern mit DrawingDoc.SheetNext oder DrawingDoc.SheetPrevious. Das zugehörige Sheet holst du dir danach mit DrawingDoc.GetCurrentSheet. Befehle wie DrawingDoc.GetFirstView beziehen sich auf das aktuelle Blatt, deshalb aktiviert das Beispiel jedes Blatt, bevor es dessen Ansichten durchläuft.

Eine Zeichenansicht aktivierst du nicht hiermit, sondern mit DrawingDoc.ActivateView. Ob beim Namen Groß- und Kleinschreibung zählt, sagt die Hilfe nicht.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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