Excel.ChartTrendlineLabel class

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

Extends

Комментарии

Набор API: ExcelApi 1.8

Используется

Свойства

autoText

Указывает, автоматически ли подпись линии тренда создает соответствующий текст на основе контекста.

context

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

format

Формат подписи линии тренда диаграммы.

formula

Строковое значение, представляющее формулу подписи линии тренда диаграммы в формате A1.

height

Возвращает высоту подписи линии тренда диаграммы (в пунктах). Значение, null если подпись линии тренда диаграммы не отображается.

horizontalAlignment

Представляет горизонтальное выравнивание подписи линии тренда диаграммы. См. Excel.ChartTextHorizontalAlignment дополнительные сведения. Это свойство верно только в том случае, если TextOrientation метка линии тренда равна -90, 90 или 180.

left

Представляет расстояние (в пунктах) от левого края метки линии тренда диаграммы до левого края области диаграммы. Значение, null если подпись линии тренда диаграммы не отображается.

linkNumberFormat

Указывает, связан ли числовой формат с ячейками (таким образом, числовой формат изменяется в метках при изменении в ячейках).

numberFormat

Строковое значение, представляющее код формата для метки линии тренда.

text

Строка, представляющая текст подписи линии тренда на диаграмме.

textOrientation

Указывает угол, под которым ориентирован текст для подписи линии тренда диаграммы. Значение должно быть либо целым числом от -90 до 90, либо целым числом 180 для вертикально ориентированного текста.

top

Представляет расстояние (в пунктах) от верхнего края метки линии тренда диаграммы до вершины области диаграммы. Значение, null если подпись линии тренда диаграммы не отображается.

verticalAlignment

Представляет вертикальное выравнивание подписи линии тренда диаграммы. См. Excel.ChartTextVerticalAlignment дополнительные сведения. Это свойство верно только в том случае, если TextOrientation метка линии тренда равна 0.

width

Возвращает ширину подписи линии тренда диаграммы (в пунктах). Значение, null если подпись линии тренда диаграммы не отображается.

Методы

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

set(properties, options)

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

set(properties)

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

toJSON()

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

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

autoText

Указывает, автоматически ли подпись линии тренда создает соответствующий текст на основе контекста.

autoText: boolean;

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

boolean

Комментарии

Набор API: ExcelApi 1.8

context

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

context: RequestContext;

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

format

Формат подписи линии тренда диаграммы.

readonly format: Excel.ChartTrendlineLabelFormat;

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

Комментарии

Набор API: ExcelApi 1.8

formula

Строковое значение, представляющее формулу подписи линии тренда диаграммы в формате A1.

formula: string;

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

string

Комментарии

Набор API: ExcelApi 1.8

height

Возвращает высоту подписи линии тренда диаграммы (в пунктах). Значение, null если подпись линии тренда диаграммы не отображается.

readonly height: number;

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

number

Комментарии

Набор API: ExcelApi 1.8

horizontalAlignment

Представляет горизонтальное выравнивание подписи линии тренда диаграммы. См. Excel.ChartTextHorizontalAlignment дополнительные сведения. Это свойство верно только в том случае, если TextOrientation метка линии тренда равна -90, 90 или 180.

horizontalAlignment: Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" | "Distributed";

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

Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" | "Distributed"

Комментарии

Набор API: ExcelApi 1.8

left

Представляет расстояние (в пунктах) от левого края метки линии тренда диаграммы до левого края области диаграммы. Значение, null если подпись линии тренда диаграммы не отображается.

left: number;

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

number

Комментарии

Набор API: ExcelApi 1.8

linkNumberFormat

Указывает, связан ли числовой формат с ячейками (таким образом, числовой формат изменяется в метках при изменении в ячейках).

linkNumberFormat: boolean;

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

boolean

Комментарии

Набор API: ExcelApi 1.9

numberFormat

Строковое значение, представляющее код формата для метки линии тренда.

numberFormat: string;

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

string

Комментарии

Набор API: ExcelApi 1.8

text

Строка, представляющая текст подписи линии тренда на диаграмме.

text: string;

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

string

Комментарии

Набор API: ExcelApi 1.8

textOrientation

Указывает угол, под которым ориентирован текст для подписи линии тренда диаграммы. Значение должно быть либо целым числом от -90 до 90, либо целым числом 180 для вертикально ориентированного текста.

textOrientation: number;

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

number

Комментарии

Набор API: ExcelApi 1.8

top

Представляет расстояние (в пунктах) от верхнего края метки линии тренда диаграммы до вершины области диаграммы. Значение, null если подпись линии тренда диаграммы не отображается.

top: number;

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

number

Комментарии

Набор API: ExcelApi 1.8

verticalAlignment

Представляет вертикальное выравнивание подписи линии тренда диаграммы. См. Excel.ChartTextVerticalAlignment дополнительные сведения. Это свойство верно только в том случае, если TextOrientation метка линии тренда равна 0.

verticalAlignment: Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed";

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

Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed"

Комментарии

Набор API: ExcelApi 1.8

width

Возвращает ширину подписи линии тренда диаграммы (в пунктах). Значение, null если подпись линии тренда диаграммы не отображается.

readonly width: number;

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

number

Комментарии

Набор API: ExcelApi 1.8

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

load(options)

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

load(options?: Excel.Interfaces.ChartTrendlineLabelLoadOptions): Excel.ChartTrendlineLabel;

Параметры

options
Excel.Interfaces.ChartTrendlineLabelLoadOptions

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

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

load(propertyNames)

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

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

Параметры

propertyNames

string | string[]

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

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

load(propertyNamesAndPaths)

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

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

Параметры

propertyNamesAndPaths

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

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

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

set(properties, options)

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

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

Параметры

properties
Excel.Interfaces.ChartTrendlineLabelUpdateData

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

options
OfficeExtension.UpdateOptions

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

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

void

set(properties)

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

set(properties: Excel.ChartTrendlineLabel): void;

Параметры

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

void

toJSON()

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

toJSON(): Excel.Interfaces.ChartTrendlineLabelData;

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