deleteColumns
Versionshinweise | 20.2 |
---|
Code
void deleteColumns(Spreadsheet spreadsheet, String cellName, int totalColumns, int columnOffSet) throws ExcelException
void deleteColumns(Spreadsheet spreadsheet, int columnIndex, int totalColumns, int columnOffSet) throws ExcelException
Beschreibung
Löschen von einer oder mehreren Spalten an der angegebenen Zelle der übergebenen Tabellenkalkulationsdatei.
Parameter
- spreadsheet
Repräsentiert die Tabellenkalkulationsdatei - cellName
Name der benannten Zelle (z.B. "CONF_SEARCHDIALOG") oder eine Zellenangabe in der A1-Schreibweise (z.B. "A3") - columnIndex
Numerischer Spaltenindex der Zelle (erste Spalte beginnt mit 1) - totalColumn
Optionaler Parameter für Anzahl der zu löschenden Spalten. Wird der Parameter nicht gesetzt, so ist die Anzahl immer 1 - columnOffSet
Optionaler Parameter für die versetzte Löschposition.
Das Löschen erfolgt versetzt um die angegebene Menge von Spalten. Dies ermöglich auch ein Löschen rechts neben der angegebenen Position, z.B: rowOffSet =1
Wird der Parameter nicht gesetzt, so ist der Wert 0, also kein versetztes Einfügen.
Exception
Wird im Regelfall geworfen, wenn die angegebene benannte Zelle (auch unter Berücksichtigung des offSet) nicht vorhanden ist.
Beispiele
ISpreadsheetResultOpen openResult = SpreadsheetUtils.openFile("C:\\Work\\myFirstSpreadsheet.xlsm");
if (!openResult.isSuccessful())
{
ScriptUtils.debug("Error: " + openResult.getFileName() + " - " + openResult.getErrorCode());
/* do furthermore */
return;
}
Spreadsheet excel = null;
try
{
excel = openResult.getSpreadsheet();
SpreadsheetUtils.setActiveWorksheet(excel, 1);
SpreadsheetUtils.deleteColumns(excel, "A1");
SpreadsheetUtils.deleteColumns(excel, 4, 2 );
SpreadsheetUtils.deleteColumns(excel, "ANSPRECH", 5, 1); /* named cell ANSPRECH must exist */
SpreadsheetUtils.save(excel);
}
finally
{
SpreadsheetUtils.close(excel);
}