Quais são as novidades na API JavaScript do Excel 1.6
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
Colabore connosco no GitHub
A origem deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever problemas e pedidos Pull. Para mais informações, consulte o nosso guia do contribuidor.