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
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
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.