Excel.ChartLegendFormat interface

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

Свойства

border

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

fill

Представляет формат заливки объекта, включая сведения о форматировании фона.

font

Представляет атрибуты шрифта, такие как имя шрифта, размер шрифта, цвет и т. д., в условных обозначениях диаграммы.

Методы

load(propertyNames)

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

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

border

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

readonly border: ChartBorder;

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

fill

Представляет формат заливки объекта, включая сведения о форматировании фона.

readonly fill: ChartFill;

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

font

Представляет атрибуты шрифта, такие как имя шрифта, размер шрифта, цвет и т. д., в условных обозначениях диаграммы.

readonly font: ChartFont;

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

Примеры

async function main(context: Excel.RequestContext) {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let chart = sheet.charts.getItemAt(0);
    chart.legend.visible = true;

    // Format the legend font.
    let font = chart.legend.format.font;
    font.bold = true;
    font.color = "red";
    font.italic = true;
    font.size = 15;
    font.name = "Calibri";
    font.underline = "Single";

    await context.sync();
}

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

load(propertyNames)

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

load(propertyNames?: string | string[]): void;

Параметры

propertyNames
string | string[]

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

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

void