Compartilhar via

Novidades na API JavaScript 1.8 do Excel

O conjunto de requisitos 1.8 da API JavaScript do Excel inclui APIs para tabelas dinâmicas, validação de dados, gráficos, eventos de gráficos, opções de desempenho e criação de pasta de trabalho.

Tabela Dinâmica

Onda 2 das APIs de Tabela Dinâmica permite que os suplementos definam as hierarquias de uma Tabela Dinâmica. Agora você pode controlar os dados e como eles são agregados. Nosso Artigo de Tabela Dinâmica tem mais informações sobre a nova funcionalidade de tabela dinâmica.

Validação de Dados

A validação de dados permite controlar o que um usuário digita em uma planilha. Você pode limitar as células a conjuntos de respostas predefinidos ou fornecer avisos pop-up sobre entradas indesejadas. Saiba mais sobre adicionar a validação de dados para intervalos hoje.

Gráficos

Outra rodada de APIs de gráficos traz um controle programático ainda maior sobre os elementos do gráfico. Agora você tem maior acesso à legenda, eixos, linha de tendência e área de plotagem.

Eventos

Mais eventos foram adicionados para os gráficos. Faça o seu suplemento reagir aos usuários interagindo com o gráfico. Você também pode alternar eventos disparados em toda a pasta de trabalho.

Lista de API

A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.8. 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.8 ou anterior, veja APIs do Excel no conjunto de requisitos 1.8 ou anterior.

Classe Campos Descrição
global createWorkbook(base64?: cadeia) Crie e abra uma nova pasta de trabalho.
BasicDataValidation fórmula1 Especifica o operando da direita quando a propriedade do operador está definida para um operador binário, como GreaterThan (o operando esquerdo é o valor que o utilizador tenta introduzir na célula).
fórmula2 Com os operadores ternary Entre e NotBetween, especifica o operando de limite superior.
operator O operador a ser usado para validar os dados.
Gráfico categoryLabelLevel Especifica uma constante de enumeração de nível de etiqueta de categoria de gráfico, referindo-se ao nível das etiquetas da categoria de origem.
displayBlanksAs Especifica a forma como as células em branco são desenhadas num gráfico.
onActivated Ocorre quando o gráfico é ativado.
onDeactivated Ocorre quando o gráfico é desativado.
plotArea Representa a área de desenho do gráfico.
plotBy Especifica a forma como as colunas ou linhas são usadas como série de dados no gráfico.
plotVisibleOnly Verdadeiro se apenas as células visíveis forem plotadas.
seriesNameLevel Especifica uma constante de enumeração ao nível do nome da série de gráficos, referindo-se ao nível dos nomes das séries de origem.
showDataLabelsOverMaximum Especifica se pretende mostrar as etiquetas de dados quando o valor é maior do que o valor máximo no eixo de valores.
style Especifica o estilo de gráfico para o gráfico.
ChartActivatedEventArgs chartId Obtém o ID do gráfico que está ativado.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o gráfico está ativado.
ChartAddedEventArgs chartId Obtém o ID do gráfico que é adicionado à folha de cálculo.
source Obtém a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o gráfico é adicionado.
ChartAxis alinhamento Especifica o alinhamento para a etiqueta de escala do eixo especificado.
isBetweenCategories Especifica se o eixo de valores cruza o eixo de categoria entre categorias.
múltiplos Níveis Especifica se um eixo tem múltiplos níveis.
numberFormat Especifica o código de formato para a etiqueta de escala do eixo.
desvio Especifica a distância entre os níveis de etiquetas e a distância entre o primeiro nível e a linha do eixo.
position Especifica a posição do eixo especificado onde o outro eixo se cruza.
positionAt Especifica a posição do eixo em que o outro eixo se cruza.
setPositionAt(valor: número) Define a posição do eixo especificado onde o outro eixo se cruza.
textOrientation Especifica o ângulo para o qual o texto está orientado para a etiqueta de escala do eixo do gráfico.
ChartAxisFormat fill Especifica a formatação de preenchimento do gráfico.
ChartAxisTitle setFormula(fórmula: cadeia) Um valor de cadeia de caracteres que representa a fórmula do título do eixo do gráfico usando a notação no estilo A1.
ChartAxisTitleFormat limite Especifica o formato de limite do título do eixo do gráfico, que inclui cor, estilo de linha e espessura.
fill Especifica a formatação de preenchimento do título do eixo do gráfico.
ChartBorder clear() Limpa a formatação da borda de um elemento do gráfico.
ChartCollection onActivated Ocorre quando um gráfico é ativado.
onAdded Ocorre quando um novo gráfico é adicionado à folha de cálculo.
onDeactivated Ocorre quando um gráfico é desativado.
onDeleted Ocorre quando um gráfico é eliminado.
ChartDataLabel texto automático Especifica se a etiqueta de dados gera automaticamente texto adequado com base no contexto.
format Representa o formato do rótulo de dados do gráfico.
formula Valor de cadeia de caracteres que representa a fórmula do título do rótulo de dados usando a notação no estilo A1.
height Retorna a altura, em pontos, do rótulo de dados do gráfico.
horizontalAlignment Representa o alinhamento horizontal de rótulo de dados do gráfico.
left Representa a distância, em pontos, da borda esquerda do rótulo de dados do gráfico até a borda esquerda da área do gráfico.
numberFormat Especifica o código de formato para a etiqueta de dados.
text Cadeia de caracteres que representa o texto do rótulo de dados em um gráfico.
textOrientation Representa o ângulo para o qual o texto é orientado para a etiqueta de dados do gráfico.
top Representa a distância, em pontos, da borda superior do rótulo de dados do gráfico até a borda superior da área do gráfico.
verticalAlignment Representa o alinhamento vertical do rótulo de dados do gráfico.
width Retorna a largura, em pontos, do rótulo de dados do gráfico.
ChartDataLabelFormat limite Representa o formato de borda, que inclui a espessura de cor e estilo de linha.
ChartDataLabels texto automático Especifica se as etiquetas de dados geram automaticamente texto adequado com base no contexto.
horizontalAlignment Especifica o alinhamento horizontal para a etiqueta de dados do gráfico.
numberFormat Especifica o código de formato para etiquetas de dados.
textOrientation Representa o ângulo para o qual o texto é orientado para etiquetas de dados.
verticalAlignment Representa o alinhamento vertical do rótulo de dados do gráfico.
ChartDeactivatedEventArgs chartId Obtém o ID do gráfico que é desativado.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o gráfico é desativado.
ChartDeletedEventArgs chartId Obtém o ID do gráfico que é eliminado da folha de cálculo.
source Obtém a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o gráfico é eliminado.
ChartLegendEntry height Especifica a altura da entrada de legenda na legenda do gráfico.
índice Especifica o índice da entrada de legenda na legenda do gráfico.
left Especifica o valor esquerdo de uma entrada de legenda de gráfico.
top Especifica a parte superior de uma entrada de legenda de gráfico.
width Representa a largura da entrada de legenda no gráfico Legenda.
ChartLegendFormat limite Representa o formato de borda, que inclui a espessura de cor e estilo de linha.
ChartPlotArea format Especifica a formatação de uma área de desenho de gráfico.
height Especifica o valor de altura de uma área de desenho.
insideHeight Especifica o valor de altura interior de uma área de desenho.
insideLeft Especifica o valor interior esquerdo de uma área de desenho.
insideTop Especifica o valor superior interno de uma área de desenho.
insideWidth Especifica o valor de largura interna de uma área de desenho.
left Especifica o valor esquerdo de uma área de desenho.
position Especifica a posição de uma área de desenho.
top Especifica o valor superior de uma área de desenho.
width Especifica o valor de largura de uma área de desenho.
ChartPlotAreaFormat limite Especifica os atributos de limite de uma área de desenho de gráfico.
fill Especifica o formato de preenchimento de um objeto, que inclui informações de formatação de fundo.
ChartSeries axisGroup Especifica o grupo para a série especificada.
dataLabels Representa uma coleção de todas as etiquetas de dados da série.
explosão Especifica o valor de explosão para um gráfico circular ou um setor de gráfico em anel.
firstSliceAngle Especifica o ângulo do primeiro gráfico circular ou gráfico em anel, em graus (no sentido dos ponteiros do relógio a partir da vertical).
invertIfNegative Verdadeiro se o Excel inverter o padrão no item quando corresponde a um número negativo.
sobreposição Especifica como barras e colunas são posicionadas.
secondPlotSize Especifica o tamanho da secção secundária de um gráfico circular de circular ou de um gráfico de barras de circulares, como uma percentagem do tamanho do circular primário.
splitType Especifica a forma como as duas secções de um gráfico circular de circular ou de um gráfico de barras de circular são divididas.
varyByCategories Verdadeiro se o Excel atribuir uma cor ou padrão diferente a cada marcador de dados.
ChartTrendline retroperiod Representa o número de períodos que a linha de tendência se estende para trás.
forwardPeriod Representa o número de períodos que a linha de tendência se estende para frente.
etiqueta Representa o rótulo de linha de tendência um gráfico.
showEquation Verdadeiro se a equação da linha de tendência for exibida no gráfico.
showRSquared Verdadeiro se o valor r-quadrado da linha de tendência for apresentado no gráfico.
ChartTrendlineLabel texto automático Especifica se a etiqueta de linha de tendência gera automaticamente texto adequado com base no contexto.
format O formato da etiqueta da linha de tendência do gráfico.
formula Valor da cadeia que representa a fórmula da etiqueta da linha de tendência do gráfico com notação de estilo A1.
height Retorna a altura, em pontos, do rótulo de linha de tendência do gráfico.
horizontalAlignment Representa o alinhamento horizontal da etiqueta de linha de tendência do gráfico.
left Representa a distância, em pontos, desde a margem esquerda da etiqueta da linha de tendência do gráfico até à margem esquerda da área do gráfico.
numberFormat Valor da cadeia que representa o código de formato para a etiqueta da linha de tendência.
text Cadeia de caracteres que representa o texto do rótulo em um gráfico de linha de tendência.
textOrientation Representa o ângulo para o qual o texto é orientado para a etiqueta da linha de tendência do gráfico.
top Representa a distância, em pontos, desde a margem superior da etiqueta da linha de tendência do gráfico até à parte superior da área do gráfico.
verticalAlignment Representa o alinhamento vertical da etiqueta de linha de tendência do gráfico.
width Retorna a largura, em pontos, do rótulo de linha de tendência do gráfico.
ChartTrendlineLabelFormat limite Especifica o formato de limite, que inclui cor, estilo de linha e espessura.
fill Especifica o formato de preenchimento da etiqueta de linha de tendência do gráfico atual.
font Especifica os atributos do tipo de letra (como o nome do tipo de letra, o tamanho do tipo de letra e a cor) para uma etiqueta de linha de tendência do gráfico.
CustomDataValidation formula Uma fórmula de validação de dados personalizados.
DataPivotHierarchy campo Retorna PivotFields associados a DataPivotHierarchy.
id ID da DataPivotHierarchy.
name Nome da DataPivotHierarchy.
numberFormat Formato de número do DataPivotHierarchy.
position Posição da DataPivotHierarchy.
setToDefault() Redefina a DataPivotHierarchy para os valores padrão.
showAs Especifica se os dados devem ser apresentados como um cálculo de resumo específico.
summarizeBy Especifica se todos os itens da DataPivotHierarchy são apresentados.
DataPivotHierarchyCollection add(pivotHierarchy: Excel.PivotHierarchy) Adiciona o PivotHierarchy ao eixo atual.
getCount() Obtém o número de hierarquias dinâmicas na coleção.
getItem(name: string) Obtém uma DataPivotHierarchy pelo respetivo nome ou ID.
getItemOrNullObject(name: string) Obtém uma DataPivotHierarchy por nome.
items Obtém os itens filhos carregados nesta coleção.
remove(DataPivotHierarchy: Excel.DataPivotHierarchy) Remove o PivotHierarchy do eixo atual.
DataValidation clear() Desfazer a validação de dados do intervalo atual.
errorAlert Alerta de erro quando o usuário insere dados inválidos.
ignoreBlanks Especifica se a validação de dados será efetuada em células em branco.
prompt Perguntar quando os utilizadores selecionam uma célula.
regra Regra de validação de dados que contém diferentes tipos de critérios de validação de dados.
type Tipo de validação de dados, veja Excel.DataValidationType para obter detalhes.
válido Representa se todos os valores de célula são válidos de acordo com as regras de validação de dados.
DataValidationErrorAlert message Representa a mensagem de alerta de erro.
showAlert Especifica se pretende mostrar uma caixa de diálogo de alerta de erro quando um utilizador introduz dados inválidos.
style O tipo de alerta de validação de dados, veja Excel.DataValidationAlertStyle para obter detalhes.
title Representa o título da caixa de diálogo de alerta de erro.
DataValidationPrompt message Especifica a mensagem do pedido.
showPrompt Especifica se é apresentado um pedido quando um utilizador seleciona uma célula com validação de dados.
title Especifica o título da linha de comandos.
DataValidationRule personalizado Critérios de validação de dados personalizados.
data Critérios de validação de dados de data.
decimal Critérios de validação de dados decimais.
list Critérios de validação de dados da lista.
textLength Critérios de validação de dados de comprimento de texto.
time Critérios de validação de dados de tempo.
wholeNumber Critérios de validação de dados de número inteiro.
DateTimeDataValidation fórmula1 Especifica o operando da direita quando a propriedade do operador está definida para um operador binário, como GreaterThan (o operando esquerdo é o valor que o utilizador tenta introduzir na célula).
fórmula2 Com os operadores ternary Entre e NotBetween, especifica o operando de limite superior.
operator O operador a ser usado para validar os dados.
FilterPivotHierarchy enableMultipleFilterItems Determina se deseja permitir vários itens de filtro.
campos Retorna PivotFields associados a FilterPivotHierarchy.
id ID da FilterPivotHierarchy.
name Nome do FilterPivotHierarchy.
position Posição do FilterPivotHierarchy.
setToDefault() Redefina a FilterPivotHierarchy para os valores padrão.
FilterPivotHierarchyCollection add(pivotHierarchy: Excel.PivotHierarchy) Adiciona o PivotHierarchy ao eixo atual.
getCount() Obtém o número de hierarquias dinâmicas na coleção.
getItem(name: string) Obtém uma FilterPivotHierarchy pelo respetivo nome ou ID.
getItemOrNullObject(name: string) Obtém um FilterPivotHierarchy por nome.
items Obtém os itens filhos carregados nesta coleção.
remove(filterPivotHierarchy: Excel.FilterPivotHierarchy) Remove o PivotHierarchy do eixo atual.
ListDataValidation inCellDropDown Especifica se pretende apresentar a lista num menu pendente de células.
source Fonte da lista de validação de dados
PivotField id ID do Campo Dinâmico.
items Devolve osItems Dinâmicos associados ao Campo Dinâmico.
name Nome do PivotField.
showAllItems Determina se deseja mostrar todos os itens de PivotField.
sortByLabels(sortBy: SortBy) Classifica o PivotField.
subtotals Subtotais de PivotField.
PivotFieldCollection getCount() Obtém o número de campos dinâmicos na coleção.
getItem(name: string) Obtém um Campo Dinâmico pelo respetivo nome ou ID.
getItemOrNullObject(name: string) Obtém um Campo Dinâmico pelo nome.
items Obtém os itens filhos carregados nesta coleção.
PivotHierarchy campos Retorna PivotFields associados a PivotHierarchy.
id ID da PivotHierarchy.
name Nome do PivotHierarchy.
PivotHierarchyCollection getCount() Obtém o número de hierarquias dinâmicas na coleção.
getItem(name: string) Obtém uma PivotHierarchy pelo respetivo nome ou ID.
getItemOrNullObject(name: string) Obtém o PivotHierarchy por nome.
items Obtém os itens filhos carregados nesta coleção.
PivotItem id ID doItem Dinâmico.
isExpanded Determina se o item está expandido para mostrar itens filho ou se ele está recolhido e os itens filho estão ocultos.
name Nome do PivotItem.
visible Especifica se o PivotItem está visível.
PivotItemCollection getCount() Obtém o número deItems Dinâmicos na coleção.
getItem(name: string) Obtém um PivotItem pelo respetivo nome ou ID.
getItemOrNullObject(name: string) Obtém um PivotItem pelo nome.
items Obtém os itens filhos carregados nesta coleção.
PivotLayout getColumnLabelRange() Retorna o intervalo onde residem os rótulos de coluna da Tabela Dinâmica.
getDataBodyRange() Retorna o intervalo onde residem os valores de dados da tabela dinâmica.
getFilterAxisRange() Retorna o intervalo de área de filtro da Tabela Dinâmica.
getRange() Retorna o intervalo em que a Tabela Dinâmica existe, excluindo a área de filtro.
getRowLabelRange() Retorna o intervalo onde residem os rótulos de linha da Tabela Dinâmica.
layoutType Essa propriedade indica o PivotLayoutType de todos os campos da Tabela Dinâmica.
showColumnGrandTotals Especifica se o relatório de tabela dinâmica mostra os totais gerais das colunas.
showRowGrandTotals Especifica se o relatório de tabela dinâmica mostra os totais gerais das linhas.
subtotalLocation Esta propriedade indica o SubtotalLocationType de todos os campos na tabela dinâmica.
PivotTable columnHierarchies As hierarquias de pivô da coluna da Tabela Dinâmica.
dataHierarchies As hierarquias dinâmicas de dados da Tabela Dinâmica.
delete() Exclui a Tabela Dinâmica.
filterHierarchies As hierarquias de pivô do filtro da Tabela Dinâmica.
hierarquias Hierarquias pivô da Tabela Dinâmica.
esquema O PivotLayout descreve o layout e estrutura visual da Tabela Dinâmica.
rowHierarchies As hierarquias de pivô de linha da Tabela Dinâmica.
PivotTableCollection add(name: string, source: Range | string | Tabela, destino: Intervalo | cadeia) Adicione uma tabela dinâmica com base nos dados de origem especificados e insira-a na célula superior esquerda do intervalo de destino.
Range dataValidation Retorna um objeto de validação de dados.
RowColumnPivotHierarchy campos Retorna PivotFields associados a RowColumnPivotHierarchy.
id ID da RowColumnPivotHierarchy.
name Nome da RowColumnPivotHierarchy.
position Posição da RowColumnPivotHierarchy.
setToDefault() Redefine o RowColumnPivotHierarchy para os valores padrão.
RowColumnPivotHierarchyCollection add(pivotHierarchy: Excel.PivotHierarchy) Adiciona o PivotHierarchy ao eixo atual.
getCount() Obtém o número de hierarquias dinâmicas na coleção.
getItem(name: string) Obtém uma RowColumnPivotHierarchy pelo respetivo nome ou ID.
getItemOrNullObject(name: string) Obtém um RowColumnPivotHierarchy por nome.
items Obtém os itens filhos carregados nesta coleção.
remove(rowColumnPivotHierarchy: Excel.RowColumnPivotHierarchy) Remove o PivotHierarchy do eixo atual.
Tempo de execução enableEvents Alterne os eventos JavaScript no painel de tarefas ou no suplemento de conteúdo atual.
ShowAsRule campo base O Campo Dinâmico no qual basear o ShowAs cálculo, se aplicável de acordo com o ShowAsCalculation tipo, senão null.
baseItem O item no qual basear o ShowAs cálculo, se aplicável de acordo com o ShowAsCalculation tipo, senão null.
cálculo O ShowAs cálculo a utilizar para o Campo Dinâmico.
Estilo autoIndent Especifica se o texto é automaticamente avanço quando o alinhamento do texto numa célula é definido como distribuição igual.
textOrientation A orientação de texto para o estilo.
Subtotals automatic Se Automatic estiver definido como true, todos os outros valores serão ignorados ao definir o Subtotals.
média
Count
countNumbers
máx.
min
produto
PadrãoDeviation
standardDeviationP
soma
variância
variânciaP
Table legacyId Devolve um ID numérico.
TableChangedEventArgs getRange(ctx: Excel.RequestContext) Obtém o intervalo que representa a área alterada de uma tabela numa folha de cálculo específica.
getRangeOrNullObject(ctx: Excel.RequestContext) Obtém o intervalo que representa a área alterada de uma tabela numa folha de cálculo específica.
Pasta de trabalho readOnly Devolve true se o livro estiver aberto no modo só de leitura.
WorkbookCreated O WorkbookCreated objeto é o objeto de nível superior criado por Application.CreateWorkbook.
Planilha onCalculated Ocorre quando a folha de cálculo é calculada.
showGridlines Especifica se as linhas de grelha estão visíveis para o utilizador.
showHeadings Especifica se os cabeçalhos estão visíveis para o utilizador.
WorksheetCalculatedEventArgs tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o cálculo ocorreu.
WorksheetChangedEventArgs getRange(ctx: Excel.RequestContext) Obtém o intervalo que representa a área alterada de uma planilha específica.
getRangeOrNullObject(ctx: Excel.RequestContext) Obtém o intervalo que representa a área alterada de uma planilha específica.
WorksheetCollection onCalculated Ocorre quando uma folha de cálculo no livro é calculada.

Confira também

  • Last updated on