ExcelScript.ChartDataLabel interface
Representa o rótulo de dados de um ponto do gráfico.
Métodos
| get |
Especifica se o rótulo de dados gera automaticamente o texto apropriado 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 do rótulo 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. Consulte |
| 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á vinculado às células (de modo que o formato do número seja alterado nos rótulos quando for alterado nas células). |
| get |
Especifica o código de formato do rótulo de dados. |
| get |
Valor que representa a posição do rótulo de dados. Consulte |
| get |
Cadeia de caracteres que representa o separador usado para o rótulo de dados em um gráfico. |
| get |
Especifica se o rótulo de dados é mostrado como um balão com a âncora final anexada ao ponto de dados. Se |
| get |
Especifica se o tamanho da bolha do rótulo de dados está visível. |
| get |
Especifica se o nome da categoria do rótulo de dados é visível. |
| get |
Especifica se a chave da legenda do rótulo de dados está visível. |
| get |
Especifica se a porcentagem do rótulo de dados está visível. |
| get |
Especifica se o nome da série de rótulos de dados é visível. |
| get |
Especifica se o valor do rótulo de dados é visível. |
| get |
Retorna uma subcadeia de caracteres do rótulo de dados. O caractere de quebra de linha '\n' conta como um caractere. |
| get |
Retorna a âncora final do rótulo de dados, que é mostrado como um texto explicativo auto-adesivo. |
| get |
Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico. |
| get |
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. |
| 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. Consulte |
| get |
Retorna a largura, em pontos, do rótulo de dados do gráfico. O valor é |
| set |
Especifica se o rótulo de dados gera automaticamente o texto apropriado 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 do rótulo de dados. Veja |
| set |
Define a altura do rótulo de dados em pontos. |
| set |
Representa o alinhamento horizontal de rótulo de dados do gráfico. Consulte |
| 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á vinculado às células (de modo que o formato do número seja alterado nos rótulos quando for alterado nas células). |
| set |
Especifica o código de formato do rótulo de dados. |
| set |
Valor que representa a posição do rótulo de dados. Consulte |
| 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 do rótulo de dados está visível. |
| set |
Especifica se o nome da categoria do rótulo de dados é visível. |
| set |
Especifica se a chave da legenda do rótulo de dados está visível. |
| set |
Especifica se a porcentagem do rótulo de dados está visível. |
| set |
Especifica se o nome da série de rótulos de dados é visível. |
| set |
Especifica se o valor do rótulo de dados é visível. |
| set |
Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico. |
| set |
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. |
| 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. Consulte |
| set |
Define a largura do rótulo de dados em pontos. |
Detalhes do método
getAutoText()
Especifica se o rótulo de dados gera automaticamente o texto apropriado 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 do rótulo de dados. Veja ExcelScript.GeometricShapeType para obter detalhes. O valor é null se o rótulo 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 o rótulo 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. Consulte ExcelScript.ChartTextHorizontalAlignment para obter detalhes. Essa propriedade é válida somente quando TextOrientation o rótulo 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 o rótulo de dados do gráfico não estiver visível.
getLeft(): number;
Retornos
number
getLinkNumberFormat()
Especifica se o formato de número está vinculado às células (de modo que o formato do número seja alterado nos rótulos quando for alterado nas células).
getLinkNumberFormat(): boolean;
Retornos
boolean
getNumberFormat()
Especifica o código de formato do rótulo de dados.
getNumberFormat(): string;
Retornos
string
getPosition()
Valor que representa a posição do rótulo de dados. Consulte 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 o rótulo de dados é mostrado como um balão com a âncora final anexada ao ponto de dados. Se true, o texto explicativo é um dos seguintes valores: "AccentCallout1", "AccentCallout2", "BorderCallout1", "BorderCallout2", "WedgeRectCallout", "WedgeRRectCallout" ou "WedgeEllipseCallout".
getShowAsStickyCallout(): boolean;
Retornos
boolean
getShowBubbleSize()
Especifica se o tamanho da bolha do rótulo de dados está visível.
getShowBubbleSize(): boolean;
Retornos
boolean
getShowCategoryName()
Especifica se o nome da categoria do rótulo de dados é visível.
getShowCategoryName(): boolean;
Retornos
boolean
getShowLegendKey()
Especifica se a chave da legenda do rótulo de dados está visível.
getShowLegendKey(): boolean;
Retornos
boolean
getShowPercentage()
Especifica se a porcentagem do rótulo de dados está visível.
getShowPercentage(): boolean;
Retornos
boolean
getShowSeriesName()
Especifica se o nome da série de rótulos de dados é visível.
getShowSeriesName(): boolean;
Retornos
boolean
getShowValue()
Especifica se o valor do rótulo de dados é visível.
getShowValue(): boolean;
Retornos
boolean
getSubstring(start, length)
Retorna uma subcadeia de caracteres do rótulo de dados. O caractere de quebra de linha '\n' conta como um caractere.
getSubstring(start: number, length?: number): ChartFormatString;
Parâmetros
- start
-
number
A posição do caractere inicial com base em zero de uma subcadeia de caracteres no rótulo de dados.
- length
-
number
Opcional. O número de caracteres na subcadeia de caracteres. Se o comprimento for omitido, todos os caracteres do início ao fim do rótulo de dados serão recuperados.
Retornos
getTailAnchor()
Retorna a âncora final do rótulo de dados, que é mostrado como um texto explicativo auto-adesivo.
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 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.
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 o rótulo 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. Consulte ExcelScript.ChartTextVerticalAlignment para obter detalhes. Esta propriedade é válida somente quando TextOrientation o rótulo de dados é 0.
getVerticalAlignment(): ChartTextVerticalAlignment;
Retornos
getWidth()
Retorna a largura, em pontos, do rótulo de dados do gráfico. O valor é null se o rótulo de dados do gráfico não estiver visível.
getWidth(): number;
Retornos
number
setAutoText(autoText)
Especifica se o rótulo de dados gera automaticamente o texto apropriado 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 do rótulo de dados. Veja ExcelScript.GeometricShapeType para obter detalhes. O valor é null se o rótulo 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 do rótulo de dados em pontos.
setHeight(height: number): void;
Parâmetros
- height
-
number
A altura do rótulo de dados em pontos.
Retornos
void
setHorizontalAlignment(horizontalAlignment)
Representa o alinhamento horizontal de rótulo de dados do gráfico. Consulte ExcelScript.ChartTextHorizontalAlignment para obter detalhes. Essa propriedade é válida somente quando TextOrientation o rótulo 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 o rótulo 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á vinculado às células (de modo que o formato do número seja alterado nos rótulos quando for alterado nas células).
setLinkNumberFormat(linkNumberFormat: boolean): void;
Parâmetros
- linkNumberFormat
-
boolean
Retornos
void
setNumberFormat(numberFormat)
Especifica o código de formato do rótulo de dados.
setNumberFormat(numberFormat: string): void;
Parâmetros
- numberFormat
-
string
Retornos
void
setPosition(position)
Valor que representa a posição do rótulo de dados. Consulte 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 do rótulo de dados está visível.
setShowBubbleSize(showBubbleSize: boolean): void;
Parâmetros
- showBubbleSize
-
boolean
Retornos
void
setShowCategoryName(showCategoryName)
Especifica se o nome da categoria do rótulo de dados é visível.
setShowCategoryName(showCategoryName: boolean): void;
Parâmetros
- showCategoryName
-
boolean
Retornos
void
setShowLegendKey(showLegendKey)
Especifica se a chave da legenda do rótulo de dados está visível.
setShowLegendKey(showLegendKey: boolean): void;
Parâmetros
- showLegendKey
-
boolean
Retornos
void
setShowPercentage(showPercentage)
Especifica se a porcentagem do rótulo 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 rótulos de dados é visível.
setShowSeriesName(showSeriesName: boolean): void;
Parâmetros
- showSeriesName
-
boolean
Retornos
void
setShowValue(showValue)
Especifica se o valor do rótulo de dados é 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 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.
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 o rótulo 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. Consulte ExcelScript.ChartTextVerticalAlignment para obter detalhes. Esta propriedade é válida somente quando TextOrientation o rótulo de dados é 0.
setVerticalAlignment(
verticalAlignment: ChartTextVerticalAlignment
): void;
Parâmetros
- verticalAlignment
- ExcelScript.ChartTextVerticalAlignment
Retornos
void
setWidth(width)
Define a largura do rótulo de dados em pontos.
setWidth(width: number): void;
Parâmetros
- width
-
number
A largura do rótulo de dados em pontos.
Retornos
void