ExcelScript.PageLayout interface

A opção de impressão a preto e branco da folha de cálculo.

getBlackAndWhite(): boolean;

Retornos

A margem inferior da página da folha de cálculo a utilizar para imprimir em pontos.

getBottomMargin(): number;

Retornos

O sinalizador horizontal central da folha de cálculo. Esse sinalizador determina se a planilha será centralizada horizontalmente quando for impressa.

getCenterHorizontally(): boolean;

Retornos

O sinalizador central da folha de cálculo é sinalizador verticalmente. Esse sinalizador determina se a planilha será centralizada verticalmente quando for impressa.

getCenterVertically(): boolean;

Retornos

A opção modo de rascunho da folha de cálculo. Se true, a folha será impressa sem gráficos.

getDraftMode(): boolean;

Retornos

O número da primeira página da folha de cálculo a imprimir. Um null valor representa a numeração de página "automática".

getFirstPageNumber(): number | "";

Retornos

A margem de rodapé da folha de cálculo, em pontos, para utilização ao imprimir.

getFooterMargin(): number;

Retornos

A margem de cabeçalho da folha de cálculo, em pontos, para utilização ao imprimir.

getHeaderMargin(): number;

Retornos

Configuração de cabeçalho e rodapé da planilha.

getHeadersFooters(): HeaderFooterGroup;

Retornos

A margem esquerda da folha de cálculo, em pontos, para utilização ao imprimir.

getLeftMargin(): number;

Retornos

A orientação da folha de cálculo da página.

getOrientation(): PageOrientation;

Retornos

O tamanho do papel da página da folha de cálculo.

getPaperSize(): PaperType;

Retornos

Obtém o RangeAreas objeto, composto por um ou mais intervalos retangulares, que representa a área de impressão da folha de cálculo. Se não existir nenhuma área de impressão, este método devolve undefined.

getPrintArea(): RangeAreas;

Retornos

Especifica se os comentários da folha de cálculo devem ser apresentados ao imprimir.

getPrintComments(): PrintComments;

Retornos

A opção de erros de impressão da folha de cálculo.

getPrintErrors(): PrintErrorType;

Retornos

Especifica se as linhas de grelha da folha de cálculo serão impressas.

getPrintGridlines(): boolean;

Retornos

Especifica se os cabeçalhos da folha de cálculo serão impressos.

getPrintHeadings(): boolean;

Retornos

A opção de ordem de impressão da página da folha de cálculo. Isso especifica a ordem que será usada para processar o número de página impresso.

getPrintOrder(): PrintOrder;

Retornos

Obtém o objeto range que representa as colunas de título. Se não estiver definido, este método devolve undefined.

getPrintTitleColumns(): Range;

Retornos

Obtém o objeto range representando as linhas do título. Se não estiver definido, este método devolve undefined.

getPrintTitleRows(): Range;

Retornos

A margem direita da folha de cálculo, em pontos, para utilização ao imprimir.

getRightMargin(): number;

Retornos

A margem superior da folha de cálculo, em pontos, para utilização ao imprimir.

getTopMargin(): number;

Retornos

As opções de zoom de impressão da folha de cálculo. O PageLayoutZoomOptions objeto tem de ser definido como um objeto JSON (utilize x.zoom = {...} em vez de x.zoom.scale = ...).

getZoom(): PageLayoutZoomOptions;

Retornos

A opção de impressão a preto e branco da folha de cálculo.

setBlackAndWhite(blackAndWhite: boolean): void;

Parâmetros

Retornos

A margem inferior da página da folha de cálculo a utilizar para imprimir em pontos.

setBottomMargin(bottomMargin: number): void;

Parâmetros

Retornos

O sinalizador horizontal central da folha de cálculo. Esse sinalizador determina se a planilha será centralizada horizontalmente quando for impressa.

setCenterHorizontally(centerHorizontally: boolean): void;

Parâmetros

Retornos

O sinalizador central da folha de cálculo é sinalizador verticalmente. Esse sinalizador determina se a planilha será centralizada verticalmente quando for impressa.

setCenterVertically(centerVertically: boolean): void;

Parâmetros

Retornos

A opção modo de rascunho da folha de cálculo. Se true, a folha será impressa sem gráficos.

setDraftMode(draftMode: boolean): void;

Parâmetros

Retornos

Exemplos

/**
 * This script turns off the print setting for draft mode.
 */
function main(workbook: ExcelScript.Workbook) {
  // Go to each worksheet so the print settings are consistent.
  workbook.getWorksheets().forEach((sheet) => {
    const pageLayout = sheet.getPageLayout();

    // Turn off draft mode so images are printed.
    pageLayout.setDraftMode(false);
  });
}

O número da primeira página da folha de cálculo a imprimir. Um null valor representa a numeração de página "automática".

setFirstPageNumber(firstPageNumber: number | ""): void;

Parâmetros

Retornos

A margem de rodapé da folha de cálculo, em pontos, para utilização ao imprimir.

setFooterMargin(footerMargin: number): void;

Parâmetros

Retornos

A margem de cabeçalho da folha de cálculo, em pontos, para utilização ao imprimir.

setHeaderMargin(headerMargin: number): void;

Parâmetros

Retornos

A margem esquerda da folha de cálculo, em pontos, para utilização ao imprimir.

setLeftMargin(leftMargin: number): void;

Parâmetros

Retornos

A orientação da folha de cálculo da página.

setOrientation(orientation: PageOrientation): void;

Parâmetros

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);
  });
}

O tamanho do papel da página da folha de cálculo.

setPaperSize(paperSize: PaperType): void;

Parâmetros

Retornos

Exemplos

/**
 * This script sets the page size for printing.
 */
function main(workbook: ExcelScript.Workbook) {
  // Go to each worksheet so the print settings are consistent.
  workbook.getWorksheets().forEach((sheet) => {
    const pageLayout = sheet.getPageLayout();
    // Print on 8.5"x11" paper.
    pageLayout.setPaperSize(ExcelScript.PaperType.letter);
  });
}

Define a área de impressão da planilha.

setPrintArea(printArea: Range | RangeAreas | string): void;

Parâmetros

Retornos

Especifica se os comentários da folha de cálculo devem ser apresentados ao imprimir.

setPrintComments(printComments: PrintComments): void;

Parâmetros

Retornos

Exemplos

/**
 * This script makes the comments print at the end of the worksheet
 * when the workbook is printed.
 */
function main(workbook: ExcelScript.Workbook) {
  // Access every worksheet in the workbook.
  workbook.getWorksheets().forEach(worksheet => {
    // Get the page layout for each sheet.
    const layout = worksheet.getPageLayout();

    // Change the comment printing settings to print them at the end of the sheet.
    layout.setPrintComments(ExcelScript.PrintComments.endSheet);
  });
}

A opção de erros de impressão da folha de cálculo.

setPrintErrors(printErrors: PrintErrorType): void;

Parâmetros

Retornos

Especifica se as linhas de grelha da folha de cálculo serão impressas.

setPrintGridlines(printGridlines: boolean): void;

Parâmetros

Retornos

Especifica se os cabeçalhos da folha de cálculo serão impressos.

setPrintHeadings(printHeadings: boolean): void;

Parâmetros

Retornos

Define as margens das páginas da planilha com unidades.

setPrintMargins(
            unit: PrintMarginUnit,
            marginOptions: PageLayoutMarginOptions
        ): void;

Parâmetros

Retornos

A opção de ordem de impressão da página da folha de cálculo. Isso especifica a ordem que será usada para processar o número de página impresso.

setPrintOrder(printOrder: PrintOrder): void;

Parâmetros

Retornos

Exemplos

/**
 * This script sets the print order for every worksheet in the workbook.
 * The order of printed content will go over (e.g., left-to-right) 
 * then down (i.e., top-to-bottom).
 */
function main(workbook: ExcelScript.Workbook) {
  // Access every worksheet in the workbook.
  workbook.getWorksheets().forEach(worksheet => {
    // Get the page layout for each sheet.
    const layout: ExcelScript.PageLayout = worksheet.getPageLayout();

    // Set the print order to over-then-down.
    layout.setPrintOrder(ExcelScript.PrintOrder.overThenDown);
  });
}

Define as colunas que contêm as células que serão repetidas à esquerda de cada página da planilha para impressão.

setPrintTitleColumns(printTitleColumns: Range | string): void;

Parâmetros

Retornos

Define as linhas que contêm as células que serão repetidas na parte de cada página da planilha para impressão.

setPrintTitleRows(printTitleRows: Range | string): void;

Parâmetros

Retornos

A margem direita da folha de cálculo, em pontos, para utilização ao imprimir.

setRightMargin(rightMargin: number): void;

Parâmetros

Retornos

A margem superior da folha de cálculo, em pontos, para utilização ao imprimir.

setTopMargin(topMargin: number): void;

Parâmetros

Retornos

As opções de zoom de impressão da folha de cálculo. O PageLayoutZoomOptions objeto tem de ser definido como um objeto JSON (utilize x.zoom = {...} em vez de x.zoom.scale = ...).

setZoom(zoom: PageLayoutZoomOptions): void;

Parâmetros

Retornos

Exemplos

/**
 * This script changes the scale-to-fit of the page layout.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get the current worksheet.
    const sheet = workbook.getActiveWorksheet();

    // Scale the layout to half size for printing.
    const layout = sheet.getPageLayout();
    const zoomOptions: ExcelScript.PageLayoutZoomOptions = {
        scale: 50
    }
    layout.setZoom(zoomOptions)
}