ExcelScript.ChartDataLabel interface
Representa a etiqueta de dados de um ponto de gráfico.
Métodos
| get |
Especifica se a etiqueta de dados gera automaticamente texto adequado com base no contexto. |
| get |
Representa o formato do rótulo de dados do gráfico. |
| get |
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. |
| get |
Especifica o tipo de forma geométrica da etiqueta de dados. Veja |
| get |
Retorna a altura, em pontos, do rótulo de dados do gráfico. O valor é |
| get |
Representa o alinhamento horizontal de rótulo de dados do gráfico. Veja |
| get |
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. O valor é |
| get |
Especifica se o formato de número está ligado às células (para que o formato de número seja alterado nas etiquetas quando for alterado nas células). |
| get |
Especifica o código de formato para a etiqueta de dados. |
| get |
Valor que representa a posição da etiqueta de dados. Veja |
| get |
Cadeia de caracteres que representa o separador usado para o rótulo de dados em um gráfico. |
| get |
Especifica se a etiqueta de dados é apresentada como uma nota de aviso com a âncora de cauda anexada ao ponto de dados. Se |
| get |
Especifica se o tamanho da bolha da etiqueta de dados está visível. |
| get |
Especifica se o nome da categoria da etiqueta de dados está visível. |
| get |
Especifica se a chave de legenda da etiqueta de dados está visível. |
| get |
Especifica se a percentagem da etiqueta de dados está visível. |
| get |
Especifica se o nome da série de etiquetas de dados está visível. |
| get |
Especifica se o valor da etiqueta de dados está visível. |
| get |
Devolve uma subcadeia da etiqueta de dados. O caráter de quebra de linha '\n' conta como um caráter. |
| get |
Devolve a âncora traseira da etiqueta de dados que é apresentada como uma nota de aviso autocolante. |
| get |
Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico. |
| get |
Representa o ângulo para o qual o texto é orientado para a etiqueta de dados do gráfico. O valor deve ser um número inteiro de -90 a 90 ou o número inteiro 180 para texto orientado verticalmente. |
| get |
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. O valor é |
| get |
Representa o alinhamento vertical do rótulo de dados do gráfico. Veja |
| get |
Retorna a largura, em pontos, do rótulo de dados do gráfico. O valor é |
| set |
Especifica se a etiqueta de dados gera automaticamente texto adequado com base no contexto. |
| set |
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. |
| set |
Especifica o tipo de forma geométrica da etiqueta de dados. Veja |
| set |
Define a altura da etiqueta de dados em pontos. |
| set |
Representa o alinhamento horizontal de rótulo de dados do gráfico. Veja |
| set |
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. O valor é |
| set |
Especifica se o formato de número está ligado às células (para que o formato de número seja alterado nas etiquetas quando for alterado nas células). |
| set |
Especifica o código de formato para a etiqueta de dados. |
| set |
Valor que representa a posição da etiqueta de dados. Veja |
| set |
Cadeia de caracteres que representa o separador usado para o rótulo de dados em um gráfico. |
| set |
Especifica se o tamanho da bolha da etiqueta de dados está visível. |
| set |
Especifica se o nome da categoria da etiqueta de dados está visível. |
| set |
Especifica se a chave de legenda da etiqueta de dados está visível. |
| set |
Especifica se a percentagem da etiqueta de dados está visível. |
| set |
Especifica se o nome da série de etiquetas de dados está visível. |
| set |
Especifica se o valor da etiqueta de dados está visível. |
| set |
Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico. |
| set |
Representa o ângulo para o qual o texto é orientado para a etiqueta de dados do gráfico. O valor deve ser um número inteiro de -90 a 90 ou o número inteiro 180 para texto orientado verticalmente. |
| set |
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. O valor é |
| set |
Representa o alinhamento vertical do rótulo de dados do gráfico. Veja |
| set |
Define a largura da etiqueta de dados em pontos. |
Detalhes do método
getAutoText()
Especifica se a etiqueta de dados gera automaticamente texto adequado com base no contexto.
getAutoText(): boolean;
Retornos
boolean
getFormat()
Representa o formato do rótulo de dados do gráfico.
getFormat(): ChartDataLabelFormat;
Retornos
getFormula()
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.
getFormula(): string;
Retornos
string
getGeometricShapeType()
Especifica o tipo de forma geométrica da etiqueta de dados. Veja ExcelScript.GeometricShapeType para obter detalhes. O valor é null se a etiqueta de dados não for uma forma geométrica.
getGeometricShapeType(): GeometricShapeType;
Retornos
getHeight()
Retorna a altura, em pontos, do rótulo de dados do gráfico. O valor é null se a etiqueta de dados do gráfico não estiver visível.
getHeight(): number;
Retornos
number
getHorizontalAlignment()
Representa o alinhamento horizontal de rótulo de dados do gráfico. Veja ExcelScript.ChartTextHorizontalAlignment para obter detalhes. Esta propriedade só é válida quando TextOrientation a etiqueta de dados é -90, 90 ou 180.
getHorizontalAlignment(): ChartTextHorizontalAlignment;
Retornos
getLeft()
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. O valor é null se a etiqueta de dados do gráfico não estiver visível.
getLeft(): number;
Retornos
number
getLinkNumberFormat()
Especifica se o formato de número está ligado às células (para que o formato de número seja alterado nas etiquetas quando for alterado nas células).
getLinkNumberFormat(): boolean;
Retornos
boolean
getNumberFormat()
Especifica o código de formato para a etiqueta de dados.
getNumberFormat(): string;
Retornos
string
getPosition()
Valor que representa a posição da etiqueta de dados. Veja ExcelScript.ChartDataLabelPosition para obter detalhes.
getPosition(): ChartDataLabelPosition;
Retornos
getSeparator()
Cadeia de caracteres que representa o separador usado para o rótulo de dados em um gráfico.
getSeparator(): string;
Retornos
string
getShowAsStickyCallout()
Especifica se a etiqueta de dados é apresentada como uma nota de aviso com a âncora de cauda anexada ao ponto de dados. Se true, a nota de aviso é um dos seguintes valores: "AccentCallout1", "AccentCallout2", "BorderCallout1", "BorderCallout2", "WedgeRectCallout", "WedgeRRectCallout" ou "WedgeEllipseCallout".
getShowAsStickyCallout(): boolean;
Retornos
boolean
getShowBubbleSize()
Especifica se o tamanho da bolha da etiqueta de dados está visível.
getShowBubbleSize(): boolean;
Retornos
boolean
getShowCategoryName()
Especifica se o nome da categoria da etiqueta de dados está visível.
getShowCategoryName(): boolean;
Retornos
boolean
getShowLegendKey()
Especifica se a chave de legenda da etiqueta de dados está visível.
getShowLegendKey(): boolean;
Retornos
boolean
getShowPercentage()
Especifica se a percentagem da etiqueta de dados está visível.
getShowPercentage(): boolean;
Retornos
boolean
getShowSeriesName()
Especifica se o nome da série de etiquetas de dados está visível.
getShowSeriesName(): boolean;
Retornos
boolean
getShowValue()
Especifica se o valor da etiqueta de dados está visível.
getShowValue(): boolean;
Retornos
boolean
getSubstring(start, length)
Devolve uma subcadeia da etiqueta de dados. O caráter de quebra de linha '\n' conta como um caráter.
getSubstring(start: number, length?: number): ChartFormatString;
Parâmetros
- start
-
number
A posição do caráter inicial baseado em zero de uma subcadeia na etiqueta de dados.
- length
-
number
Opcional. O número de carateres na subcadeia. Se o comprimento for omitido, todos os carateres do início ao fim da etiqueta de dados são obtidos.
Retornos
getTailAnchor()
Devolve a âncora traseira da etiqueta de dados que é apresentada como uma nota de aviso autocolante.
getTailAnchor(): ChartDataLabelAnchor;
Retornos
getText()
Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico.
getText(): string;
Retornos
string
getTextOrientation()
Representa o ângulo para o qual o texto é orientado para a etiqueta de dados do gráfico. O valor deve ser um número inteiro de -90 a 90 ou o número inteiro 180 para texto orientado verticalmente.
getTextOrientation(): number;
Retornos
number
getTop()
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. O valor é null se a etiqueta de dados do gráfico não estiver visível.
getTop(): number;
Retornos
number
getVerticalAlignment()
Representa o alinhamento vertical do rótulo de dados do gráfico. Veja ExcelScript.ChartTextVerticalAlignment para obter detalhes. Esta propriedade só é válida quando TextOrientation a etiqueta de dados é 0.
getVerticalAlignment(): ChartTextVerticalAlignment;
Retornos
getWidth()
Retorna a largura, em pontos, do rótulo de dados do gráfico. O valor é null se a etiqueta de dados do gráfico não estiver visível.
getWidth(): number;
Retornos
number
setAutoText(autoText)
Especifica se a etiqueta de dados gera automaticamente texto adequado com base no contexto.
setAutoText(autoText: boolean): void;
Parâmetros
- autoText
-
boolean
Retornos
void
setFormula(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.
setFormula(formula: string): void;
Parâmetros
- formula
-
string
Retornos
void
setGeometricShapeType(geometricShapeType)
Especifica o tipo de forma geométrica da etiqueta de dados. Veja ExcelScript.GeometricShapeType para obter detalhes. O valor é null se a etiqueta de dados não for uma forma geométrica.
setGeometricShapeType(geometricShapeType: GeometricShapeType): void;
Parâmetros
- geometricShapeType
- ExcelScript.GeometricShapeType
Retornos
void
setHeight(height)
Define a altura da etiqueta de dados em pontos.
setHeight(height: number): void;
Parâmetros
- height
-
number
A altura da etiqueta de dados em pontos.
Retornos
void
setHorizontalAlignment(horizontalAlignment)
Representa o alinhamento horizontal de rótulo de dados do gráfico. Veja ExcelScript.ChartTextHorizontalAlignment para obter detalhes. Esta propriedade só é válida quando TextOrientation a etiqueta de dados é -90, 90 ou 180.
setHorizontalAlignment(
horizontalAlignment: ChartTextHorizontalAlignment
): void;
Parâmetros
- horizontalAlignment
- ExcelScript.ChartTextHorizontalAlignment
Retornos
void
setLeft(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. O valor é null se a etiqueta de dados do gráfico não estiver visível.
setLeft(left: number): void;
Parâmetros
- left
-
number
Retornos
void
setLinkNumberFormat(linkNumberFormat)
Especifica se o formato de número está ligado às células (para que o formato de número seja alterado nas etiquetas quando for alterado nas células).
setLinkNumberFormat(linkNumberFormat: boolean): void;
Parâmetros
- linkNumberFormat
-
boolean
Retornos
void
setNumberFormat(numberFormat)
Especifica o código de formato para a etiqueta de dados.
setNumberFormat(numberFormat: string): void;
Parâmetros
- numberFormat
-
string
Retornos
void
setPosition(position)
Valor que representa a posição da etiqueta de dados. Veja ExcelScript.ChartDataLabelPosition para obter detalhes.
setPosition(position: ChartDataLabelPosition): void;
Parâmetros
- position
- ExcelScript.ChartDataLabelPosition
Retornos
void
setSeparator(separator)
Cadeia de caracteres que representa o separador usado para o rótulo de dados em um gráfico.
setSeparator(separator: string): void;
Parâmetros
- separator
-
string
Retornos
void
setShowBubbleSize(showBubbleSize)
Especifica se o tamanho da bolha da etiqueta de dados está visível.
setShowBubbleSize(showBubbleSize: boolean): void;
Parâmetros
- showBubbleSize
-
boolean
Retornos
void
setShowCategoryName(showCategoryName)
Especifica se o nome da categoria da etiqueta de dados está visível.
setShowCategoryName(showCategoryName: boolean): void;
Parâmetros
- showCategoryName
-
boolean
Retornos
void
setShowLegendKey(showLegendKey)
Especifica se a chave de legenda da etiqueta de dados está visível.
setShowLegendKey(showLegendKey: boolean): void;
Parâmetros
- showLegendKey
-
boolean
Retornos
void
setShowPercentage(showPercentage)
Especifica se a percentagem da etiqueta de dados está visível.
setShowPercentage(showPercentage: boolean): void;
Parâmetros
- showPercentage
-
boolean
Retornos
void
setShowSeriesName(showSeriesName)
Especifica se o nome da série de etiquetas de dados está visível.
setShowSeriesName(showSeriesName: boolean): void;
Parâmetros
- showSeriesName
-
boolean
Retornos
void
setShowValue(showValue)
Especifica se o valor da etiqueta de dados está visível.
setShowValue(showValue: boolean): void;
Parâmetros
- showValue
-
boolean
Retornos
void
setText(text)
Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico.
setText(text: string): void;
Parâmetros
- text
-
string
Retornos
void
setTextOrientation(textOrientation)
Representa o ângulo para o qual o texto é orientado para a etiqueta de dados do gráfico. O valor deve ser um número inteiro de -90 a 90 ou o número inteiro 180 para texto orientado verticalmente.
setTextOrientation(textOrientation: number): void;
Parâmetros
- textOrientation
-
number
Retornos
void
setTop(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. O valor é null se a etiqueta de dados do gráfico não estiver visível.
setTop(top: number): void;
Parâmetros
- top
-
number
Retornos
void
setVerticalAlignment(verticalAlignment)
Representa o alinhamento vertical do rótulo de dados do gráfico. Veja ExcelScript.ChartTextVerticalAlignment para obter detalhes. Esta propriedade só é válida quando TextOrientation a etiqueta de dados é 0.
setVerticalAlignment(
verticalAlignment: ChartTextVerticalAlignment
): void;
Parâmetros
- verticalAlignment
- ExcelScript.ChartTextVerticalAlignment
Retornos
void
setWidth(width)
Define a largura da etiqueta de dados em pontos.
setWidth(width: number): void;
Parâmetros
- width
-
number
A largura da etiqueta de dados em pontos.
Retornos
void