Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
stopifTruecapacidade. - 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. |