Excel.RunOptions interface

Extends

Comentários

Usada por

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-undo-grouping.yaml

// Use the `mergeUndoGroup` property of the `RunOptions` interface to group multiple operations into a single undo action.
await Excel.run({ mergeUndoGroup: true }, async (context) => {
  const workbook = context.workbook;
  const sheet = context.workbook.worksheets.getActiveWorksheet();

  // Apply formatting to multiple ranges.
  const headerRange = sheet.getRange("A1:D1");
  headerRange.format.fill.color = "#4472C4";
  headerRange.format.font.color = "white";
  headerRange.format.font.bold = true;

  await context.sync();

  const dataRange = sheet.getRange("A2:D6");
  dataRange.format.borders.getItem("EdgeTop").style = "Continuous";
  dataRange.format.borders.getItem("EdgeBottom").style = "Continuous";
  dataRange.format.borders.getItem("EdgeLeft").style = "Continuous";
  dataRange.format.borders.getItem("EdgeRight").style = "Continuous";

  await context.sync();

  const totalRow = sheet.getRange("A6:D6");
  totalRow.format.fill.color = "#D9E1F2";
  totalRow.format.font.bold = true;

  // Return focus to the workbook.
  workbook.focus(); // This API is only supported on desktop. In Excel on the web, you must manually return focus to the worksheet after clicking the task pane button.

  await context.sync();

  console.log("Applied formatting with undo grouping. Use Ctrl+Z (Cmd+Z on Mac) once to undo all changes.");
});

Propriedades

delayForCellEdit

Determina se o Excel atrasará a solicitação em lote até que o usuário saia do modo de edição de célula.

Quando false, se o usuário estiver na edição de célula quando a solicitação em lote for processada pelo host, o lote falhará automaticamente. Quando true, a solicitação em lote é executada imediatamente se o usuário não estiver no modo de edição de célula, mas se o usuário estiver no modo de edição de célula, a solicitação em lote será adiada até que o usuário saia do modo de edição de célula. O comportamento padrão sem nenhuma delayForCellEdit propriedade especificada é equivalente a quando é false.

Detalhes da propriedade

delayForCellEdit

Determina se o Excel atrasará a solicitação em lote até que o usuário saia do modo de edição de célula.

Quando false, se o usuário estiver na edição de célula quando a solicitação em lote for processada pelo host, o lote falhará automaticamente. Quando true, a solicitação em lote é executada imediatamente se o usuário não estiver no modo de edição de célula, mas se o usuário estiver no modo de edição de célula, a solicitação em lote será adiada até que o usuário saia do modo de edição de célula. O comportamento padrão sem nenhuma delayForCellEdit propriedade especificada é equivalente a quando é false.

delayForCellEdit?: boolean;

Valor da propriedade

boolean