Funktionsreferenz

_ExcelSheetDelete

Löscht das festgelegte Tabellenblatt durch Angabe des Stringnamens oder durch eine Zahl.

#Include <Excel.au3>
_ExcelSheetDelete($oExcel, $vSheet [, $fAlerts = False])

 

Parameter

$oExcel Ein Excel Objekt welches durch einen vorherigen Aufruf von _ExcelBookOpen() oder _ExcelBookNew() geöffnet wurde
$vSheet Das Tabellenblatt, welches entweder durch Angabe des Stringnamens oder durch eine Zahl gelöscht werden soll
$fAlerts [optional] Erlaubt modale Meldungen (True oder False) (Standard=False)

 

Rückgabewert

Erfolg: 1
Fehler: 0 und setzt @error
@error: 0 - Kein Fehler
1 - festgelegtes Objekt existiert nicht
2 - festgelegte Zahl des Tabellenblattes existiert nicht
3 - festgelegter Name des Tabellenblattes existiert nicht

 

Bemerkungen

Keine.

 

Verwandte Funktionen

 

Beispiel


; ***************************************************************
; Beispiel 1 – Nach dem öffnen einer Arbeitsmappe und Rückgabe des Objekt-Identifizierers:  Lösche ein, durch seinen Namen festgelegtes Arbeitsblatt
; *****************************************************************
#include <Excel.au3>

Local $oExcel = _ExcelBookNew() ; Erstellt eine neue Arbeitsmappe und zeigt sie an

_ExcelSheetDelete($oExcel, "Sheet1") ; Löscht das, durch seinen Namen festgelegte Arbeitsblatt

MsgBox(0, "Verlassen", "Drücke OK um die Datei zu Speichern und das Programm zu verlassen")
_ExcelBookSaveAs($oExcel, @TempDir & "\Temp.xls", "xls", 0, 1) ; Nun speichern wir die Datei, in eine temporäres Verzeichnis; Möglicherweise werden existierende Dateien dabei überschrieben!
_ExcelBookClose($oExcel) ; Zum Abschluss, verlassen wir das Programm

; ***************************************************************
; Beispiel 2 – Nach dem öffnen einer Arbeitsmappe und Rückgabe des Objekt-Identifizierers: Lösche ein, durch seinen Index festgelegtes Arbeitsblatt
; *****************************************************************
#include <Excel.au3>

Local $oExcel = _ExcelBookNew() ; Erstellt eine neue Arbeitsmappe und zeigt sie an

_ExcelSheetDelete($oExcel, 1) ; Löscht das, durch seinen Index festgelegte Arbeitsblatt

MsgBox(0, "Verlassen", "Drücke OK um die Datei zu Speichern und das Programm zu verlassen")
_ExcelBookSaveAs($oExcel, @TempDir & "\Temp.xls", "xls", 0, 1) ; Nun speichern wir die Datei, in eine temporäres Verzeichnis; Möglicherweise werden existierende Dateien dabei überschrieben!
_ExcelBookClose($oExcel) ; Zum Abschluss, verlassen wir das Programm