insertRows

Code

void insertRows(Spreadsheet spreadsheet, String cellName, int totalRows, int rowOffSet) throws ExcelException
void insertRows(Spreadsheet spreadsheet, int rowIndex, int totalRows, int rowOffSet) throws ExcelException

Beschreibung

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

• Formatierungen aus der übergeordneten Zeile werden übernommen. 
• Das Einfügen erfolgt vor der angegebenen Zelle, kann aber mittels rowOffet 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")
• rowIndex
  Numerischer Zeilenindex der Zelle (erste Zeile beginnt mit 1)
• totalRows
  Optionaler Parameter für Anzahl der einzufügenden Zeilen. Wird der Parameter nicht gesetzt, so ist die Anzahl immer 1
• rowOffSet
  Optionaler Parameter für die versetzte Einfügeposition.
  Das Einfügen erfolgt versetzt um die angegebene Menge von Reihen. Dies ermöglich auch ein Einfügen unterhalb 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.insertRows(excel, "A1"); 
    SpreadsheetUtils.insertRows(excel, 4, 2 );
    SpreadsheetUtils.insertRows(excel, "ANSPRECH", 5, 1); /* named cell ANSPRECH must exist */
    SpreadsheetUtils.save(excel);
}
finally
{
    SpreadsheetUtils.close(excel);
}