Excel.ChartLegendFormat interface

Encapsula as propriedades de formato de uma legenda de gráfico.

Propriedades

border

Representa o formato de borda, que inclui a espessura de cor e estilo de linha.

fill

Representa o formato de preenchimento de um objeto, que inclui informações sobre a formatação da tela de fundo.

font

Representa os atributos de fonte, como nome da fonte, tamanho da fonte, cor, etc. de uma legenda do gráfico.

Métodos

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

Detalhes da propriedade

border

Representa o formato de borda, que inclui a espessura de cor e estilo de linha.

readonly border: ChartBorder;

Valor da propriedade

fill

Representa o formato de preenchimento de um objeto, que inclui informações sobre a formatação da tela de fundo.

readonly fill: ChartFill;

Valor da propriedade

font

Representa os atributos de fonte, como nome da fonte, tamanho da fonte, cor, etc. de uma legenda do gráfico.

readonly font: ChartFont;

Valor da propriedade

Exemplos

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();
}

Detalhes do método

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

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

Parâmetros

propertyNames
string | string[]

Uma cadeia de caracteres delimitada por vírgula ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.

Retornos

void