Excel.ChartDataLabels interface

Representa uma coleção de todos os rótulos de dados em um ponto do gráfico.

Propriedades

autoText

Especifica se os rótulos de dados geram automaticamente o texto apropriado com base no contexto.

format

Especifica o formato dos rótulos de dados do gráfico, que inclui a formatação de fonte e preenchimento.

horizontalAlignment

Especifica o alinhamento horizontal para o rótulo de dados do gráfico. Consulte Excel. ChartTextHorizontalAlignment para obter detalhes. Esta propriedade é válida somente quando TextOrientation do rótulo de dados é 0.

linkNumberFormat

Especifica se o formato de número está vinculado às células. Se verdadeiro, o formato numérico será alterado nos rótulos quando ele for alterado nas células.

numberFormat

Especifica o código de formatação para os rótulos de dados.

position

Valor de DataLabelPosition que representa a posição do rótulo de dados. Consulte Excel. ChartDataLabelPosition para obter detalhes.

separator

Cadeia de caracteres que representa o separador usado para os rótulos de dados em um gráfico.

showBubbleSize

Especifica se o tamanho da bolha do rótulo de dados é visível.

showCategoryName

Especifica se o nome da categoria do rótulo de dados está visível.

showLegendKey

Especifica se a tecla de legenda do rótulo de dados está visível.

showPercentage

Especifica se o percentual do rótulo de dados está visível.

showSeriesName

Especifica se o nome da série do rótulo de dados é visível.

showValue

Especifica se o valor do rótulo de dados é visível.

textOrientation

Representa o ângulo no qual o texto é orientado para os rótulos de dados. O valor deve ser um inteiro de-90 a 90 ou o inteiro 180 para texto orientado verticalmente.

verticalAlignment

Representa o alinhamento vertical do rótulo de dados do gráfico. Consulte Excel. ChartTextVerticalAlignment para obter detalhes. Esta propriedade é válida somente quando TextOrientation do rótulo de dados é-90, 90 ou 180.

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

autoText

Especifica se os rótulos de dados geram automaticamente o texto apropriado com base no contexto.

autoText: boolean;

Valor da propriedade

boolean

format

Especifica o formato dos rótulos de dados do gráfico, que inclui a formatação de fonte e preenchimento.

readonly format: ChartDataLabelFormat;

Valor da propriedade

horizontalAlignment

Especifica o alinhamento horizontal para o rótulo de dados do gráfico. Consulte Excel. ChartTextHorizontalAlignment para obter detalhes. Esta propriedade é válida somente quando TextOrientation do rótulo de dados é 0.

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

Valor da propriedade

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

linkNumberFormat

Especifica se o formato de número está vinculado às células. Se verdadeiro, o formato numérico será alterado nos rótulos quando ele for alterado nas células.

linkNumberFormat: boolean;

Valor da propriedade

boolean

numberFormat

Especifica o código de formatação para os rótulos de dados.

numberFormat: string;

Valor da propriedade

string

position

Valor de DataLabelPosition que representa a posição do rótulo de dados. Consulte Excel. ChartDataLabelPosition para obter detalhes.

position:
            | ChartDataLabelPosition
            | "Invalid"
            | "None"
            | "Center"
            | "InsideEnd"
            | "InsideBase"
            | "OutsideEnd"
            | "Left"
            | "Right"
            | "Top"
            | "Bottom"
            | "BestFit"
            | "Callout";

Valor da propriedade

| ChartDataLabelPosition | "Invalid" | "None" | "Center" | "InsideEnd" | "InsideBase" | "OutsideEnd" | "Left" | "Right" | "Top" | "Bottom" | "BestFit" | "Callout"

separator

Cadeia de caracteres que representa o separador usado para os rótulos de dados em um gráfico.

separator: string;

Valor da propriedade

string

showBubbleSize

Especifica se o tamanho da bolha do rótulo de dados é visível.

showBubbleSize: boolean;

Valor da propriedade

boolean

showCategoryName

Especifica se o nome da categoria do rótulo de dados está visível.

showCategoryName: boolean;

Valor da propriedade

boolean

showLegendKey

Especifica se a tecla de legenda do rótulo de dados está visível.

showLegendKey: boolean;

Valor da propriedade

boolean

showPercentage

Especifica se o percentual do rótulo de dados está visível.

showPercentage: boolean;

Valor da propriedade

boolean

showSeriesName

Especifica se o nome da série do rótulo de dados é visível.

showSeriesName: boolean;

Valor da propriedade

boolean

showValue

Especifica se o valor do rótulo de dados é visível.

showValue: boolean;

Valor da propriedade

boolean

textOrientation

Representa o ângulo no qual o texto é orientado para os rótulos de dados. O valor deve ser um inteiro de-90 a 90 ou o inteiro 180 para texto orientado verticalmente.

textOrientation: number;

Valor da propriedade

number

verticalAlignment

Representa o alinhamento vertical do rótulo de dados do gráfico. Consulte Excel. ChartTextVerticalAlignment para obter detalhes. Esta propriedade é válida somente quando TextOrientation do rótulo de dados é-90, 90 ou 180.

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

Valor da propriedade

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

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