Excel.ChartTrendlineLabel class
Этот объект представляет атрибуты для объекта метки линии тренда диаграммы.
- Extends
Комментарии
Свойства
auto |
Указывает, будет ли метка линии тренда автоматически создавать соответствующий текст на основе контекста. |
context | Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office. |
format | Формат метки линии тренда диаграммы. |
formula | Строковое значение, представляющее формулу метки линии тренда диаграммы с использованием нотации в стиле A1. |
height | Возвращает высоту подписи линии тренда диаграммы (в пунктах). Значением является, |
horizontal |
Представляет горизонтальное выравнивание метки линии тренда диаграммы. Дополнительные сведения см. в этой |
left | Представляет расстояние (в точках) от левого края метки линии тренда диаграммы до левого края области диаграммы. Значением является, |
link |
Указывает, связан ли числовой формат с ячейками (таким образом, числовой формат изменяется в метках при его изменении в ячейках). |
number |
Строковое значение, представляющее код формата для метки линии тренда. |
text | Строка, представляющая текст подписи линии тренда на диаграмме. |
text |
Представляет угол, на который текст ориентирован для метки линии тренда диаграммы. Значение должно быть целым числом от -90 до 90 или целым числом 180 для вертикально ориентированного текста. |
top | Представляет расстояние (в точках) от верхнего края метки линии тренда диаграммы до верхней части области диаграммы. Значением является, |
vertical |
Представляет вертикальное выравнивание метки линии тренда диаграммы. Дополнительные сведения см. в этой |
width | Возвращает ширину подписи линии тренда диаграммы (в пунктах). Значением является, |
Методы
load(options) | Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод |
load(property |
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод |
load(property |
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод |
set(properties, options) | Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа. |
set(properties) | Задает несколько свойств объекта одновременно на основе существующего загруженного объекта. |
toJSON() | Переопределяет метод JavaScript |
Сведения о свойстве
autoText
Указывает, будет ли метка линии тренда автоматически создавать соответствующий текст на основе контекста.
autoText: boolean;
Значение свойства
boolean
Комментарии
context
Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.
context: RequestContext;
Значение свойства
format
Формат метки линии тренда диаграммы.
readonly format: Excel.ChartTrendlineLabelFormat;
Значение свойства
Комментарии
formula
Строковое значение, представляющее формулу метки линии тренда диаграммы с использованием нотации в стиле A1.
formula: string;
Значение свойства
string
Комментарии
height
Возвращает высоту подписи линии тренда диаграммы (в пунктах). Значением является, null
если метка линии тренда диаграммы не видна.
readonly height: number;
Значение свойства
number
Комментарии
horizontalAlignment
Представляет горизонтальное выравнивание метки линии тренда диаграммы. Дополнительные сведения см. в этой Excel.ChartTextHorizontalAlignment
статье. Это свойство допустимо, только если TextOrientation
метка линии тренда имеет значение -90, 90 или 180.
horizontalAlignment: Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" | "Distributed";
Значение свойства
Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" | "Distributed"
Комментарии
left
Представляет расстояние (в точках) от левого края метки линии тренда диаграммы до левого края области диаграммы. Значением является, null
если метка линии тренда диаграммы не видна.
left: number;
Значение свойства
number
Комментарии
linkNumberFormat
Указывает, связан ли числовой формат с ячейками (таким образом, числовой формат изменяется в метках при его изменении в ячейках).
linkNumberFormat: boolean;
Значение свойства
boolean
Комментарии
numberFormat
Строковое значение, представляющее код формата для метки линии тренда.
numberFormat: string;
Значение свойства
string
Комментарии
text
Строка, представляющая текст подписи линии тренда на диаграмме.
text: string;
Значение свойства
string
Комментарии
textOrientation
Представляет угол, на который текст ориентирован для метки линии тренда диаграммы. Значение должно быть целым числом от -90 до 90 или целым числом 180 для вертикально ориентированного текста.
textOrientation: number;
Значение свойства
number
Комментарии
top
Представляет расстояние (в точках) от верхнего края метки линии тренда диаграммы до верхней части области диаграммы. Значением является, null
если метка линии тренда диаграммы не видна.
top: number;
Значение свойства
number
Комментарии
verticalAlignment
Представляет вертикальное выравнивание метки линии тренда диаграммы. Дополнительные сведения см. в этой Excel.ChartTextVerticalAlignment
статье. Это свойство допустимо, только если TextOrientation
метка линии тренда имеет значение 0.
verticalAlignment: Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed";
Значение свойства
Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed"
Комментарии
width
Возвращает ширину подписи линии тренда диаграммы (в пунктах). Значением является, null
если метка линии тренда диаграммы не видна.
readonly width: number;
Значение свойства
number
Комментарии
Сведения о методе
load(options)
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync()
.
load(options?: Excel.Interfaces.ChartTrendlineLabelLoadOptions): Excel.ChartTrendlineLabel;
Параметры
Предоставляет параметры свойств объекта для загрузки.
Возвращаемое значение
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;
Параметры
Объект JavaScript со свойствами, структурированными изоморфно по свойствам объекта, для которого вызывается метод .
- options
- OfficeExtension.UpdateOptions
Предоставляет возможность подавления ошибок, если объект свойств пытается задать какие-либо свойства, доступные только для чтения.
Возвращаемое значение
void
set(properties)
Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.
set(properties: Excel.ChartTrendlineLabel): void;
Параметры
- properties
- Excel.ChartTrendlineLabel
Возвращаемое значение
void
toJSON()
Переопределяет метод JavaScript toJSON()
, чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify()
. (JSON.stringify
в свою очередь вызывает toJSON
метод переданного ему объекта.) В то время как исходный Excel.ChartTrendlineLabel
объект является объектом API, toJSON
метод возвращает обычный объект JavaScript (типизированный как Excel.Interfaces.ChartTrendlineLabelData
), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.
toJSON(): Excel.Interfaces.ChartTrendlineLabelData;
Возвращаемое значение
Office Add-ins