Excel.RangeAreas class

  • Ссылка
Пакет:
excel

RangeAreas представляет коллекцию из одного или нескольких прямоугольных диапазонов на одном листе. Чтобы узнать, как использовать нечеткие диапазоны, см. статью Работа с несколькими диапазонами одновременно в надстройках Excel.

Extends
OfficeExtension.ClientObject

Комментарии

[ Набор API: ExcelApi 1.9 ]

Свойства

address

Возвращает ссылку RangeAreas в стиле A1. Значение адреса будет содержать имя листа для каждого прямоугольного блока ячеек (например, "Лист1! A1:B4, Лист1! D1:D4").
addressLocal

Возвращает ссылку RangeAreas в языковом стандарте пользователя.
areaCount

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

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

Возвращает количество ячеек в объекте RangeAreas , суммируя количество ячеек всех отдельных прямоугольных диапазонов. Возвращает значение -1, если количество ячеек превышает 2^31-1 (2 147 483 647).
conditionalFormats

Возвращает коллекцию условных форматов, пересекающихся с любыми ячейками в этом RangeAreas объекте.
context

Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.
dataValidation

Возвращает объект проверки данных для всех диапазонов в RangeAreas.
format

RangeFormat Возвращает объект , инкапсулирующий шрифт, заливку, границы, выравнивание и другие свойства для всех диапазонов в объекте RangeAreas .
isEntireColumn

Указывает, представляют ли все диапазоны этого RangeAreas объекта целые столбцы (например, "A:C, Q:Z").
isEntireRow

Указывает, представляют ли все диапазоны этого RangeAreas объекта целые строки (например, "1:3, 5:7").
style

Представляет стиль для всех диапазонов в этом RangeAreas объекте. Если стили ячеек несогласованны, null возвращается. Для пользовательских стилей будет возвращено имя стиля. Для встроенных стилей возвращается строка, представляющая значение в перечислении BuiltInStyle .
worksheet

Возвращает лист для текущего RangeAreas.

Методы

calculate()

Вычисляет все ячейки RangeAreasв .
clear(applyTo)

Очищает значения, формат, заливку, границу и другие свойства в каждой из областей, составляющих этот RangeAreas объект.
clear(applyToString)

Очищает значения, формат, заливку, границу и другие свойства в каждой из областей, составляющих этот RangeAreas объект.
clearOrResetContents()

Очищает значения ячеек в диапазонах с особым вниманием к ячейкам, содержащим элементы управления. Если диапазоны содержат только пустые значения, а элементы управления имеют значение по умолчанию, то значения и форматирование элементов управления удаляются. В противном случае для ячеек с элементами управления присваивается значение по умолчанию и очищается значения других ячеек в диапазонах.
convertDataTypeToText()

Преобразует все ячейки в RangeAreas с типами данных в текст.
convertToLinkedDataType(serviceID, languageCulture)

Преобразует все ячейки в в RangeAreas связанные типы данных.
copyFrom(sourceRange, copyType, skipBlanks, transpose)

Копирует данные ячейки или форматирование из исходного диапазона или RangeAreas в текущий RangeAreas. Размер назначения RangeAreas может отличаться от исходного диапазона или RangeAreas. Назначение будет развернуто автоматически, если оно меньше исходного.
copyFrom(sourceRange, copyTypeString, skipBlanks, transpose)

Копирует данные ячейки или форматирование из исходного диапазона или RangeAreas в текущий RangeAreas. Размер назначения RangeAreas может отличаться от исходного диапазона или RangeAreas. Назначение будет развернуто автоматически, если оно меньше исходного.
getEntireColumn()

RangeAreas Возвращает объект , представляющий все столбцы RangeAreas объекта (например, если текущий RangeAreas представляет ячейки "B4:E11, H2", он возвращает RangeAreas объект , представляющий столбцы "B:E, H:H").
getEntireRow()

RangeAreas Возвращает объект , представляющий все строки RangeAreas объекта (например, если текущий RangeAreas представляет ячейки "B4:E11", он возвращает RangeAreas объект , представляющий строки "4:11").
getIntersection(anotherRange)

RangeAreas Возвращает объект , представляющий пересечение заданных диапазонов или RangeAreas. Если пересечение не найдено, будет выдана ItemNotFound ошибка.
getIntersectionOrNullObject(anotherRange)

RangeAreas Возвращает объект , представляющий пересечение заданных диапазонов или RangeAreas. Если пересечение не найдено, этот метод возвращает объект со свойством isNullObjecttrue. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
getOffsetRangeAreas(rowOffset, columnOffset)

RangeAreas Возвращает объект, смещенный на определенное смещение строк и столбцов. Измерение возвращаемого RangeAreas объекта будет соответствовать исходному объекту. Если результирующий объект RangeAreas принудительно выходит за пределы сетки листа, будет выдана ошибка.
getSpecialCells(cellType, cellValueType)

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

getSpecialCells(cellTypeString, cellValueTypeString)

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

getSpecialCellsOrNullObject(cellType, cellValueType)

RangeAreas Возвращает объект , представляющий все ячейки, соответствующие указанному типу и значению. Если не найдены специальные ячейки, соответствующие условиям, этот метод возвращает объект со свойством , для которых isNullObject задано значение true. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
getSpecialCellsOrNullObject(cellTypeString, cellValueTypeString)

RangeAreas Возвращает объект , представляющий все ячейки, соответствующие указанному типу и значению. Если не найдены специальные ячейки, соответствующие условиям, этот метод возвращает объект со свойством , для которых isNullObject задано значение true. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
getTables(fullyContained)

Возвращает коллекцию таблиц с заданной областью, перекрывающуюся с любым диапазоном в этом RangeAreas объекте.
getUsedRangeAreas(valuesOnly)

Возвращает объект RangeAreas , который содержит все используемые области отдельных прямоугольных диапазонов в объекте RangeAreas . Если в RangeAreasобъекте нет используемых ячеек , будет выдана ItemNotFound ошибка.
getUsedRangeAreasOrNullObject(valuesOnly)

Возвращает объект RangeAreas , который содержит все используемые области отдельных прямоугольных диапазонов в объекте RangeAreas . Если в объекте отсутствуют используемые ячейки RangeAreas, то этот метод возвращает объект со свойством isNullObjecttrue. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.
load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
set(properties, options)

Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа.
set(properties)

Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.
setDirty()

Задает объект для пересчета RangeAreas при следующем пересчете.
toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный Excel.RangeAreas объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как Excel.Interfaces.RangeAreasData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.
track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением для context.trackedObjects.add(thisObject). Если вы используете этот объект в вызовах .sync и вне последовательного выполнения пакета .run и получаете ошибку InvalidObjectPath при задании свойства или вызове метода для объекта, необходимо добавить объект в отслеживаемую коллекцию объектов при первом создании объекта.
untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращенным для context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вызов потребуется выполнить context.sync() до того, как выпуск памяти вступит в силу.

Сведения о свойстве

address

Возвращает ссылку RangeAreas в стиле A1. Значение адреса будет содержать имя листа для каждого прямоугольного блока ячеек (например, "Лист1! A1:B4, Лист1! D1:D4").

readonly address: string;

Значение свойства

string

Комментарии

[ Набор API: ExcelApi 1.9 ]

addressLocal

Возвращает ссылку RangeAreas в языковом стандарте пользователя.

readonly addressLocal: string;

Значение свойства

string

Комментарии

[ Набор API: ExcelApi 1.9 ]

areaCount

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

readonly areaCount: number;

Значение свойства

number

Комментарии

[ Набор API: ExcelApi 1.9 ]

areas

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

readonly areas: Excel.RangeCollection;

Значение свойства

Excel.RangeCollection

Комментарии

[ Набор API: ExcelApi 1.9 ]

cellCount

Возвращает количество ячеек в объекте RangeAreas , суммируя количество ячеек всех отдельных прямоугольных диапазонов. Возвращает значение -1, если количество ячеек превышает 2^31-1 (2 147 483 647).

readonly cellCount: number;

Значение свойства

number

Комментарии

[ Набор API: ExcelApi 1.9 ]

conditionalFormats

Возвращает коллекцию условных форматов, пересекающихся с любыми ячейками в этом RangeAreas объекте.

readonly conditionalFormats: Excel.ConditionalFormatCollection;

Значение свойства

Excel.ConditionalFormatCollection

Комментарии

[ Набор API: ExcelApi 1.9 ]

context

Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.

context: RequestContext;

Значение свойства

Excel.RequestContext

dataValidation

Возвращает объект проверки данных для всех диапазонов в RangeAreas.

readonly dataValidation: Excel.DataValidation;

Значение свойства

Excel.DataValidation

Комментарии

[ Набор API: ExcelApi 1.9 ]

format

RangeFormat Возвращает объект , инкапсулирующий шрифт, заливку, границы, выравнивание и другие свойства для всех диапазонов в объекте RangeAreas .

readonly format: Excel.RangeFormat;

Значение свойства

Excel.RangeFormat

Комментарии

[ Набор API: ExcelApi 1.9 ]

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-areas.yaml

await Excel.run(async (context) => {

    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const usedRange = sheet.getUsedRange();

    // Find the ranges with formulas.
    const formulaRanges = usedRange.getSpecialCells("Formulas");
    formulaRanges.format.fill.color = "lightgreen";

    await context.sync();
});

isEntireColumn

Указывает, представляют ли все диапазоны этого RangeAreas объекта целые столбцы (например, "A:C, Q:Z").

readonly isEntireColumn: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: ExcelApi 1.9 ]

isEntireRow

Указывает, представляют ли все диапазоны этого RangeAreas объекта целые строки (например, "1:3, 5:7").

readonly isEntireRow: boolean;

Значение свойства

boolean

Комментарии

[ Набор API: ExcelApi 1.9 ]

style

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

style: string;

Значение свойства

string

Комментарии

[ Набор API: ExcelApi 1.9 ]

worksheet

Возвращает лист для текущего RangeAreas.

readonly worksheet: Excel.Worksheet;

Значение свойства

Excel.Worksheet

Комментарии

[ Набор API: ExcelApi 1.9 ]

Сведения о методе

calculate()

Вычисляет все ячейки RangeAreasв .

calculate(): void;

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

clear(applyTo)

Очищает значения, формат, заливку, границу и другие свойства в каждой из областей, составляющих этот RangeAreas объект.

clear(applyTo?: Excel.ClearApplyTo): void;

Параметры

applyTo
Excel.ClearApplyTo

Необязательный параметр. Определяет тип действия очистки. Дополнительные сведения см. в этой Excel.ClearApplyTo статье. Значение по умолчанию — "All".

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

clear(applyToString)

Очищает значения, формат, заливку, границу и другие свойства в каждой из областей, составляющих этот RangeAreas объект.

clear(applyToString?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks" | "ResetContents"): void;

Параметры

applyToString

"All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks" | "ResetContents"

Необязательный параметр. Определяет тип действия очистки. Дополнительные сведения см. в этой Excel.ClearApplyTo статье. Значение по умолчанию — "All".

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

clearOrResetContents()

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

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

clearOrResetContents(): void;

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ) ]

convertDataTypeToText()

Преобразует все ячейки в RangeAreas с типами данных в текст.

convertDataTypeToText(): void;

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

convertToLinkedDataType(serviceID, languageCulture)

Преобразует все ячейки в в RangeAreas связанные типы данных.

convertToLinkedDataType(serviceID: number, languageCulture: string): void;

Параметры

serviceID

number

Идентификатор службы, который будет использоваться для запроса данных.

languageCulture

string

Язык и региональные параметры для запроса к службе.

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

copyFrom(sourceRange, copyType, skipBlanks, transpose)

Копирует данные ячейки или форматирование из исходного диапазона или RangeAreas в текущий RangeAreas. Размер назначения RangeAreas может отличаться от исходного диапазона или RangeAreas. Назначение будет развернуто автоматически, если оно меньше исходного.

copyFrom(sourceRange: Range | RangeAreas | string, copyType?: Excel.RangeCopyType, skipBlanks?: boolean, transpose?: boolean): void;

Параметры

sourceRange

Excel.Range | Excel.RangeAreas | string

Исходный диапазон или RangeAreas для копирования. Если источник RangeAreas имеет несколько диапазонов, их форма должна быть создана путем удаления полных строк или столбцов из прямоугольного диапазона.

copyType
Excel.RangeCopyType

Тип данных ячейки или форматирование для копирования. Значение по умолчанию — "All".

skipBlanks

boolean

Значение true, если пропускать пустые ячейки в исходном диапазоне или RangeAreas. Значение по умолчанию: false.

transpose

boolean

Значение true, если требуется транспонировать ячейки в целевом объекте RangeAreas. Значение по умолчанию: false.

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

copyFrom(sourceRange, copyTypeString, skipBlanks, transpose)

Копирует данные ячейки или форматирование из исходного диапазона или RangeAreas в текущий RangeAreas. Размер назначения RangeAreas может отличаться от исходного диапазона или RangeAreas. Назначение будет развернуто автоматически, если оно меньше исходного.

copyFrom(sourceRange: Range | RangeAreas | string, copyTypeString?: "All" | "Formulas" | "Values" | "Formats" | "Link" | "ColumnWidths", skipBlanks?: boolean, transpose?: boolean): void;

Параметры

sourceRange

Excel.Range | Excel.RangeAreas | string

Исходный диапазон или RangeAreas для копирования. Если источник RangeAreas имеет несколько диапазонов, их форма должна быть создана путем удаления полных строк или столбцов из прямоугольного диапазона.

copyTypeString

"All" | "Formulas" | "Values" | "Formats" | "Link" | "ColumnWidths"

Тип данных ячейки или форматирование для копирования. Значение по умолчанию — "All".

skipBlanks

boolean

Значение true, если пропускать пустые ячейки в исходном диапазоне или RangeAreas. Значение по умолчанию: false.

transpose

boolean

Значение true, если требуется транспонировать ячейки в целевом объекте RangeAreas. Значение по умолчанию: false.

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

getEntireColumn()

RangeAreas Возвращает объект , представляющий все столбцы RangeAreas объекта (например, если текущий RangeAreas представляет ячейки "B4:E11, H2", он возвращает RangeAreas объект , представляющий столбцы "B:E, H:H").

getEntireColumn(): Excel.RangeAreas;

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getEntireRow()

RangeAreas Возвращает объект , представляющий все строки RangeAreas объекта (например, если текущий RangeAreas представляет ячейки "B4:E11", он возвращает RangeAreas объект , представляющий строки "4:11").

getEntireRow(): Excel.RangeAreas;

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getIntersection(anotherRange)

RangeAreas Возвращает объект , представляющий пересечение заданных диапазонов или RangeAreas. Если пересечение не найдено, будет выдана ItemNotFound ошибка.

getIntersection(anotherRange: Range | RangeAreas | string): Excel.RangeAreas;

Параметры

anotherRange

Excel.Range | Excel.RangeAreas | string

Диапазон, RangeAreas объект или адрес диапазона, который будет использоваться для определения пересечения.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getIntersectionOrNullObject(anotherRange)

RangeAreas Возвращает объект , представляющий пересечение заданных диапазонов или RangeAreas. Если пересечение не найдено, этот метод возвращает объект со свойством isNullObjecttrue. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getIntersectionOrNullObject(anotherRange: Range | RangeAreas | string): Excel.RangeAreas;

Параметры

anotherRange

Excel.Range | Excel.RangeAreas | string

Диапазон, RangeAreas объект или адрес, которые будут использоваться для определения пересечения.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getOffsetRangeAreas(rowOffset, columnOffset)

RangeAreas Возвращает объект, смещенный на определенное смещение строк и столбцов. Измерение возвращаемого RangeAreas объекта будет соответствовать исходному объекту. Если результирующий объект RangeAreas принудительно выходит за пределы сетки листа, будет выдана ошибка.

getOffsetRangeAreas(rowOffset: number, columnOffset: number): Excel.RangeAreas;

Параметры

rowOffset

number

Количество строк (положительных, отрицательных или 0), на которые должно быть смещение RangeAreas . Положительные значения соответствуют смещению вниз, а отрицательные — вверх.

columnOffset

number

Число столбцов (положительных, отрицательных или 0), по которым должно быть смещение RangeAreas . Положительные значения соответствуют смещению вправо, а отрицательные — влево.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getSpecialCells(cellType, cellValueType)

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

getSpecialCells(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;

Параметры

cellType
Excel.SpecialCellType

Тип включаемых ячеек.

cellValueType
Excel.SpecialCellValueType

Если cellType имеет значение constants или formulas, этот аргумент используется для определения типов ячеек, которые следует включить в результат. Эти значения можно объединить для возврата нескольких типов. По умолчанию выбирается все константы или формулы независимо от типа.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getSpecialCells(cellTypeString, cellValueTypeString)

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

getSpecialCells(cellTypeString: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueTypeString?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;

Параметры

cellTypeString

"ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible"

Тип включаемых ячеек.

cellValueTypeString

"All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"

Если cellType имеет значение constants или formulas, этот аргумент используется для определения типов ячеек, которые следует включить в результат. Эти значения можно объединить для возврата нескольких типов. По умолчанию выбирается все константы или формулы независимо от типа.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getSpecialCellsOrNullObject(cellType, cellValueType)

RangeAreas Возвращает объект , представляющий все ячейки, соответствующие указанному типу и значению. Если не найдены специальные ячейки, соответствующие условиям, этот метод возвращает объект со свойством , для которых isNullObject задано значение true. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;

Параметры

cellType
Excel.SpecialCellType

Тип включаемых ячеек.

cellValueType
Excel.SpecialCellValueType

Если cellType имеет значение constants или formulas, этот аргумент используется для определения типов ячеек, которые следует включить в результат. Эти значения можно объединить для возврата нескольких типов. По умолчанию выбирается все константы или формулы независимо от типа.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getSpecialCellsOrNullObject(cellTypeString, cellValueTypeString)

RangeAreas Возвращает объект , представляющий все ячейки, соответствующие указанному типу и значению. Если не найдены специальные ячейки, соответствующие условиям, этот метод возвращает объект со свойством , для которых isNullObject задано значение true. Дополнительные сведения см. в разделе Методы и свойства *OrNullObject.

getSpecialCellsOrNullObject(cellTypeString: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueTypeString?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;

Параметры

cellTypeString

"ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible"

Тип включаемых ячеек.

cellValueTypeString

"All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"

Если cellType имеет значение constants или formulas, этот аргумент используется для определения типов ячеек, которые следует включить в результат. Эти значения можно объединить для возврата нескольких типов. По умолчанию выбирается все константы или формулы независимо от типа.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getTables(fullyContained)

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

getTables(fullyContained?: boolean): Excel.TableScopedCollection;

Параметры

fullyContained

boolean

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

Возвращаемое значение

Excel.TableScopedCollection

Комментарии

[ Набор API: ExcelApi 1.9 ]

getUsedRangeAreas(valuesOnly)

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

getUsedRangeAreas(valuesOnly?: boolean): Excel.RangeAreas;

Параметры

valuesOnly

boolean

Следует ли рассматривать только ячейки со значениями в качестве используемых ячеек. По умолчанию используется значение false.

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

getUsedRangeAreasOrNullObject(valuesOnly)

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

getUsedRangeAreasOrNullObject(valuesOnly?: boolean): Excel.RangeAreas;

Параметры

valuesOnly

boolean

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

Возвращаемое значение

Excel.RangeAreas

Комментарии

[ Набор API: ExcelApi 1.9 ]

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(options?: Excel.Interfaces.RangeAreasLoadOptions): Excel.RangeAreas;

Параметры

options
Excel.Interfaces.RangeAreasLoadOptions

Предоставляет параметры свойств объекта для загрузки.

Возвращаемое значение

Excel.RangeAreas

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNames?: string | string[]): Excel.RangeAreas;

Параметры

propertyNames

string | string[]

Строка с разделителями-запятыми или массив строк, указывающих свойства для загрузки.

Возвращаемое значение

Excel.RangeAreas

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.RangeAreas;

Параметры

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select — это строка с разделителями-запятыми, указывающая загружаемые свойства, и propertyNamesAndPaths.expand строка с разделителями-запятыми, указывающая загружаемые свойства навигации.

Возвращаемое значение

Excel.RangeAreas

set(properties, options)

Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа.

set(properties: Interfaces.RangeAreasUpdateData, options?: OfficeExtension.UpdateOptions): void;

Параметры

properties
Excel.Interfaces.RangeAreasUpdateData

Объект JavaScript со свойствами, структурированными изоморфно по свойствам объекта, для которого вызывается метод .

options
OfficeExtension.UpdateOptions

Предоставляет возможность подавления ошибок, если объект свойств пытается задать какие-либо свойства, доступные только для чтения.

Возвращаемое значение

void

set(properties)

Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.

set(properties: Excel.RangeAreas): void;

Параметры

properties
Excel.RangeAreas

Возвращаемое значение

void

setDirty()

Задает объект для пересчета RangeAreas при следующем пересчете.

setDirty(): void;

Возвращаемое значение

void

Комментарии

[ Набор API: ExcelApi 1.9 ]

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный Excel.RangeAreas объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как Excel.Interfaces.RangeAreasData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.

toJSON(): Excel.Interfaces.RangeAreasData;

Возвращаемое значение

Excel.Interfaces.RangeAreasData

track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением для context.trackedObjects.add(thisObject). Если вы используете этот объект в вызовах .sync и вне последовательного выполнения пакета .run и получаете ошибку InvalidObjectPath при задании свойства или вызове метода для объекта, необходимо добавить объект в отслеживаемую коллекцию объектов при первом создании объекта.

track(): Excel.RangeAreas;

Возвращаемое значение

Excel.RangeAreas

untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращенным для context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вызов потребуется выполнить context.sync() до того, как выпуск памяти вступит в силу.

untrack(): Excel.RangeAreas;

Возвращаемое значение

Excel.RangeAreas