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

Formatação condicional

Introduz 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 APIs

A tabela a seguir lista as APIs no Excel Conjunto de requisitos da API JavaScript 1.6. Para exibir a documentação de referência da API para todas as APIs compatíveis com o conjunto de requisitos da API JavaScript do Excel 1.6 ou anterior, consulte APIs do Excel no conjunto de requisitos 1.6 ou anterior.

Classe Campos Descrição
Aplicativo suspendApiCalculationUntilNextSync() Suspende o cálculo até que o próximo context.sync() seja chamado.
CellValueConditionalFormat format Retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas e outras propriedades dos formatos condicionais.
regra Especifica o objeto de regra nesse 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, médio, máximo), caso contrário, terá dois (mínimo, máximo).
ConditionalCellValueRule Fórmula 1 A fórmula, se necessário, na qual avaliar a regra de formato condicional.
Fórmula2 A fórmula, se necessário, na qual 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 médio O ponto mé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 Em que se deve basear a fórmula condicional do critério.
ConditionalDataBarNegativeFormat borderColor Código de cores HTML que representa a cor da linha de borda, no formato #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 formato #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
matchPositiveBorderColor Especifica se a barra de dados negativos tem a mesma cor de borda que a barra de dados positivos.
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 borda, no formato #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 formato #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
gradiente de preenchimento Especifica se a barra de dados tem um gradiente.
ConditionalDataBarRule formula A fórmula, se necessário, na qual avaliar a regra da barra de dados.
type O tipo de regra para a barra de dados.
ConditionalFormat cellValue Retorna as propriedades de formato condicional do valor da célula se o formato condicional atual é um CellValue tipo.
cellValueOrNullObject Retorna as propriedades de formato condicional do valor da célula se o formato condicional atual é um CellValue tipo.
colorScale Retorna as propriedades de formato condicional da escala de cores se o formato condicional atual for um ColorScale tipo.
colorScaleOrNullObject Retorna as propriedades de formato condicional da escala de cores se o formato condicional atual for um ColorScale tipo.
personalizado Retorna as propriedades de formato condicional personalizadas se o formato condicional atual for um tipo personalizado.
customOrNullObject Retorna as propriedades de formato condicional personalizadas se o formato condicional atual for um tipo personalizado.
barra de dados Retorna as propriedades da barra de dados se o formato condicional atual for uma barra de dados.
dataBarOrNullObject Retorna 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() Retorna o intervalo ao qual o formato condicional é aplicado.
conjunto de ícones Retorna as propriedades de formato condicional do conjunto de ícones se o formato condicional atual for um IconSet tipo.
iconSetOrNullObject Retorna as propriedades de formato condicional do conjunto de ícones se o formato condicional atual for um IconSet tipo.
id A prioridade do formato condicional no arquivo .ConditionalFormatCollection
predefinição Retorna o formato condicional dos critérios predefinidos.
presetOrNullObject Retorna o formato condicional dos critérios predefinidos.
Prioridade A prioridade (ou índice) dentro da coleção de formato condicional em que esse 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 Retorna as propriedades de formato condicional de texto específicas se o formato condicional atual for um tipo de texto.
textComparisonOrNullObject Retorna as propriedades de formato condicional de texto específicas se o formato condicional atual for um tipo de texto.
parte superior inferior Retorna as propriedades de formato condicional superior/inferior se o formato condicional atual for um TopBottom tipo.
topBottomOrNullObject Retorna 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 prioridade primeira/superior.
clearAll() Limpa todos os formatos condicionais ativos no intervalo atual especificado.
getCount() Retorna o número de formatos condicionais na pasta de trabalho.
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, na qual avaliar a regra de formato condicional.
formulaLocal A fórmula, se necessário, na qual avaliar a regra de formato condicional no idioma do usuário.
formulaR1C1 A fórmula, se necessário, na qual avaliar a regra de formato condicional em notação no estilo R1C1.
ConditionalIconCriterion customIcon O ícone personalizado para o critério atual, se diferente do conjunto de ícones padrão, else null será retornado.
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 borda, no formato #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 a borda inferior.
Count Número de objetos de borda da coleção.
getItem(index: 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 a borda esquerda.
direita Obtém a borda certa.
top Obtém a borda 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 a fonte está em negrito.
clear() Redefine os formatos de fonte.
color Representação da cor do texto no código de cores HTML (por exemplo, #FF0000 representa vermelho).
italic Especifica se a fonte está em itálico.
strikethrough Especifica o status tachado da fonte.
underline O tipo de sublinhado aplicado à fonte.
ConditionalRangeFormat Borders Coleção de objetos de borda que se aplicam ao intervalo de formato condicional geral.
fill Retorna o objeto de preenchimento definido no intervalo de formato condicional geral.
font Retorna o objeto de fonte definido no intervalo de formato condicional geral.
numberFormat Representa o código de formato de número do Excel para determinado intervalo.
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 Formate valores com base na classificação superior ou inferior.
CustomConditionalFormat format Retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas e outras propriedades dos formatos condicionais.
regra Especifica o Rule objeto nesse formato condicional.
DataBarConditionalFormat axisColor Código de cores HTML que representa a cor da linha do Eixo, no formato #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 na qual 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.
formato negativo Representação de todos os valores à esquerda do eixo em uma barra de dados do Excel.
formato positivo Representação de todos os valores à direita do eixo em uma 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 possíveis ícones personalizados para ícones condicionais.
reverseIconOrder Se true, inverte as ordens dos ícones para o conjunto de ícones.
showIconOnly Se true, oculta os valores e mostra apenas ícones.
style Se definido, exibe a opção de conjunto de ícones para o formato condicional.
PresetCriteriaConditionalFormat format Retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas 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 dessa ConditionalFormats interseção a cordilheira.
TextConditionalFormat format Retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas e outras propriedades do formato condicional.
regra A regra da formatação condicional.
TopBottomConditionalFormat format Retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas e outras propriedades do formato condicional.
regra Os critérios do formato condicional superior/inferior.
Planilha calculate(markAllDirty: boolean) Calcula todas as células em uma planilha.

Confira também