Compartilhar via


ExcelScript.ChartAxis interface

Representa um único eixo em um gráfico.

Métodos

getAlignment()

Especifica o alinhamento para a etiqueta de escala do eixo especificado. Veja ExcelScript.ChartTextHorizontalAlignment para obter detalhes.

getAxisGroup()

Especifica o grupo para o eixo especificado. Veja ExcelScript.ChartAxisGroup para obter detalhes.

getBaseTimeUnit()

Especifica a unidade base para o eixo de categoria especificado.

getCategoryType()

Especifica o tipo de eixo de categoria.

getCustomDisplayUnit()

Especifica o valor de unidade de apresentação do eixo personalizado. Para definir esta propriedade, utilize o SetCustomDisplayUnit(double) método .

getDisplayUnit()

Representa a unidade de exibição de eixo. Veja ExcelScript.ChartAxisDisplayUnit para obter detalhes.

getFormat()

Representa a formatação de um objeto Chart, que inclui formatação de linha e de fonte.

getHeight()

Especifica a altura, em pontos, do eixo do gráfico. Devolve null se o eixo não estiver visível.

getIsBetweenCategories()

Especifica se o eixo de valores cruza o eixo de categoria entre categorias.

getLeft()

Especifica a distância, em pontos, da margem esquerda do eixo à esquerda da área do gráfico. Devolve null se o eixo não estiver visível.

getLinkNumberFormat()

Especifica se o formato de número está ligado às células. Se true, o formato de número será alterado nas etiquetas quando for alterado nas células.

getLogBase()

Especifica a base do logaritmo ao utilizar escalas logarítmicas.

getMajorGridlines()

Devolve um objeto que representa as principais linhas de grelha do eixo especificado.

getMajorTickMark()

Especifica o tipo de marca de escala principal para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

getMajorTimeUnitScale()

Especifica o valor de escala de unidades principal para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

getMajorUnit()

Especifica o intervalo entre duas marcas de escala principais.

getMaximum()

Especifica o valor máximo no eixo de valores.

getMinimum()

Especifica o valor mínimo no eixo de valores.

getMinorGridlines()

Devolve um objeto que representa as linhas de grelha secundárias do eixo especificado.

getMinorTickMark()

Especifica o tipo de marca de escala secundária para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

getMinorTimeUnitScale()

Especifica o valor de escala de unidade secundária para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

getMinorUnit()

Especifica o intervalo entre duas marcas de escala menores.

getMultiLevel()

Especifica se um eixo tem múltiplos níveis.

getNumberFormat()

Especifica o código de formato para a etiqueta de escala do eixo.

getOffset()

Especifica a distância entre os níveis de etiquetas e a distância entre o primeiro nível e a linha do eixo. O valor deve ser um inteiro de 0 a 1000.

getPosition()

Especifica a posição do eixo especificado onde o outro eixo se cruza. Veja ExcelScript.ChartAxisPosition para obter detalhes.

getPositionAt()

Especifica a posição do eixo em que o outro eixo se cruza. Deve utilizar o SetPositionAt(double) método para definir esta propriedade.

getReversePlotOrder()

Especifica se o Excel desenha pontos de dados do último ao primeiro.

getScaleType()

Especifica o tipo de escala do eixo de valores. Veja ExcelScript.ChartAxisScaleType para obter detalhes.

getShowDisplayUnitLabel()

Especifica se a etiqueta da unidade de apresentação do eixo está visível.

getTextOrientation()

Especifica o ângulo para o qual o texto está orientado para a etiqueta de escala do eixo 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.

getTickLabelPosition()

Especifica a posição dos rótulos de marcas de escala no eixo especificado. Veja ExcelScript.ChartAxisTickLabelPosition para obter detalhes.

getTickLabelSpacing()

Especifica o número de categorias ou séries entre etiquetas de marca de escala. Pode ter um valor de 1 a 31999.

getTickMarkSpacing()

Especifica o número de categorias ou séries entre marcas de escala.

getTitle()

Representa o título do eixo.

getTop()

Especifica a distância, em pontos, da margem superior do eixo para a parte superior da área do gráfico. Devolve null se o eixo não estiver visível.

getType()

Especifica o tipo de eixo. Veja ExcelScript.ChartAxisType para obter detalhes.

getVisible()

Especifica se o eixo está visível.

getWidth()

Especifica a largura, em pontos, do eixo do gráfico. Devolve null se o eixo não estiver visível.

setAlignment(alignment)

Especifica o alinhamento para a etiqueta de escala do eixo especificado. Veja ExcelScript.ChartTextHorizontalAlignment para obter detalhes.

setBaseTimeUnit(baseTimeUnit)

Especifica a unidade base para o eixo de categoria especificado.

setCategoryNames(sourceData)

Define todos os nomes de categoria para o eixo especificado.

setCategoryType(categoryType)

Especifica o tipo de eixo de categoria.

setCustomDisplayUnit(value)

Definirá a unidade de exibição de eixo a um valor personalizado.

setDisplayUnit(displayUnit)

Representa a unidade de exibição de eixo. Veja ExcelScript.ChartAxisDisplayUnit para obter detalhes.

setIsBetweenCategories(isBetweenCategories)

Especifica se o eixo de valores cruza o eixo de categoria entre categorias.

setLinkNumberFormat(linkNumberFormat)

Especifica se o formato de número está ligado às células. Se true, o formato de número será alterado nas etiquetas quando for alterado nas células.

setLogBase(logBase)

Especifica a base do logaritmo ao utilizar escalas logarítmicas.

setMajorTickMark(majorTickMark)

Especifica o tipo de marca de escala principal para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

setMajorTimeUnitScale(majorTimeUnitScale)

Especifica o valor de escala de unidades principal para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

setMajorUnit(majorUnit)

Especifica o intervalo entre duas marcas de escala principais.

setMaximum(maximum)

Especifica o valor máximo no eixo de valores.

setMinimum(minimum)

Especifica o valor mínimo no eixo de valores.

setMinorTickMark(minorTickMark)

Especifica o tipo de marca de escala secundária para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

setMinorTimeUnitScale(minorTimeUnitScale)

Especifica o valor de escala de unidade secundária para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

setMinorUnit(minorUnit)

Especifica o intervalo entre duas marcas de escala menores.

setMultiLevel(multiLevel)

Especifica se um eixo tem múltiplos níveis.

setNumberFormat(numberFormat)

Especifica o código de formato para a etiqueta de escala do eixo.

setOffset(offset)

Especifica a distância entre os níveis de etiquetas e a distância entre o primeiro nível e a linha do eixo. O valor deve ser um inteiro de 0 a 1000.

setPosition(position)

Especifica a posição do eixo especificado onde o outro eixo se cruza. Veja ExcelScript.ChartAxisPosition para obter detalhes.

setPositionAt(value)

Define a posição do eixo especificado onde o outro eixo se cruza.

setReversePlotOrder(reversePlotOrder)

Especifica se o Excel desenha pontos de dados do último ao primeiro.

setScaleType(scaleType)

Especifica o tipo de escala do eixo de valores. Veja ExcelScript.ChartAxisScaleType para obter detalhes.

setShowDisplayUnitLabel(showDisplayUnitLabel)

Especifica se a etiqueta da unidade de apresentação do eixo está visível.

setTextOrientation(textOrientation)

Especifica o ângulo para o qual o texto está orientado para a etiqueta de escala do eixo 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.

setTickLabelPosition(tickLabelPosition)

Especifica a posição dos rótulos de marcas de escala no eixo especificado. Veja ExcelScript.ChartAxisTickLabelPosition para obter detalhes.

setTickLabelSpacing(tickLabelSpacing)

Especifica o número de categorias ou séries entre etiquetas de marca de escala. Pode ter um valor de 1 a 31999.

setTickMarkSpacing(tickMarkSpacing)

Especifica o número de categorias ou séries entre marcas de escala.

setVisible(visible)

Especifica se o eixo está visível.

Detalhes do método

getAlignment()

Especifica o alinhamento para a etiqueta de escala do eixo especificado. Veja ExcelScript.ChartTextHorizontalAlignment para obter detalhes.

getAlignment(): ChartTickLabelAlignment;

Retornos

getAxisGroup()

Especifica o grupo para o eixo especificado. Veja ExcelScript.ChartAxisGroup para obter detalhes.

getAxisGroup(): ChartAxisGroup;

Retornos

getBaseTimeUnit()

Especifica a unidade base para o eixo de categoria especificado.

getBaseTimeUnit(): ChartAxisTimeUnit;

Retornos

getCategoryType()

Especifica o tipo de eixo de categoria.

getCategoryType(): ChartAxisCategoryType;

Retornos

getCustomDisplayUnit()

Especifica o valor de unidade de apresentação do eixo personalizado. Para definir esta propriedade, utilize o SetCustomDisplayUnit(double) método .

getCustomDisplayUnit(): number;

Retornos

number

getDisplayUnit()

Representa a unidade de exibição de eixo. Veja ExcelScript.ChartAxisDisplayUnit para obter detalhes.

getDisplayUnit(): ChartAxisDisplayUnit;

Retornos

getFormat()

Representa a formatação de um objeto Chart, que inclui formatação de linha e de fonte.

getFormat(): ChartAxisFormat;

Retornos

getHeight()

Especifica a altura, em pontos, do eixo do gráfico. Devolve null se o eixo não estiver visível.

getHeight(): number;

Retornos

number

getIsBetweenCategories()

Especifica se o eixo de valores cruza o eixo de categoria entre categorias.

getIsBetweenCategories(): boolean;

Retornos

boolean

getLeft()

Especifica a distância, em pontos, da margem esquerda do eixo à esquerda da área do gráfico. Devolve null se o eixo não estiver visível.

getLeft(): number;

Retornos

number

getLinkNumberFormat()

Especifica se o formato de número está ligado às células. Se true, o formato de número será alterado nas etiquetas quando for alterado nas células.

getLinkNumberFormat(): boolean;

Retornos

boolean

getLogBase()

Especifica a base do logaritmo ao utilizar escalas logarítmicas.

getLogBase(): number;

Retornos

number

getMajorGridlines()

Devolve um objeto que representa as principais linhas de grelha do eixo especificado.

getMajorGridlines(): ChartGridlines;

Retornos

getMajorTickMark()

Especifica o tipo de marca de escala principal para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

getMajorTickMark(): ChartAxisTickMark;

Retornos

getMajorTimeUnitScale()

Especifica o valor de escala de unidades principal para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

getMajorTimeUnitScale(): ChartAxisTimeUnit;

Retornos

getMajorUnit()

Especifica o intervalo entre duas marcas de escala principais.

getMajorUnit(): number;

Retornos

number

getMaximum()

Especifica o valor máximo no eixo de valores.

getMaximum(): number;

Retornos

number

getMinimum()

Especifica o valor mínimo no eixo de valores.

getMinimum(): number;

Retornos

number

getMinorGridlines()

Devolve um objeto que representa as linhas de grelha secundárias do eixo especificado.

getMinorGridlines(): ChartGridlines;

Retornos

getMinorTickMark()

Especifica o tipo de marca de escala secundária para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

getMinorTickMark(): ChartAxisTickMark;

Retornos

getMinorTimeUnitScale()

Especifica o valor de escala de unidade secundária para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

getMinorTimeUnitScale(): ChartAxisTimeUnit;

Retornos

getMinorUnit()

Especifica o intervalo entre duas marcas de escala menores.

getMinorUnit(): number;

Retornos

number

getMultiLevel()

Especifica se um eixo tem múltiplos níveis.

getMultiLevel(): boolean;

Retornos

boolean

getNumberFormat()

Especifica o código de formato para a etiqueta de escala do eixo.

getNumberFormat(): string;

Retornos

string

getOffset()

Especifica a distância entre os níveis de etiquetas e a distância entre o primeiro nível e a linha do eixo. O valor deve ser um inteiro de 0 a 1000.

getOffset(): number;

Retornos

number

getPosition()

Especifica a posição do eixo especificado onde o outro eixo se cruza. Veja ExcelScript.ChartAxisPosition para obter detalhes.

getPosition(): ChartAxisPosition;

Retornos

getPositionAt()

Especifica a posição do eixo em que o outro eixo se cruza. Deve utilizar o SetPositionAt(double) método para definir esta propriedade.

getPositionAt(): number;

Retornos

number

getReversePlotOrder()

Especifica se o Excel desenha pontos de dados do último ao primeiro.

getReversePlotOrder(): boolean;

Retornos

boolean

getScaleType()

Especifica o tipo de escala do eixo de valores. Veja ExcelScript.ChartAxisScaleType para obter detalhes.

getScaleType(): ChartAxisScaleType;

Retornos

getShowDisplayUnitLabel()

Especifica se a etiqueta da unidade de apresentação do eixo está visível.

getShowDisplayUnitLabel(): boolean;

Retornos

boolean

getTextOrientation()

Especifica o ângulo para o qual o texto está orientado para a etiqueta de escala do eixo 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

getTickLabelPosition()

Especifica a posição dos rótulos de marcas de escala no eixo especificado. Veja ExcelScript.ChartAxisTickLabelPosition para obter detalhes.

getTickLabelPosition(): ChartAxisTickLabelPosition;

Retornos

getTickLabelSpacing()

Especifica o número de categorias ou séries entre etiquetas de marca de escala. Pode ter um valor de 1 a 31999.

getTickLabelSpacing(): number;

Retornos

number

getTickMarkSpacing()

Especifica o número de categorias ou séries entre marcas de escala.

getTickMarkSpacing(): number;

Retornos

number

getTitle()

Representa o título do eixo.

getTitle(): ChartAxisTitle;

Retornos

getTop()

Especifica a distância, em pontos, da margem superior do eixo para a parte superior da área do gráfico. Devolve null se o eixo não estiver visível.

getTop(): number;

Retornos

number

getType()

Especifica o tipo de eixo. Veja ExcelScript.ChartAxisType para obter detalhes.

getType(): ChartAxisType;

Retornos

getVisible()

Especifica se o eixo está visível.

getVisible(): boolean;

Retornos

boolean

getWidth()

Especifica a largura, em pontos, do eixo do gráfico. Devolve null se o eixo não estiver visível.

getWidth(): number;

Retornos

number

setAlignment(alignment)

Especifica o alinhamento para a etiqueta de escala do eixo especificado. Veja ExcelScript.ChartTextHorizontalAlignment para obter detalhes.

setAlignment(alignment: ChartTickLabelAlignment): void;

Parâmetros

Retornos

void

setBaseTimeUnit(baseTimeUnit)

Especifica a unidade base para o eixo de categoria especificado.

setBaseTimeUnit(baseTimeUnit: ChartAxisTimeUnit): void;

Parâmetros

Retornos

void

setCategoryNames(sourceData)

Define todos os nomes de categoria para o eixo especificado.

setCategoryNames(sourceData: Range): void;

Parâmetros

sourceData
ExcelScript.Range

O Range objeto correspondente aos dados de origem.

Retornos

void

setCategoryType(categoryType)

Especifica o tipo de eixo de categoria.

setCategoryType(categoryType: ChartAxisCategoryType): void;

Parâmetros

Retornos

void

setCustomDisplayUnit(value)

Definirá a unidade de exibição de eixo a um valor personalizado.

setCustomDisplayUnit(value: number): void;

Parâmetros

value

number

Valor personalizado da unidade de apresentação.

Retornos

void

setDisplayUnit(displayUnit)

Representa a unidade de exibição de eixo. Veja ExcelScript.ChartAxisDisplayUnit para obter detalhes.

setDisplayUnit(displayUnit: ChartAxisDisplayUnit): void;

Parâmetros

Retornos

void

setIsBetweenCategories(isBetweenCategories)

Especifica se o eixo de valores cruza o eixo de categoria entre categorias.

setIsBetweenCategories(isBetweenCategories: boolean): void;

Parâmetros

isBetweenCategories

boolean

Retornos

void

setLinkNumberFormat(linkNumberFormat)

Especifica se o formato de número está ligado às células. Se true, o formato de número será alterado nas etiquetas quando for alterado nas células.

setLinkNumberFormat(linkNumberFormat: boolean): void;

Parâmetros

linkNumberFormat

boolean

Retornos

void

setLogBase(logBase)

Especifica a base do logaritmo ao utilizar escalas logarítmicas.

setLogBase(logBase: number): void;

Parâmetros

logBase

number

Retornos

void

setMajorTickMark(majorTickMark)

Especifica o tipo de marca de escala principal para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

setMajorTickMark(majorTickMark: ChartAxisTickMark): void;

Parâmetros

Retornos

void

setMajorTimeUnitScale(majorTimeUnitScale)

Especifica o valor de escala de unidades principal para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

setMajorTimeUnitScale(majorTimeUnitScale: ChartAxisTimeUnit): void;

Parâmetros

majorTimeUnitScale
ExcelScript.ChartAxisTimeUnit

Retornos

void

setMajorUnit(majorUnit)

Especifica o intervalo entre duas marcas de escala principais.

setMajorUnit(majorUnit: number): void;

Parâmetros

majorUnit

number

Retornos

void

setMaximum(maximum)

Especifica o valor máximo no eixo de valores.

setMaximum(maximum: number): void;

Parâmetros

maximum

number

Retornos

void

setMinimum(minimum)

Especifica o valor mínimo no eixo de valores.

setMinimum(minimum: number): void;

Parâmetros

minimum

number

Retornos

void

setMinorTickMark(minorTickMark)

Especifica o tipo de marca de escala secundária para o eixo especificado. Veja ExcelScript.ChartAxisTickMark para obter detalhes.

setMinorTickMark(minorTickMark: ChartAxisTickMark): void;

Parâmetros

Retornos

void

setMinorTimeUnitScale(minorTimeUnitScale)

Especifica o valor de escala de unidade secundária para o eixo de categoria quando a categoryType propriedade está definida como dateAxis.

setMinorTimeUnitScale(minorTimeUnitScale: ChartAxisTimeUnit): void;

Parâmetros

minorTimeUnitScale
ExcelScript.ChartAxisTimeUnit

Retornos

void

setMinorUnit(minorUnit)

Especifica o intervalo entre duas marcas de escala menores.

setMinorUnit(minorUnit: number): void;

Parâmetros

minorUnit

number

Retornos

void

setMultiLevel(multiLevel)

Especifica se um eixo tem múltiplos níveis.

setMultiLevel(multiLevel: boolean): void;

Parâmetros

multiLevel

boolean

Retornos

void

setNumberFormat(numberFormat)

Especifica o código de formato para a etiqueta de escala do eixo.

setNumberFormat(numberFormat: string): void;

Parâmetros

numberFormat

string

Retornos

void

setOffset(offset)

Especifica a distância entre os níveis de etiquetas e a distância entre o primeiro nível e a linha do eixo. O valor deve ser um inteiro de 0 a 1000.

setOffset(offset: number): void;

Parâmetros

offset

number

Retornos

void

setPosition(position)

Especifica a posição do eixo especificado onde o outro eixo se cruza. Veja ExcelScript.ChartAxisPosition para obter detalhes.

setPosition(position: ChartAxisPosition): void;

Parâmetros

Retornos

void

setPositionAt(value)

Define a posição do eixo especificado onde o outro eixo se cruza.

setPositionAt(value: number): void;

Parâmetros

value

number

Valor personalizado do ponto de passagem.

Retornos

void

setReversePlotOrder(reversePlotOrder)

Especifica se o Excel desenha pontos de dados do último ao primeiro.

setReversePlotOrder(reversePlotOrder: boolean): void;

Parâmetros

reversePlotOrder

boolean

Retornos

void

setScaleType(scaleType)

Especifica o tipo de escala do eixo de valores. Veja ExcelScript.ChartAxisScaleType para obter detalhes.

setScaleType(scaleType: ChartAxisScaleType): void;

Parâmetros

Retornos

void

setShowDisplayUnitLabel(showDisplayUnitLabel)

Especifica se a etiqueta da unidade de apresentação do eixo está visível.

setShowDisplayUnitLabel(showDisplayUnitLabel: boolean): void;

Parâmetros

showDisplayUnitLabel

boolean

Retornos

void

setTextOrientation(textOrientation)

Especifica o ângulo para o qual o texto está orientado para a etiqueta de escala do eixo 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

setTickLabelPosition(tickLabelPosition)

Especifica a posição dos rótulos de marcas de escala no eixo especificado. Veja ExcelScript.ChartAxisTickLabelPosition para obter detalhes.

setTickLabelPosition(
            tickLabelPosition: ChartAxisTickLabelPosition
        ): void;

Parâmetros

Retornos

void

setTickLabelSpacing(tickLabelSpacing)

Especifica o número de categorias ou séries entre etiquetas de marca de escala. Pode ter um valor de 1 a 31999.

setTickLabelSpacing(tickLabelSpacing: number): void;

Parâmetros

tickLabelSpacing

number

Retornos

void

setTickMarkSpacing(tickMarkSpacing)

Especifica o número de categorias ou séries entre marcas de escala.

setTickMarkSpacing(tickMarkSpacing: number): void;

Parâmetros

tickMarkSpacing

number

Retornos

void

setVisible(visible)

Especifica se o eixo está visível.

setVisible(visible: boolean): void;

Parâmetros

visible

boolean

Retornos

void