SolidWorksMakroprogrammierung

Methode · DrawingDoc

PasteSheet-Methode (DrawingDoc)

Fügt ein kopiertes Blatt vor oder hinter dem ausgewählten Blatt oder am Ende der Zeichnung ein.

Syntax

Function PasteSheet( _
   ByVal InsertOption As Long, _
   ByVal RenameOption As Long _
) As Boolean
bErfolg = swDraw.PasteSheet(swInsertOption_AfterSelectedSheet, swRenameOption_Yes)

Parameter

InsertOptionLongByVal

Wohin das Blatt kommt, ein Wert aus swInsertOptions_e:

  • swInsertOption_BeforeSelectedSheet (0): vor das ausgewählte Blatt
  • swInsertOption_AfterSelectedSheet (1): hinter das ausgewählte Blatt
  • swInsertOption_MoveToEnd (2): dem Namen nach ans Ende der Zeichnung. Die Hilfe beschreibt den Wert nicht.
RenameOptionLongByVal

Was mit doppelten Namen von Ansichten passiert, ein Wert aus swRenameOptions_e:

  • swRenameOption_Yes (1): Schnittansichten, Detailansichten und Hilfsansichten, deren Namen es schon gibt, werden umbenannt.
  • swRenameOption_No (2): Die Namen bleiben, wie sie sind.

Rückgabewert

True, wenn das Blatt eingefügt wurde, sonst False.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim swSheet As SldWorks.Sheet
Dim bErfolg As Boolean
Set swSheet = swDraw.GetCurrentSheet
bErfolg = swModel.Extension.SelectByID2(swSheet.GetName, "SHEET", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault)
If bErfolg Then
    swModel.EditCopy
    If swDraw.PasteSheet(swInsertOption_AfterSelectedSheet, swRenameOption_Yes) Then
        Set swSheet = swDraw.GetCurrentSheet
        Debug.Print "Aktuelles Blatt: " & swSheet.GetName
        Debug.Print "Blätter: " & swDraw.GetSheetCount
    End If
End If

Bemerkungen

Vorher musst du zwei Dinge tun: ein Blatt auswählen (etwa mit ModelDocExtension.SelectByID2 und dem Typ "SHEET") und ModelDoc2.EditCopy aufrufen. Das ausgewählte Blatt ist zugleich der Bezug für „vor“ und „hinter“.

Die Kopie bekommt vermutlich einen Namen nach dem Muster Blatt1(2) und ist danach offenbar das aktuelle Blatt. Ausdrücklich beschreibt die Hilfe beides nicht. Das Beispiel gibt deshalb den Namen des aktuellen Blatts aus. Die Reihenfolge der Blätter änderst du später mit DrawingDoc.ReorderSheets.

Die Kopie bekommt einen Namen nach dem Muster „Blatt1(2)“ und ist nach dem Einfügen das aktuelle Blatt.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2011

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

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