Excel.ChartPoint class

Представляет точку из ряда в диаграмме.

[Набор API: ExcelApi 1,1]

Extends

Свойства

context

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

dataLabel

Возвращает метку данных точки диаграммы.

[Набор API: ExcelApi 1,7]

format

Инкапсулирует свойства формата точки диаграммы.

[Набор API: ExcelApi 1,1]

hasDataLabel

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

[Набор API: ExcelApi 1,7]

markerBackgroundColor

HTML-код цвета цвета фона маркера точки данных (например, # FF0000 представляет собой красный цвет).

[Набор API: ExcelApi 1,7]

markerForegroundColor

HTML-код цвета, представляющий цвет переднего плана маркера точки данных (например, # FF0000 представляет собой красный цвет).

[Набор API: ExcelApi 1,7]

markerSize

Представляет размер маркера точки данных.

[Набор API: ExcelApi 1,7]

markerStyle

Представляет стиль маркера точки данных диаграммы. Дополнительные сведения см. в статье Excel. Чартмаркерстиле.

[Набор API: ExcelApi 1,7]

value

Возвращает значение точки диаграммы.

[Набор API: ExcelApi 1,1]

Методы

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

set(properties, options)

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

set(properties)

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

toJSON()

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

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

context

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

context: RequestContext;

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

dataLabel

Возвращает метку данных точки диаграммы.

[Набор API: ExcelApi 1,7]

readonly dataLabel: Excel.ChartDataLabel;

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

format

Инкапсулирует свойства формата точки диаграммы.

[Набор API: ExcelApi 1,1]

readonly format: Excel.ChartPointFormat;

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

hasDataLabel

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

[Набор API: ExcelApi 1,7]

hasDataLabel: boolean;

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

boolean

markerBackgroundColor

HTML-код цвета цвета фона маркера точки данных (например, # FF0000 представляет собой красный цвет).

[Набор API: ExcelApi 1,7]

markerBackgroundColor: string;

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

string

markerForegroundColor

HTML-код цвета, представляющий цвет переднего плана маркера точки данных (например, # FF0000 представляет собой красный цвет).

[Набор API: ExcelApi 1,7]

markerForegroundColor: string;

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

string

markerSize

Представляет размер маркера точки данных.

[Набор API: ExcelApi 1,7]

markerSize: number;

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

number

markerStyle

Представляет стиль маркера точки данных диаграммы. Дополнительные сведения см. в статье Excel. Чартмаркерстиле.

[Набор API: ExcelApi 1,7]

markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";

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

Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture"

value

Возвращает значение точки диаграммы.

[Набор API: ExcelApi 1,1]

readonly value: any;

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

any

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

load(options)

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

load(options?: Excel.Interfaces.ChartPointLoadOptions): Excel.ChartPoint;

Параметры

options
Excel.Interfaces.ChartPointLoadOptions

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

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

load(propertyNames)

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

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

Параметры

propertyNames
string | string[]

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

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

load(propertyNamesAndPaths)

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

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

Параметры

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

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

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

set(properties, options)

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

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

Параметры

properties
Interfaces.ChartPointUpdateData

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

options
OfficeExtension.UpdateOptions

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

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

void

Комментарии

Этот метод имеет следующую дополнительную подпись:

set(properties: Excel.ChartPoint): void

set(properties)

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

set(properties: Excel.ChartPoint): void;

Параметры

properties
Excel.ChartPoint

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

void

toJSON()

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

toJSON(): Excel.Interfaces.ChartPointData;

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