insertColumns

Code

void insertColumns(Spreadsheet spreadsheet, String cellName, int totalColumns, int columnOffSet) throws ExcelException
void insertColumns(Spreadsheet spreadsheet, int columnIndex, int totalColumns, int columnOffSet) throws ExcelException

Beschreibung

Einfügen von einer oder mehreren Spalten an der angegebenen Zelle der übergebenen Tabellenkalkulationsdatei. 
Hinweise

• Formatierungen aus der linken benachbarten Spalte werden übernommen. 
• Das Einfügen erfolgt vor der angegebenen Zelle, kann aber mittels columnOffet beeinflusst werden.

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)
• totalColumns
  Optionaler Parameter für Anzahl der einzufügenden Spalten. Wird der Parameter nicht gesetzt, so ist die Anzahl immer 1
• columnOffSet
  Optionaler Parameter für die versetzte Einfügeposition.
  Das Einfügen erfolgt versetzt um die angegebene Menge von Spalten. Dies ermöglich auch ein Einfügen 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.insertColumns(excel, "A1");
    SpreadsheetUtils.insertColumns(excel, 4, 2 );
    SpreadsheetUtils.insertColumns(excel, "ANSPRECH", 5, 1); /* named cell ANSPRECH must exist */
    SpreadsheetUtils.save(excel);
}
finally
{
    SpreadsheetUtils.close(excel);
}