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 funcionalidade.
  • 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 a seguir lista as APIs no conjunto de requisitos de API JavaScript do Excel 1.6. Para exibir a documentação de referência da API para todas as APIs com suporte no 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 de formatos condicionais, preenchimento, bordas e outras propriedades.
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, ponto médio, máximo), caso contrário, terá dois (mínimo, máximo).
ConditionalCellValueRule formula1 A fórmula, se necessário, na qual avaliar a regra de formato condicional.
formula2 A fórmula, se necessário, na qual avaliar a regra de formato condicional.
operator O operador do formato condicional de valor celular.
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 três cores.
minimum O ponto mínimo do critério de escala de cores.
ConditionalColorScaleCriterion color Representação de código de cor 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 a fórmula condicional do critério deve ser baseada.
ConditionalDataBarNegativeFormat Bordercolor Código de cor HTML que representa a cor da linha de borda, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
Fillcolor Código de cor 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 da borda 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 cor HTML que representa a cor da linha de borda, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
Fillcolor Código de cor 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 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 de valor celular se o formato condicional atual for um CellValue tipo.
cellValueOrNullObject Retorna as propriedades de formato condicional de valor celular se o formato condicional atual for um CellValue tipo.
colorScale Retorna as propriedades de formato condicional de escala de cor se o formato condicional atual for um ColorScale tipo.
colorScaleOrNullObject Retorna as propriedades de formato condicional de escala de cor se o formato condicional atual for um ColorScale tipo.
Personalizado Retorna as propriedades de formato condicional personalizado se o formato condicional atual for um tipo personalizado.
customOrNullObject Retorna as propriedades de formato condicional personalizado se o formato condicional atual for um tipo personalizado.
dataBar 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 a formatação condicional é aplicada.
getRangeOrNullObject() Retorna o intervalo ao qual o formato conditonal é aplicado.
Iconset Retorna as propriedades de formato condicional de conjunto de ícones se o formato condicional atual for um IconSet tipo.
iconSetOrNullObject Retorna as propriedades de formato condicional de conjunto de ícones se o formato condicional atual for um IconSet tipo.
id A prioridade do formato condicional no atual ConditionalFormatCollection.
Predefinição Retorna o formato condicional de critérios predefinidos.
presetOrNullObject Retorna o formato condicional de critérios predefinidos.
Prioridade A prioridade (ou índice) na 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 específicas de formato condicional de texto se o formato condicional atual for um tipo de texto.
textComparisonOrNullObject Retorna as propriedades específicas de formato condicional de texto se o formato condicional atual for um tipo de texto.
topBottom 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 de 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 na notação de estilo R1C1.
ConditionalIconCriterion customIcon O ícone personalizado para o critério atual, se diferente do conjunto de ícones padrão, o restante 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 de í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 cor HTML que representa a cor da linha de borda, no formulário #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 direita.
top Obtém a borda superior.
ConditionalRangeFill clear() Redefine o preenchimento.
color Código de cor 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 é em negrito.
clear() Redefine os formatos de fonte.
color Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).
italic Especifica se a fonte é itálica.
strikethrough Especifica o status de strikethrough 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 o intervalo determinado.
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 Retorna um objeto de formato, encapsulando a fonte de formatos condicionais, preenchimento, bordas e outras propriedades.
Regra Especifica o Rule objeto nesse formato condicional.
DataBarConditionalFormat axisColor Código de cor HTML que representa a cor da linha Axis, no formulário #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.
negativeFormat Representação de todos os valores à esquerda do eixo em uma barra de dados do Excel.
positiveFormat Representação de todos os valores à direita do eixo em uma barra de dados do Excel.
showDataBarOnly Se true, ocultar os valores das células em que 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 de ícone para o conjunto de ícones.
showIconOnly Se true, ocultar os valores e mostrar somente í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 de formatos condicionais, preenchimento, bordas e outras propriedades.
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 cruza o intervalo.
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: booleano) Calcula todas as células em uma planilha.

Confira também