ExcelScript.PageLayout interface

Пакет:: ExcelScript

Представляет параметры макета и печати, которые не зависят от реализации принтера. Эти параметры включают поля, ориентацию, нумерацию страницы, строки заголовков и область печати.

Замечания

Примеры

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

    // Turn off draft mode so images are printed.
    pageLayout.setDraftMode(false);
    
    // Print on 8.5"x11" paper.
    pageLayout.setPaperSize(ExcelScript.PaperType.letter);

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

Методика

getBlackAndWhite()	Параметр черно-белой печати листа.
getBottomMargin()	Нижнее поле страницы листа, используемое для печати в точках.
getCenterHorizontally()	Центр листа по горизонтали. Эта отметка определяет, выравнивается ли лист по горизонтали относительно центра при печати.
getCenterVertically()	По центру листа по вертикали. Эта отметка определяет, выравнивается ли лист по вертикали относительно центра при печати.
getDraftMode()	Параметр режима черновика листа. Если `true`значение , лист будет напечатан без графики.
getFirstPageNumber()	Номер первой страницы листа для печати. Значение `null` представляет "автоматическую" нумеровку страниц.
getFooterMargin()	Поле нижнего колонтитула листа (в пунктах) для использования при печати.
getHeaderMargin()	Поле заголовка листа (в пунктах) для использования при печати.
getHeadersFooters()	Настройка колонтитулов для листа.
getLeftMargin()	Левое поле листа (в пунктах) для использования при печати.
getOrientation()	Ориентация листа страницы.
getPaperSize()	Размер бумаги листа страницы.
getPrintArea()	Возвращает объект , состоящий `RangeAreas` из одного или нескольких прямоугольных диапазонов, который представляет область печати для листа. Если области печати нет, этот метод возвращает `undefined`.
getPrintComments()	Указывает, должны ли примечания листа отображаться при печати.
getPrintErrors()	Параметр ошибок печати листа.
getPrintGridlines()	Указывает, будут ли печататься линии сетки листа.
getPrintHeadings()	Указывает, будут ли печататься заголовки листа.
getPrintOrder()	Параметр порядка печати страницы листа. Определяет порядок, использующийся при обработке распечатываемых номеров страниц.
getPrintTitleColumns()	Получает объект range, представляющий столбцы заголовков. Если значение не задано, этот метод возвращает `undefined`.
getPrintTitleRows()	Получает объект range, представляющий строки заголовков. Если значение не задано, этот метод возвращает `undefined`.
getRightMargin()	Правое поле листа (в пунктах) для использования при печати.
getTopMargin()	Верхнее поле листа (в пунктах) для использования при печати.
getZoom()	Параметры масштабирования листа. Объект `PageLayoutZoomOptions` должен быть задан как объект JSON (используйте `x.zoom = {...}` вместо `x.zoom.scale = ...`).
setBlackAndWhite(blackAndWhite)	Параметр черно-белой печати листа.
setBottomMargin(bottomMargin)	Нижнее поле страницы листа, используемое для печати в точках.
setCenterHorizontally(centerHorizontally)	Центр листа по горизонтали. Эта отметка определяет, выравнивается ли лист по горизонтали относительно центра при печати.
setCenterVertically(centerVertically)	По центру листа по вертикали. Эта отметка определяет, выравнивается ли лист по вертикали относительно центра при печати.
setDraftMode(draftMode)	Параметр режима черновика листа. Если `true`значение , лист будет напечатан без графики.
setFirstPageNumber(firstPageNumber)	Номер первой страницы листа для печати. Значение `null` представляет "автоматическую" нумеровку страниц.
setFooterMargin(footerMargin)	Поле нижнего колонтитула листа (в пунктах) для использования при печати.
setHeaderMargin(headerMargin)	Поле заголовка листа (в пунктах) для использования при печати.
setLeftMargin(leftMargin)	Левое поле листа (в пунктах) для использования при печати.
setOrientation(orientation)	Ориентация листа страницы.
setPaperSize(paperSize)	Размер бумаги листа страницы.
setPrintArea(printArea)	Задает область печати листа.
setPrintComments(printComments)	Указывает, должны ли примечания листа отображаться при печати.
setPrintErrors(printErrors)	Параметр ошибок печати листа.
setPrintGridlines(printGridlines)	Указывает, будут ли печататься линии сетки листа.
setPrintHeadings(printHeadings)	Указывает, будут ли печататься заголовки листа.
setPrintMargins(unit, marginOptions)	Задает поля страницы с единицами измерения для листа.
setPrintOrder(printOrder)	Параметр порядка печати страницы листа. Определяет порядок, использующийся при обработке распечатываемых номеров страниц.
setPrintTitleColumns(printTitleColumns)	Задает столбцы, содержащие ячейки, которые должны повторяться слева на каждой странице при печати листа.
setPrintTitleRows(printTitleRows)	Задает строки, содержащие ячейки, которые должны повторяться сверху каждой страницы при печати листа.
setRightMargin(rightMargin)	Правое поле листа (в пунктах) для использования при печати.
setTopMargin(topMargin)	Верхнее поле листа (в пунктах) для использования при печати.
setZoom(zoom)	Параметры масштабирования листа. Объект `PageLayoutZoomOptions` должен быть задан как объект JSON (используйте `x.zoom = {...}` вместо `x.zoom.scale = ...`).

Подробнее о методе

getBlackAndWhite()

Параметр черно-белой печати листа.

getBlackAndWhite(): boolean;

Возвращает

boolean

getBottomMargin()

Нижнее поле страницы листа, используемое для печати в точках.

getBottomMargin(): number;

Возвращает

number

getCenterHorizontally()

Центр листа по горизонтали. Эта отметка определяет, выравнивается ли лист по горизонтали относительно центра при печати.

getCenterHorizontally(): boolean;

Возвращает

boolean

getCenterVertically()

По центру листа по вертикали. Эта отметка определяет, выравнивается ли лист по вертикали относительно центра при печати.

getCenterVertically(): boolean;

Возвращает

boolean

getDraftMode()

Параметр режима черновика листа. Если trueзначение , лист будет напечатан без графики.

getDraftMode(): boolean;

Возвращает

boolean

getFirstPageNumber()

Номер первой страницы листа для печати. Значение null представляет "автоматическую" нумеровку страниц.

getFirstPageNumber(): number | "";

Возвращает

number | ""

getFooterMargin()

Поле нижнего колонтитула листа (в пунктах) для использования при печати.

getFooterMargin(): number;

Возвращает

number

getHeaderMargin()

Поле заголовка листа (в пунктах) для использования при печати.

getHeaderMargin(): number;

Возвращает

number

getHeadersFooters()

Настройка колонтитулов для листа.

getHeadersFooters(): HeaderFooterGroup;

Возвращает

ExcelScript.HeaderFooterGroup

getLeftMargin()

Левое поле листа (в пунктах) для использования при печати.

getLeftMargin(): number;

Возвращает

number

getOrientation()

Ориентация листа страницы.

getOrientation(): PageOrientation;

Возвращает

ExcelScript.PageOrientation

getPaperSize()

Размер бумаги листа страницы.

getPaperSize(): PaperType;

Возвращает

ExcelScript.PaperType

getPrintArea()

Возвращает объект , состоящий RangeAreas из одного или нескольких прямоугольных диапазонов, который представляет область печати для листа. Если области печати нет, этот метод возвращает undefined.

getPrintArea(): RangeAreas;

Возвращает

ExcelScript.RangeAreas

getPrintComments()

Указывает, должны ли примечания листа отображаться при печати.

getPrintComments(): PrintComments;

Возвращает

ExcelScript.PrintComments

getPrintErrors()

Параметр ошибок печати листа.

getPrintErrors(): PrintErrorType;

Возвращает

ExcelScript.PrintErrorType

getPrintGridlines()

Указывает, будут ли печататься линии сетки листа.

getPrintGridlines(): boolean;

Возвращает

boolean

getPrintHeadings()

Указывает, будут ли печататься заголовки листа.

getPrintHeadings(): boolean;

Возвращает

boolean

getPrintOrder()

Параметр порядка печати страницы листа. Определяет порядок, использующийся при обработке распечатываемых номеров страниц.

getPrintOrder(): PrintOrder;

Возвращает

ExcelScript.PrintOrder

getPrintTitleColumns()

Получает объект range, представляющий столбцы заголовков. Если значение не задано, этот метод возвращает undefined.

getPrintTitleColumns(): Range;

Возвращает

ExcelScript.Range

getPrintTitleRows()

Получает объект range, представляющий строки заголовков. Если значение не задано, этот метод возвращает undefined.

getPrintTitleRows(): Range;

Возвращает

ExcelScript.Range

getRightMargin()

Правое поле листа (в пунктах) для использования при печати.

getRightMargin(): number;

Возвращает

number

getTopMargin()

Верхнее поле листа (в пунктах) для использования при печати.

getTopMargin(): number;

Возвращает

number

getZoom()

Параметры масштабирования листа. Объект PageLayoutZoomOptions должен быть задан как объект JSON (используйте x.zoom = {...} вместо x.zoom.scale = ...).

getZoom(): PageLayoutZoomOptions;

Возвращает

ExcelScript.PageLayoutZoomOptions

setBlackAndWhite(blackAndWhite)

Параметр черно-белой печати листа.

setBlackAndWhite(blackAndWhite: boolean): void;

Параметры

blackAndWhite: boolean

Возвращает

void

setBottomMargin(bottomMargin)

Нижнее поле страницы листа, используемое для печати в точках.

setBottomMargin(bottomMargin: number): void;

Параметры

bottomMargin: number

Возвращает

void

setCenterHorizontally(centerHorizontally)

setCenterHorizontally(centerHorizontally: boolean): void;

Параметры

centerHorizontally: boolean

Возвращает

void

setCenterVertically(centerVertically)

setCenterVertically(centerVertically: boolean): void;

Параметры

centerVertically: boolean

Возвращает

void

setDraftMode(draftMode)

Параметр режима черновика листа. Если trueзначение , лист будет напечатан без графики.

setDraftMode(draftMode: boolean): void;

Параметры

draftMode: boolean

Возвращает

void

Примеры

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

setFirstPageNumber(firstPageNumber)

Номер первой страницы листа для печати. Значение null представляет "автоматическую" нумеровку страниц.

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

Параметры

firstPageNumber: number | ""

Возвращает

void

setFooterMargin(footerMargin)

Поле нижнего колонтитула листа (в пунктах) для использования при печати.

setFooterMargin(footerMargin: number): void;

Параметры

footerMargin: number

Возвращает

void

setHeaderMargin(headerMargin)

Поле заголовка листа (в пунктах) для использования при печати.

setHeaderMargin(headerMargin: number): void;

Параметры

headerMargin: number

Возвращает

void

setLeftMargin(leftMargin)

Левое поле листа (в пунктах) для использования при печати.

setLeftMargin(leftMargin: number): void;

Параметры

leftMargin: number

Возвращает

void

setOrientation(orientation)

Ориентация листа страницы.

setOrientation(orientation: PageOrientation): void;

Параметры

orientation: ExcelScript.PageOrientation

Возвращает

void

Примеры

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

setPaperSize(paperSize)

Размер бумаги листа страницы.

setPaperSize(paperSize: PaperType): void;

Параметры

paperSize: ExcelScript.PaperType

Возвращает

void

Примеры

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

setPrintArea(printArea)

Задает область печати листа.

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

Параметры

printArea: ExcelScript.Range | ExcelScript.RangeAreas | string

Диапазон или диапазоны содержимого для печати.

Возвращает

void

setPrintComments(printComments)

Указывает, должны ли примечания листа отображаться при печати.

setPrintComments(printComments: PrintComments): void;

Параметры

printComments: ExcelScript.PrintComments

Возвращает

void

Примеры

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

setPrintErrors(printErrors)

Параметр ошибок печати листа.

setPrintErrors(printErrors: PrintErrorType): void;

Параметры

printErrors: ExcelScript.PrintErrorType

Возвращает

void

setPrintGridlines(printGridlines)

Указывает, будут ли печататься линии сетки листа.

setPrintGridlines(printGridlines: boolean): void;

Параметры

printGridlines: boolean

Возвращает

void

setPrintHeadings(printHeadings)

Указывает, будут ли печататься заголовки листа.

setPrintHeadings(printHeadings: boolean): void;

Параметры

printHeadings: boolean

Возвращает

void

setPrintMargins(unit, marginOptions)

Задает поля страницы с единицами измерения для листа.

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

Параметры

unit: ExcelScript.PrintMarginUnit

Единица измерения для предоставленных полей.

marginOptions: ExcelScript.PageLayoutMarginOptions

Значения полей для задания. Поля, не предоставленные, остаются без изменений.

Возвращает

void

setPrintOrder(printOrder)

setPrintOrder(printOrder: PrintOrder): void;

Параметры

printOrder: ExcelScript.PrintOrder

Возвращает

void

Примеры

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

setPrintTitleColumns(printTitleColumns)

Задает столбцы, содержащие ячейки, которые должны повторяться слева на каждой странице при печати листа.

setPrintTitleColumns(printTitleColumns: Range | string): void;

Параметры

printTitleColumns: ExcelScript.Range | string

Столбцы, повторяемые слева от каждой страницы. Диапазон должен охватывать весь столбец, чтобы быть допустимым.

Возвращает

void

setPrintTitleRows(printTitleRows)

Задает строки, содержащие ячейки, которые должны повторяться сверху каждой страницы при печати листа.

setPrintTitleRows(printTitleRows: Range | string): void;

Параметры

printTitleRows: ExcelScript.Range | string

Повторяющиеся строки в верхней части каждой страницы. Диапазон должен охватывать всю строку, чтобы быть допустимым.

Возвращает

void

setRightMargin(rightMargin)

Правое поле листа (в пунктах) для использования при печати.

setRightMargin(rightMargin: number): void;

Параметры

rightMargin: number

Возвращает

void

setTopMargin(topMargin)

Верхнее поле листа (в пунктах) для использования при печати.

setTopMargin(topMargin: number): void;

Параметры

topMargin: number

Возвращает

void

setZoom(zoom)

setZoom(zoom: PageLayoutZoomOptions): void;

Параметры

zoom: ExcelScript.PageLayoutZoomOptions

Возвращает

void

Примеры

/**
 * 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)
}

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

ExcelScript.PageLayout interface

Замечания

Примеры

Методика

Подробнее о методе

getBlackAndWhite()

Возвращает

getBottomMargin()

Возвращает

getCenterHorizontally()

Возвращает

getCenterVertically()

Возвращает

getDraftMode()

Возвращает

getFirstPageNumber()

Возвращает

getFooterMargin()

Возвращает

getHeaderMargin()

Возвращает

getHeadersFooters()

Возвращает

getLeftMargin()

Возвращает

getOrientation()

Возвращает

getPaperSize()

Возвращает

getPrintArea()

Возвращает

getPrintComments()

Возвращает

getPrintErrors()

Возвращает

getPrintGridlines()

Возвращает

getPrintHeadings()

Возвращает

getPrintOrder()

Возвращает

getPrintTitleColumns()

Возвращает

getPrintTitleRows()

Возвращает

getRightMargin()

Возвращает

getTopMargin()

Возвращает

getZoom()

Возвращает

setBlackAndWhite(blackAndWhite)

Параметры

Возвращает

setBottomMargin(bottomMargin)

Параметры

Возвращает

setCenterHorizontally(centerHorizontally)

Параметры

Возвращает

setCenterVertically(centerVertically)

Параметры

Возвращает

setDraftMode(draftMode)

Параметры

Возвращает

Примеры

setFirstPageNumber(firstPageNumber)

Параметры

Возвращает

setFooterMargin(footerMargin)

Параметры

Возвращает

setHeaderMargin(headerMargin)

Параметры

Возвращает

setLeftMargin(leftMargin)

Параметры

Возвращает