Quais são as novidades na API JavaScript do Excel 1.6

  • Artigo

Formatação condicional

Apresenta a formatação condicional de um intervalo. Permite os seguintes tipos de formatação condicional.

  • Escala de cores
  • Barra de dados
  • Conjunto de ícones
  • Personalizado

Além disso:

  • Retorna o intervalo ao qual o formatato condicional é aplicada.
  • Remoção da formatação condicional.
  • Fornece prioridade e stopifTrue capacidade.
  • Obtém a coleção de toda a formatação condicional em um determinado intervalo.
  • Limpa todos os formatos condicionais ativos no intervalo atual especificado.

Lista de API

A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.6. Para ver a documentação de referência da API para todas as APIs suportadas pelo conjunto de requisitos da API JavaScript do Excel definido como 1.6 ou anterior, veja APIs do Excel no conjunto de requisitos 1.6 ou anterior.

Classe Campos Descrição
Aplicativo suspendApiCalculationUntilNextSync() Suspende o cálculo até ser chamado o seguinte context.sync() .
CellValueConditionalFormat format Devolve um objeto de formatação, encapsulando o tipo de letra, preenchimento, limites e outras propriedades dos formatos condicionais.
regra Especifica o objeto de regra neste formato condicional.
ColorScaleConditionalFormat critério Os critérios da escala de cores.
threeColorScale Se true, a escala de cores terá três pontos (mínimo, ponto intermédio, máximo), caso contrário, terá dois (mínimo, máximo).
ConditionalCellValueRule fórmula1 A fórmula, se necessário, para avaliar a regra de formato condicional.
fórmula2 A fórmula, se necessário, para avaliar a regra de formato condicional.
operator O operador do formato condicional do valor da célula.
ConditionalColorScaleCriteria maximum O ponto máximo do critério de escala de cores.
ponto intermédio O ponto intermédio do critério de escala de cores, se a escala de cores for uma escala de 3 cores.
minimum O ponto mínimo do critério de escala de cores.
ConditionalColorScaleCriterion color Representação do código de cores HTML da cor da escala de cores (por exemplo, #FF0000 representa Vermelho).
formula Um número, uma fórmula ou null (se type for lowestValue).
type No que deve basear-se a fórmula condicional de critério.
ConditionalDataBarNegativeFormat borderColor Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
fillColor Código de cores HTML que representa a cor de preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
matchPositiveBorderColor Especifica se a barra de dados negativa tem a mesma cor de limite que a barra de dados positiva.
matchPositiveFillColor Especifica se a barra de dados negativa tem a mesma cor de preenchimento que a barra de dados positiva.
ConditionalDataBarPositiveFormat borderColor Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
fillColor Código de cores HTML que representa a cor de preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
gradientFill Especifica se a barra de dados tem uma gradação.
ConditionalDataBarRule formula A fórmula, se necessário, para avaliar a regra da barra de dados.
type O tipo de regra para a barra de dados.
ConditionalFormat cellValue Devolve as propriedades do formato condicional do valor da célula se o formato condicional atual for um CellValue tipo.
cellValueOrNullObject Devolve as propriedades do formato condicional do valor da célula se o formato condicional atual for um CellValue tipo.
colorScale Devolve as propriedades do formato condicional da escala de cores se o formato condicional atual for um ColorScale tipo.
colorScaleOrNullObject Devolve as propriedades do formato condicional da escala de cores se o formato condicional atual for um ColorScale tipo.
personalizado Devolve as propriedades de formato condicional personalizado se o formato condicional atual for um tipo personalizado.
customOrNullObject Devolve as propriedades de formato condicional personalizado se o formato condicional atual for um tipo personalizado.
barra de dados Devolve as propriedades da barra de dados se o formato condicional atual for uma barra de dados.
dataBarOrNullObject Devolve as propriedades da barra de dados se o formato condicional atual for uma barra de dados.
delete() Exclui esse formato condicional.
getRange() Retorna o intervalo ao qual o formatato condicional é aplicada.
getRangeOrNullObject() Devolve o intervalo ao qual o formato condicional é aplicado.
iconSet Devolve as propriedades do formato condicional do conjunto de ícones se o formato condicional atual for um IconSet tipo.
iconSetOrNullObject Devolve as propriedades do formato condicional do conjunto de ícones se o formato condicional atual for um IconSet tipo.
id A prioridade do formato condicional no atual ConditionalFormatCollection.
predefinição Devolve o formato condicional dos critérios predefinidos.
presetOrNullObject Devolve o formato condicional dos critérios predefinidos.
prioridade A prioridade (ou índice) na coleção de formatos condicionais em que este formato condicional existe atualmente.
stopIfTrue Se as condições desse formato condicional forem atendidas, nenhum formato de prioridade mais baixa terá efeito nessa célula.
textComparison Devolve as propriedades específicas do formato condicional de texto se o formato condicional atual for um tipo de texto.
textComparisonOrNullObject Devolve as propriedades específicas do formato condicional de texto se o formato condicional atual for um tipo de texto.
topBottom Devolve as propriedades de formato condicional superior/inferior se o formato condicional atual for um TopBottom tipo.
topBottomOrNullObject Devolve as propriedades de formato condicional superior/inferior se o formato condicional atual for um TopBottom tipo.
type Um tipo de formato condicional.
ConditionalFormatCollection add(type: Excel.ConditionalFormatType) Adiciona um novo formato condicional à coleção na primeira/prioridade máxima.
clearAll() Limpa todos os formatos condicionais ativos no intervalo atual especificado.
getCount() Devolve o número de formatos condicionais no livro.
getItem(id: string) Retorna um formato condicional para o ID fornecido.
getItemAt(index: number) Retorna um formato condicional no índice fornecido.
items Obtém os itens filhos carregados nesta coleção.
ConditionalFormatRule formula A fórmula, se necessário, para avaliar a regra de formato condicional.
formulaLocal A fórmula, se necessário, para avaliar a regra de formato condicional no idioma do utilizador.
formulaR1C1 A fórmula, se necessário, para avaliar a regra de formato condicional na notação de estilo R1C1.
ConditionalIconCriterion customIcon O ícone personalizado para o critério atual, se diferente do conjunto de ícones predefinido, será devolvido.null
formula Um número ou uma fórmula, dependendo do tipo.
operator greaterThan ou greaterThanOrEqual para cada um dos tipos de regra para o formato condicional do ícone.
type No que a fórmula condicional de ícone deve se basear.
ConditionalPresetCriteriaRule critério O critério do formato condicional.
ConditionalRangeBorder color Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
sideIndex Valor constante que indica o lado específico da borda.
style Uma das constantes de estilo de linha especificando o estilo de linha da borda.
ConditionalRangeBorderCollection bottom Obtém o limite inferior.
Count Número de objetos de borda da coleção.
getItem(índice: Excel.ConditionalRangeBorderIndex) Obtém um objeto Border usando o respectivo nome.
getItemAt(index: number) Obtém um objeto Border usando o respectivo índice.
items Obtém os itens filhos carregados nesta coleção.
left Obtém o limite esquerdo.
direita Obtém o limite certo.
top Obtém o limite superior.
ConditionalRangeFill clear() Redefine o preenchimento.
color Código de cores HTML que representa a cor do preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
ConditionalRangeFont bold Especifica se o tipo de letra está a negrito.
clear() Redefine os formatos de fonte.
color Representação do código de cores HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).
italic Especifica se o tipo de letra é itálico.
strikethrough Especifica a status rasurado do tipo de letra.
underline O tipo de sublinhado aplicado ao tipo de letra.
ConditionalRangeFormat Borders Coleção de objetos de limite que se aplicam ao intervalo de formato condicional geral.
fill Devolve o objeto de preenchimento definido no intervalo de formato condicional geral.
font Devolve o objeto de tipo de letra definido no intervalo de formato condicional geral.
numberFormat Representa o código de formato de número do Excel para o intervalo especificado.
ConditionalTextComparisonRule operator O operador do formato condicional de texto.
text O valor de texto do formato condicional.
ConditionalTopBottomRule Classificação A classificação entre 1 e 1000 para classificações numéricas ou 1 e 100 para classificações percentuais.
type Formatar valores com base na classificação superior ou inferior.
CustomConditionalFormat format Devolve um objeto de formatação, encapsulando o tipo de letra, preenchimento, limites e outras propriedades dos formatos condicionais.
regra Especifica o Rule objeto neste formato condicional.
DataBarConditionalFormat eixoColor Código de cores HTML que representa a cor da linha eixo, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
axisFormat Representação de como o eixo é determinado para uma barra de dados do Excel.
barDirection Especifica a direção em que o gráfico da barra de dados deve ser baseado.
lowerBoundRule A regra para o que constitui o limite inferior (e como calculá-lo, se aplicável) para uma barra de dados.
negativeFormat Representação de todos os valores à esquerda do eixo numa barra de dados do Excel.
positiveFormat Representação de todos os valores à direita do eixo numa barra de dados do Excel.
showDataBarOnly Se true, oculta os valores das células onde a barra de dados é aplicada.
upperBoundRule A regra para o que constitui o limite superior (e como calculá-lo, se aplicável) para uma barra de dados.
IconSetConditionalFormat critério Uma matriz de critérios e conjuntos de ícones para as regras e potenciais ícones personalizados para ícones condicionais.
reverseIconOrder Se true, inverter as encomendas de ícones do conjunto de ícones.
showIconOnly Se true, oculta os valores e mostra apenas os ícones.
style Se estiver definido, apresenta a opção de conjunto de ícones para o formato condicional.
PresetCriteriaConditionalFormat format Devolve um objeto de formatação, encapsulando o tipo de letra, preenchimento, limites e outras propriedades dos formatos condicionais.
regra A regra da formatação condicional.
Range calculate() Calcula um intervalo de células em uma planilha.
conditionalFormats A coleção do ConditionalFormats que intersecta o intervalo.
TextConditionalFormat format Devolve um objeto de formato, encapsulando o tipo de letra, o preenchimento, os limites e outras propriedades do formato condicional.
regra A regra da formatação condicional.
TopBottomConditionalFormat format Devolve um objeto de formato, encapsulando o tipo de letra, o preenchimento, os limites e outras propriedades do formato condicional.
regra Os critérios do formato condicional superior/inferior.
Planilha calculate(markAllDirty: booleano) Calcula todas as células em uma planilha.

Confira também