Compartilhar via


Novidades na API JavaScript do Excel 1.17

O ExcelApi 1.17 expandiu os controles de formatação condicional e adicionou eventos de planilha.

A tabela a seguir fornece um resumo conciso das APIs, enquanto a tabela de lista de API subsequente fornece uma lista detalhada.

Área de recurso Descrição Objetos relevantes
Formatação condicional Alterar regras de formatação condicional. ConditionalFormat, ConditionalRangeFormat
Eventos de planilha Monitore as alterações no nome, visibilidade e posição. Planilha, WorksheetCollection, WorksheetMovedEventArgs, WorksheetNameChangedEventArgs, WorksheetVisibilityChangedEventArgs

Lista de API

A tabela a seguir lista as APIs no conjunto de requisitos de API JavaScript do Excel 1.17. 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.17 ou anterior, consulte APIs do Excel no conjunto de requisitos 1.17 ou anterior.

Classe Campos Descrição
ConditionalFormat changeRuleToCellValue(properties: Excel.ConditionalCellValueRule) Altere o tipo de regra de formato condicional para o valor da célula.
changeRuleToColorScale() Altere o tipo de regra de formato condicional para a escala de cores.
changeRuleToContainsText(properties: Excel.ConditionalTextComparisonRule) Altere o tipo de regra de formato condicional para comparação de texto.
changeRuleToCustom(formula: string) Altere o tipo de regra de formato condicional para personalizado.
changeRuleToDataBar() Altere o tipo de regra de formato condicional para a barra de dados.
changeRuleToIconSet() Altere o tipo de regra de formato condicional para o conjunto de ícones.
changeRuleToPresetCriteria(properties: Excel.ConditionalPresetCriteriaRule) Altere o tipo de regra de formato condicional para critérios predefinidos.
changeRuleToTopBottom(properties: Excel.ConditionalTopBottomRule) Altere o tipo de regra de formato condicional para superior/inferior.
setRanges(ranges: Range | RangeAreas | cadeia de caracteres) Defina os intervalos aos quais a regra de formato conditonal é aplicada.
ConditionalRangeFormat clearFormat() Remova as propriedades de formato de uma regra de formato condicional.
NumberFormatInfo Currencysymbol Obtém o símbolo de moeda para valores de moeda.
Planilha onNameChanged Ocorre quando o nome da planilha é alterado.
onVisibilityChanged Ocorre quando a visibilidade da planilha é alterada.
WorksheetCollection onMoved Ocorre quando uma planilha é movida dentro de uma pasta de trabalho.
onNameChanged Ocorre quando o nome da planilha é alterado na coleção de planilhas.
onVisibilityChanged Ocorre quando a visibilidade da planilha é alterada na coleção de planilhas.
WorksheetMovedEventArgs positionAfter Obtém a nova posição da planilha após a movimentação.
positionBefore Obtém a posição anterior da planilha antes da movimentação.
source A origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha que foi movida.
WorksheetNameChangedEventArgs nameAfter Obtém o novo nome da planilha, após a alteração de nome.
nameBefore Obtém o nome anterior da planilha antes da alteração do nome.
source A origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha com o novo nome.
WorksheetVisibilityChangedEventArgs source A origem do evento.
tipo Obtém o tipo do evento.
visibilityAfter Obtém a nova configuração de visibilidade da planilha, após a alteração da visibilidade.
visibilityBefore Obtém a configuração de visibilidade anterior da planilha antes da alteração da visibilidade.
worksheetId Obtém a ID da planilha cuja visibilidade foi alterada.

Confira também