Excel.ChartDataLabel interface

Representa o rótulo de dados de um ponto de gráfico.

Propriedades

autoText

Especifica se o rótulo de dados gerará automaticamente o texto apropriado com base no contexto.

format

Representa o formato do rótulo de dados do gráfico.

formula

Valor de cadeia de caracteres que representa a fórmula do título do rótulo de dados usando a notação no estilo A1.

height

Retorna a altura, em pontos, do rótulo de dados do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

horizontalAlignment

Representa o alinhamento horizontal de 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 é-90, 90 ou 180.

left

Representa a distância, em pontos, da borda esquerda do rótulo de dados do gráfico até a borda esquerda da área do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

linkNumberFormat

Especifica se o formato de número está vinculado às células (de modo que o formato de número seja alterado nos rótulos quando for alterado nas células).

numberFormat

Valor de cadeia de caracteres que representa o código do formato do rótulo 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 o rótulo 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.

text

Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico.

textOrientation

Representa o ângulo no qual o texto é orientado para o rótulo de dados do gráfico. O valor deve ser um inteiro de-90 a 90 ou o inteiro 180 para texto orientado verticalmente.

top

Representa a distância, em pontos, da borda superior do rótulo de dados do gráfico até a borda superior da área do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

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 é 0.

width

Retorna a largura, em pontos, do rótulo de dados do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

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 o rótulo de dados gerará automaticamente o texto apropriado com base no contexto.

autoText: boolean;

Valor da propriedade

boolean

format

Representa o formato do rótulo de dados do gráfico.

readonly format: ChartDataLabelFormat;

Valor da propriedade

formula

Valor de cadeia de caracteres que representa a fórmula do título do rótulo de dados usando a notação no estilo A1.

formula: string;

Valor da propriedade

string

height

Retorna a altura, em pontos, do rótulo de dados do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

readonly height: number;

Valor da propriedade

number

horizontalAlignment

Representa o alinhamento horizontal de 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 é-90, 90 ou 180.

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

Valor da propriedade

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

left

Representa a distância, em pontos, da borda esquerda do rótulo de dados do gráfico até a borda esquerda da área do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

left: number;

Valor da propriedade

number

linkNumberFormat

Especifica se o formato de número está vinculado às células (de modo que o formato de número seja alterado nos rótulos quando for alterado nas células).

linkNumberFormat: boolean;

Valor da propriedade

boolean

numberFormat

Valor de cadeia de caracteres que representa o código do formato do rótulo 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 o rótulo 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

text

Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico.

text: string;

Valor da propriedade

string

textOrientation

Representa o ângulo no qual o texto é orientado para o rótulo de dados do gráfico. O valor deve ser um inteiro de-90 a 90 ou o inteiro 180 para texto orientado verticalmente.

textOrientation: number;

Valor da propriedade

number

top

Representa a distância, em pontos, da borda superior do rótulo de dados do gráfico até a borda superior da área do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

top: 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 é 0.

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

Valor da propriedade

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

width

Retorna a largura, em pontos, do rótulo de dados do gráfico. Nulo se o rótulo de dados do gráfico não estiver visível.

readonly width: number;

Valor da propriedade

number

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