ExcelScript.Worksheet interface

Ative a planilha na interface do usuário do Excel.

activate(): void;

Retornos

Exemplos

/**
 * This script switches the active view to a worksheet named "Data", if it exists.
 */
function main(workbook: ExcelScript.Workbook) {
  // Check if the "Data" worksheet exists.
  let dataWorksheet = workbook.getWorksheet("Data");
  if (dataWorksheet) {
    // Switch to the "Data" worksheet.
    dataWorksheet.activate();
  } else {
    console.log(`No worksheet named "Data" in this workbook.`);
  }
}

Cria um novo gráfico.

addChart(
            type: ChartType,
            sourceData: Range,
            seriesBy?: ChartSeriesBy
        ): Chart;

Parâmetros

Retornos

Exemplos

/**
 * This sample creates a column-clustered chart based on the current worksheet's data.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get the data range.
  let range = selectedSheet.getUsedRange();

  // Insert a chart using the data on the current worksheet.
  let chart = selectedSheet.addChart(ExcelScript.ChartType.columnClustered, range);

  // Name the chart for easy access in other scripts.
  chart.setName("ColumnChart");
}

Cria um novo comentário com o conteúdo fornecido na célula especificada. É InvalidArgument apresentado um erro se o intervalo fornecido for maior do que uma célula.

addComment(
            cellAddress: Range | string,
            content: CommentRichContent | string,
            contentType?: ContentType
        ): Comment;

Parâmetros

Retornos

Adiciona uma forma geométrica à planilha. Devolve um Shape objeto que representa a nova forma.

addGeometricShape(geometricShapeType: GeometricShapeType): Shape;

Parâmetros

Retornos

Exemplos

/**
 * This script creates a hexagon shape on the current worksheet.
 */
function main(workbook: ExcelScript.Workbook) {
  const currentSheet = workbook.getActiveWorksheet();
  const hexagon: ExcelScript.Shape = 
    currentSheet.addGeometricShape(ExcelScript.GeometricShapeType.hexagon);
  
  // Set the hexagon size to 40x40 pixels.
  hexagon.setHeight(40);
  hexagon.setWidth(40);

  // Position the hexagon at [100,100] pixels.
  hexagon.setLeft(100);
  hexagon.setTop(100);
}

Um subconjunto de formas na planilha do conjunto de grupos. Devolve um Shape objeto que representa o novo grupo de formas.

addGroup(values: Array<string | Shape>): Shape;

Parâmetros

Retornos

Adiciona uma quebra de página antes da célula superior esquerda do intervalo especificado.

addHorizontalPageBreak(pageBreakRange: Range | string): PageBreak;

Parâmetros

Retornos

Cria uma imagem de uma cadeia de caracteres na base 64 e a adiciona à planilha. Devolve o Shape objeto que representa a nova imagem.

addImage(base64ImageString: string): Shape;

Parâmetros

Retornos

Exemplos

/**
 * This sample copies an image from a URL. 
 * This could be used to copy photos that a colleague stored in a shared folder to a related workbook.
 */
async function main(workbook: ExcelScript.Workbook) {
  // Fetch the image from a URL.
  const link = "https://raw.githubusercontent.com/OfficeDev/office-scripts-docs/master/docs/images/git-octocat.png";
  const response = await fetch(link);

  // Store the response as an ArrayBuffer, since it is a raw image file.
  const data = await response.arrayBuffer();

  // Convert the image data into a base64-encoded string.
  const image = convertToBase64(data);

  // Add the image to the current worksheet.
  workbook.getActiveWorksheet().addImage(image);
}

/**
 * Converts an ArrayBuffer containing a .png image into a base64-encoded string.
 */
function convertToBase64(input: ArrayBuffer) {
  const uInt8Array = new Uint8Array(input);
  const count = uInt8Array.length;

  // Allocate the necessary space up front.
  const charCodeArray = new Array<string>(count) 
  
  // Convert every entry in the array to a character.
  for (let i = count; i >= 0; i--) { 
    charCodeArray[i] = String.fromCharCode(uInt8Array[i]);
  }

  // Convert the characters to base64.
  const base64 = btoa(charCodeArray.join(''));
  return base64;
}

Adiciona uma linha à planilha. Devolve um Shape objeto que representa a nova linha.

addLine(
            startLeft: number,
            startTop: number,
            endLeft: number,
            endTop: number,
            connectorType?: ConnectorType
        ): Shape;

Parâmetros

Retornos

Adiciona um novo nome à coleção do escopo fornecido.

addNamedItem(
            name: string,
            reference: Range | string,
            comment?: string
        ): NamedItem;

Parâmetros

Retornos

Adiciona um novo nome à coleção de escopo fornecido usando a localidade do usuário para a fórmula.

addNamedItemFormulaLocal(
            name: string,
            formula: string,
            comment?: string
        ): NamedItem;

Parâmetros

Retornos

Cria uma nova vista de folha com o nome especificado.

addNamedSheetView(name: string): NamedSheetView;

Parâmetros

Retornos

Adicione uma tabela dinâmica com base nos dados de origem especificados e insira-a na célula superior esquerda do intervalo de destino.

addPivotTable(
            name: string,
            source: Range | string | Table,
            destination: Range | string
        ): PivotTable;

Parâmetros

Retornos

Exemplos

/**
 * This script creates a PivotTable from an existing table and adds it to a new worksheet.
 * This script assumes there is a table in the current worksheet with columns named "Type" and "Sales".
 */
function main(workbook: ExcelScript.Workbook) {
  // Create a PivotTable based on a table in the current worksheet.
  let sheet = workbook.getActiveWorksheet();
  let table = sheet.getTables()[0];

  // Add the PivotTable to a new worksheet.
  let newSheet = workbook.addWorksheet("Pivot");
  let pivotTable = newSheet.addPivotTable("My Pivot", table, "A1");

  // Add fields to the PivotTable to show "Sales" per "Type".
  pivotTable.addRowHierarchy(pivotTable.getHierarchy("Type"));
  pivotTable.addDataHierarchy(pivotTable.getHierarchy("Sales"));

  // Switch to the new worksheet.
  newSheet.activate();
}

Adiciona uma nova segmentação de dados à pasta de trabalho.

addSlicer(
            slicerSource: string | PivotTable | Table,
            sourceField: string | PivotField | number | TableColumn,
            slicerDestination?: string | Worksheet
        ): Slicer;

Parâmetros

Retornos

Exemplos

/**
 * This script adds a slicer for an existing PivotTable on the current worksheet.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first PivotTable from the current worksheet.
  const currentSheet = workbook.getActiveWorksheet();
  const pivot = currentSheet.getPivotTables()[0];

  // Create the slicer. 
  // Note that this assumes "Type" is already added as a hierarchy to the PivotTable.
  const slicer = currentSheet.addSlicer(
    pivot, /* The table or PivotTale to be sliced. */
    pivot.getHierarchy("Type").getFields()[0] /* What source field to use as the slicer options. */
  );

  // Select the items to display.
  slicer.selectItems(["Lemon", "Lime"]);

  // Set the left margin of the slicer.
  slicer.setLeft(400);
}

Cria uma nova tabela. O objeto de intervalo ou endereço de origem determina a planilha à qual a tabela será adicionada. Se a tabela não puder ser adicionada (por exemplo, porque o endereço é inválido ou a tabela se sobreporia a outra), será gerado um erro.

addTable(address: Range | string, hasHeaders: boolean): Table;

Parâmetros

Retornos

Exemplos

/**
 * This sample creates a table from the current worksheet's used range, then sorts it based on the first column.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Create a table with the used cells.
  let usedRange = selectedSheet.getUsedRange();
  let newTable = selectedSheet.addTable(usedRange, true);

  // Sort the table using the first column.
  newTable.getSort().apply([{ key: 0, ascending: true }]);
}

Adiciona uma caixa de texto na planilha com o texto fornecido como conteúdo. Devolve um Shape objeto que representa a nova caixa de texto.

addTextBox(text?: string): Shape;

Parâmetros

Retornos

Adiciona uma quebra de página antes da célula superior esquerda do intervalo especificado.

addVerticalPageBreak(pageBreakRange: Range | string): PageBreak;

Parâmetros

Retornos

Adiciona uma nova propriedade personalizada que mapeia à chave fornecida. Esta ação substitui as propriedades personalizadas existentes por essa chave.

addWorksheetCustomProperty(
            key: string,
            value: string
        ): WorksheetCustomProperty;

Parâmetros

Retornos

Calcula todas as células em uma planilha.

calculate(markAllDirty: boolean): void;

Parâmetros

Retornos

Copia uma folha de cálculo e coloca-a na posição especificada.

copy(
            positionType?: WorksheetPositionType,
            relativeTo?: Worksheet
        ): Worksheet;

Parâmetros

Retornos

Exemplos

/**
 * This script duplicates a worksheet named "Template". 
 * The new worksheet is added after the template.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the worksheet named "Template".
  let template = workbook.getWorksheet("Template");

  // Copy the worksheet.
  let newSheet = template.copy(
    ExcelScript.WorksheetPositionType.after,
    template
  );

  // Name the worksheet using the current date.
  let date = new Date(Date.now());
  newSheet.setName(`${date.toDateString()}`);
}

Exclui a planilha da pasta de trabalho. Tenha em atenção que se a visibilidade da folha de cálculo estiver definida como "VeryHidden", a operação de eliminação falhará com uma exceção InvalidOperation . Primeiro, deve alterar a visibilidade para oculta ou visível antes de a eliminar.

delete(): void;

Retornos

Exemplos

/**
 * The following scripts removes the first worksheet in the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first worksheet.
  let sheet = workbook.getWorksheets()[0];

  // Remove that worksheet from the workbook.
  sheet.delete();
}

Cria e ativa uma nova vista de folha temporária. As vistas temporárias são removidas ao fechar a aplicação, ao sair da vista temporária com o método de saída ou ao mudar para outra vista de folha. A vista de folha temporária também pode ser acedida com a cadeia vazia (""), se a vista temporária existir.

enterTemporaryNamedSheetView(): NamedSheetView;

Retornos

Sai da vista de folha atualmente ativa.

exitActiveNamedSheetView(): void;

Retornos

Localiza todas as ocorrências da cadeia especificada com base nos critérios especificados e devolve-as como um RangeAreas objeto, composto por um ou mais intervalos retangulares.

findAll(text: string, criteria: WorksheetSearchCriteria): RangeAreas;

Parâmetros

Retornos

Exemplos

/**
 * This script searches through a worksheet and finds cells containing "No". 
 * Those cells are filled with the color red.
 * Use Range.find instead of Worksheet.findAll when you want to limit the search to a specific range.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current, active worksheet.
  let worksheet = workbook.getActiveWorksheet();
  let noCells = worksheet.findAll("No", { completeMatch: true });

  // Set the fill color to red.
  noCells.getFormat().getFill().setColor("red");
}

Obtém a vista de folha de cálculo atualmente ativa.

getActiveNamedSheetView(): NamedSheetView;

Retornos

Representa o AutoFilter objeto da folha de cálculo.

getAutoFilter(): AutoFilter;

Retornos

Exemplos

/**
 * This script creates an autoFilter on the worksheet that filters out rows based on column values. 
 * The autoFilter filters to only include rows that have a value in column D in the top 10 percentile 
 * (of column D values).
 */
function main(workbook: ExcelScript.Workbook) {
  const currentSheet = workbook.getActiveWorksheet();
  const dataRange = currentSheet.getUsedRange();

  // Add a filter that will only show the rows with the top 10% of values in column D
  // (index 3, assuming the used range spans from at least A:D).
  currentSheet.getAutoFilter().apply(dataRange, 3, {
    criterion1: "10",
    filterOn: ExcelScript.FilterOn.topPercent
  });
}

Obtém o Range objeto que contém a única célula com base nos números de linha e coluna. A célula pode estar fora dos limites do respetivo intervalo principal, desde que permaneça na grelha da folha de cálculo.

getCell(row: number, column: number): Range;

Parâmetros

Retornos

Obtém um gráfico usando o respectivo nome. Quando houver vários gráficos com o mesmo nome, o sistema retornará o primeiro deles. Se o gráfico não existir, este método devolve undefined.

getChart(name: string): Chart | undefined;

Parâmetros

Retornos

Exemplos

/**
 * This sample moves an existing chart to a specific place on the worksheet.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();
  
  // Get an existing chart named "ColumnChart".
  let chart = selectedSheet.getChart("ColumnChart");

  // Place the chart over the range "F1:L13".
  chart.setPosition("F1", "L13");
}

Devolve uma coleção de gráficos que fazem parte da folha de cálculo.

getCharts(): Chart[];

Retornos

Obtém um comentário da coleção com base em seu ID. Se o objeto de comentário não existir, este método devolve undefined.

getComment(commentId: string): Comment | undefined;

Parâmetros

Retornos

Obtém o comentário da célula especificada. Se não existir nenhum comentário na célula, é gerado um erro.

getCommentByCell(cellAddress: Range | string): Comment;

Parâmetros

Retornos

Obtém o comentário ao qual a resposta especificada está ligada.

getCommentByReplyId(replyId: string): Comment;

Parâmetros

Retornos

Retorna um conjunto de todos os objetos Comments na planilha.

getComments(): Comment[];

Retornos

Obtém uma coleção de propriedades personalizadas ao nível da folha de cálculo.

getCustomProperties(): WorksheetCustomProperty[];

Retornos

Determina se o Excel deve recalcular a folha de cálculo quando necessário. Verdadeiro se o Excel recalcular a folha de cálculo quando necessário. False se o Excel não recalcular a planilha.

getEnableCalculation(): boolean;

Retornos

Obtém um objeto que pode ser utilizado para manipular painéis congelados na folha de cálculo.

getFreezePanes(): WorksheetFreezePanes;

Retornos

Obtém a coleção de quebra de página horizontal da planilha. Esta coleção contém apenas quebras de página manuais.

getHorizontalPageBreaks(): PageBreak[];

Retornos

Retorna um valor que identifica de forma exclusiva a planilha em uma determinada pasta de trabalho. O valor do identificador permanece o mesmo, ainda que a planilha seja renomeada ou movida.

getId(): string;

Retornos

O nome de exibição da planilha. O nome tem de ter menos de 32 carateres.

getName(): string;

Retornos

Exemplos

/**
 * This sample gets all the worksheet names in the workbook.
 * It then logs those names to the console.
 */
function main(workbook: ExcelScript.Workbook) {
    // Create an array to hold the worksheet names.
    let worksheetNames = [];

    // Iterate over the worksheet collection in the workbook.
    for (let worksheet of workbook.getWorksheets()) {
        worksheetNames.push(worksheet.getName());
    }

    // Log the array of worksheet names.
    console.log(worksheetNames);
}

Obtém um NamedItem objeto com o respetivo nome. Se o objeto não existir, este método devolve undefined.

getNamedItem(name: string): NamedItem | undefined;

Parâmetros

Retornos

Obtém uma vista de folha com o respetivo nome. Se o objeto de vista de folha não existir, este método devolve undefined.

getNamedSheetView(key: string): NamedSheetView | undefined;

Parâmetros

Retornos

Devolve uma coleção de vistas de folha que estão presentes na folha de cálculo.

getNamedSheetViews(): NamedSheetView[];

Retornos

Coleção de nomes com escopo para a planilha atual.

getNames(): NamedItem[];

Retornos

Obtém a folha de cálculo que se segue a esta. Se não existirem folhas de cálculo a seguir a esta, este método devolve undefined.

getNext(visibleOnly?: boolean): Worksheet;

Parâmetros

Retornos

Obtém o PageLayout objeto da folha de cálculo.

getPageLayout(): PageLayout;

Retornos

Exemplos

/**
 * This script sets the printing orientation for the entire workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Go to each worksheet so the print settings are consistent.
  workbook.getWorksheets().forEach((sheet) => {
    const pageLayout = sheet.getPageLayout();

    // Print every page with a landscape orientation.
    pageLayout.setOrientation(ExcelScript.PageOrientation.landscape);
  });
}

Obtém uma Tabela Dinâmica por nome. Se a tabela dinâmica não existir, este método devolve undefined.

getPivotTable(name: string): PivotTable | undefined;

Parâmetros

Retornos

Coleção de Tabelas Dinâmicas que fazem parte da planilha.

getPivotTables(): PivotTable[];

Retornos

A posição baseada em zero da planilha na pasta de trabalho.

getPosition(): number;

Retornos

Obtém a folha de cálculo que precede esta. Se não existirem folhas de cálculo anteriores, este método devolve undefined.

getPrevious(visibleOnly?: boolean): Worksheet;

Parâmetros

Retornos

Devolve o objeto de proteção de folha para uma folha de cálculo.

getProtection(): WorksheetProtection;

Retornos

Exemplos

/**
 * This script protects cells from being selected on the current worksheet.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the protection settings for the current worksheet.
  const currentSheet = workbook.getActiveWorksheet();
  const sheetProtection = currentSheet.getProtection();

  // Create a new WorksheetProtectionOptions object with the selectionMode property set to `none`.
  let protectionOptions : ExcelScript.WorksheetProtectionOptions = {
    selectionMode: ExcelScript.ProtectionSelectionMode.none
  }

  // Apply the given protection options.
  sheetProtection.protect(protectionOptions);
}

Obtém o Range objeto, representando um único bloco retangular de células, especificado pelo endereço ou nome.

getRange(address?: string): Range;

Parâmetros

Retornos

Exemplos

/**
 * This sample reads the value of A1 and prints it to the console.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get the value of cell A1.
  let range = selectedSheet.getRange("A1");
  
  // Print the value of A1.
  console.log(range.getValue());
}

Obtém o Range objeto a começar num índice de linha e índice de colunas específico e abrange um determinado número de linhas e colunas.

getRangeByIndexes(
            startRow: number,
            startColumn: number,
            rowCount: number,
            columnCount: number
        ): Range;

Parâmetros

Retornos

Obtém o RangeAreas objeto, representando um ou mais blocos de intervalos retangulares, especificados pelo endereço ou nome.

getRanges(address?: string): RangeAreas;

Parâmetros

Retornos

Obtém uma forma com o respetivo nome ou ID. Se o objeto da forma não existir, este método devolve undefined.

getShape(key: string): Shape | undefined;

Parâmetros

Retornos

Retorna a coleção de todos os objetos Shape na planilha.

getShapes(): Shape[];

Retornos

Especifica se as linhas de grelha estão visíveis para o utilizador.

getShowGridlines(): boolean;

Retornos

Especifica se os cabeçalhos estão visíveis para o utilizador.

getShowHeadings(): boolean;

Retornos

Obtém uma segmentação de dados com o respetivo nome ou ID. Se a segmentação de dados não existir, este método devolve undefined.

getSlicer(key: string): Slicer | undefined;

Parâmetros

Retornos

Devolve uma coleção de segmentações de dados que fazem parte da folha de cálculo.

getSlicers(): Slicer[];

Retornos

Retorna a altura padrão de todas as linhas na planilha, em pontos.

getStandardHeight(): number;

Retornos

Especifica a largura padrão (predefinida) de todas as colunas na folha de cálculo. Uma unidade de largura de coluna equivale à largura de um caractere no estilo Normal. Para fontes proporcionais, será usada a largura do caractere 0 (zero).

getStandardWidth(): number;

Retornos

A cor do separador da folha de cálculo. Ao obter a cor do separador, se a folha de cálculo for invisível, o valor será null. Se a folha de cálculo estiver visível, mas a cor do separador estiver definida como automática, será devolvida uma cadeia vazia. Caso contrário, a propriedade será definida como uma cor, no formato #RRGGBB (por exemplo, "FFA500"). Ao definir a cor, utilize uma cadeia vazia para definir uma cor "automática" ou uma cor real.

getTabColor(): string;

Retornos

Devolve um valor que representa esta folha de cálculo que pode ser lida por Open Office XML. Trata-se de um valor inteiro, diferente de worksheet.id (que devolve um identificador exclusivo global) e worksheet.name (que devolve um valor como "Folha1").

getTabId(): number;

Retornos

Obtém uma tabela pelo nome ou ID. Se a tabela não existir, este método devolve undefined.

getTable(key: string): Table | undefined;

Parâmetros

Retornos

Coleção de tabelas que fazem parte da planilha.

getTables(): Table[];

Retornos

getUsedRange(valuesOnly?: boolean): Range;

Parâmetros

Retornos

Obtém a coleção de quebra de página vertical da planilha. Esta coleção contém apenas quebras de página manuais.

getVerticalPageBreaks(): PageBreak[];

Retornos

A visibilidade da planilha.

getVisibility(): SheetVisibility;

Retornos

Obtém um objeto de propriedade personalizada por sua chave, que diferencia maiúsculas de minúsculas. Se a propriedade personalizada não existir, este método devolve undefined.

getWorksheetCustomProperty(
            key: string
        ): WorksheetCustomProperty | undefined;

Parâmetros

Retornos

Atualiza todas as tabelas dinâmicas da coleção.

refreshAllPivotTables(): void;

Retornos

Redefine todas as quebras de página manuais na coleção.

removeAllHorizontalPageBreaks(): void;

Retornos

Redefine todas as quebras de página manuais na coleção.

removeAllVerticalPageBreaks(): void;

Retornos

Localiza e substitui a cadeia de caracteres fornecida com base nos critérios especificados na planilha atual.

replaceAll(
            text: string,
            replacement: string,
            criteria: ReplaceCriteria
        ): number;

Parâmetros

Retornos

Determina se o Excel deve recalcular a folha de cálculo quando necessário. Verdadeiro se o Excel recalcular a folha de cálculo quando necessário. False se o Excel não recalcular a planilha.

setEnableCalculation(enableCalculation: boolean): void;

Parâmetros

Retornos

O nome de exibição da planilha. O nome tem de ter menos de 32 carateres.

setName(name: string): void;

Parâmetros

Retornos

Exemplos

/**
 * This sample renames a worksheet from "Sheet1" to "SALES".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get a worksheet named "Sheet1".
  const sheet = workbook.getWorksheet('Sheet1'); 

  // Set its name to SALES.
  sheet.setName('SALES');
}

A posição baseada em zero da planilha na pasta de trabalho.

setPosition(position: number): void;

Parâmetros

Retornos

Exemplos

/**
 * This sample sets the worksheet named "SALES" as the first sheet in the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get a worksheet named "SALES".
  const sheet = workbook.getWorksheet('SALES'); 
  // Position the worksheet at the beginning of the workbook.
  sheet.setPosition(0);
}

Especifica se as linhas de grelha estão visíveis para o utilizador.

setShowGridlines(showGridlines: boolean): void;

Parâmetros

Retornos

Especifica se os cabeçalhos estão visíveis para o utilizador.

setShowHeadings(showHeadings: boolean): void;

Parâmetros

Retornos

Especifica a largura padrão (predefinida) de todas as colunas na folha de cálculo. Uma unidade de largura de coluna equivale à largura de um caractere no estilo Normal. Para fontes proporcionais, será usada a largura do caractere 0 (zero).

setStandardWidth(standardWidth: number): void;

Parâmetros

Retornos

A cor do separador da folha de cálculo. Ao obter a cor do separador, se a folha de cálculo for invisível, o valor será null. Se a folha de cálculo estiver visível, mas a cor do separador estiver definida como automática, será devolvida uma cadeia vazia. Caso contrário, a propriedade será definida como uma cor, no formato #RRGGBB (por exemplo, "FFA500"). Ao definir a cor, utilize uma cadeia vazia para definir uma cor "automática" ou uma cor real.

setTabColor(tabColor: string): void;

Parâmetros

Retornos

Exemplos

/**
 * This script sets the tab color of every worksheet in the workbook to red.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get all the worksheets in the workbook. 
  let sheets = workbook.getWorksheets();
  
  // Set the tab color of each worksheet to a random color.
  for (let sheet of sheets) {    
    // Set the color of the current worksheet's tab to red.
    sheet.setTabColor("red");
  }
}

A visibilidade da planilha.

setVisibility(visibility: SheetVisibility): void;

Parâmetros

Retornos

Exemplos

/**
 * This script unhides all the worksheets in the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Iterate over each worksheet.
  workbook.getWorksheets().forEach((worksheet) => {
    // Set the worksheet visibility to visible.
    worksheet.setVisibility(ExcelScript.SheetVisibility.visible);
  });
}

Mostra grupos de linhas ou colunas pelos respetivos níveis hierárquico. Descreve grupos e resume uma lista de dados na folha de cálculo. Os rowLevels parâmetros e columnLevels especificam quantos níveis do destaque serão apresentados. O intervalo de argumentos aceitável está entre 0 e 8. Um valor de 0 não altera a apresentação atual. Um valor maior do que o número atual de níveis apresenta todos os níveis.

showOutlineLevels(rowLevels: number, columnLevels: number): void;

Parâmetros

Retornos