Novidades na API JavaScript 1.9 do Excel
Mais de 500 novas APIs do Excel foram introduzidas com o conjunto de requisitos 1.9. A primeira tabela fornece um resumo conciso das APIs e, a tabela subsequente, fornece uma lista detalhada.
Área de recurso | Descrição | Objetos relevantes |
---|---|---|
Shapes | Inserir, posicionar e formatar imagens, formas geométricas e caixas de texto. | ShapeCollectionShapeGeometricShapeImage |
Filtro Automático | Adicionar filtros aos intervalos. | AutoFilter |
Areas | Suporte para intervalos descontínuos. | RangeAreas |
Células Especiais | Obtenha células que contêm datas, comentários ou fórmulas dentro de um intervalo. | Range |
Find | Encontre valores ou fórmulas em uma planilha ou intervalo. | RangeWorksheet |
Copiar e colar | Copie fórmulas, formatos e valores de um intervalo para outro. | Range |
Calculation | Maior controle sobre o mecanismo de cálculo do Excel. | Aplicativo |
Novos Gráficos | Explore os novos tipos de gráficos compatíveis: mapas, caixa estreita, cascata, explosão solar, pareto. e funil. | Chart |
RangeFormat | Novos recursos com formatos de intervalo. | Range |
Lista de API
A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.9. Para ver API reference documentation for all APIs supported by Excel JavaScript API requirement set 1.9 or earlier, see Excel APIs in requirement set 1.9 or earlier.
Classe | Campos | Descrição |
---|---|---|
Aplicativo | calculationEngineVersion | Retorna a versão do mecanismo de cálculo do Excel usada para o último recálculo completo. |
calculationState | Retorna o estado de cálculo do aplicativo. | |
iterativeCalculation | Devolve as definições de cálculo iterativo. | |
suspendScreenUpdatingUntilNextSync() | Suspende a atualização do ecrã até que a próxima context.sync() seja chamada. |
|
AutoFilter | apply(intervalo: Intervalo | cadeia, columnIndex?: número, critérios?: Excel.FilterCriteria) | Aplica o AutoFiltro a um intervalo. |
clearCriteria() | Limpa os critérios de filtro e o estado de ordenação do Filtro Automático. | |
criteria | Uma matriz que contém todos os critérios de filtro no intervalo de autofiltro. | |
enabled | Especifica se o Filtro Automático está ativado. | |
getRange() | Devolve o Range objeto que representa o intervalo ao qual o Filtro Automático se aplica. |
|
getRangeOrNullObject() | Devolve o Range objeto que representa o intervalo ao qual o Filtro Automático se aplica. |
|
isDataFiltered | Especifica se o Filtro Automático tem critérios de filtro. | |
reapply() | Aplica o objeto filtro automático especificado atualmente no intervalo. | |
remove() | Remove o Filtro automático do intervalo. | |
CellBorder | color | Representa a propriedade color de uma única borda. |
style | Representa a propriedade style de uma única borda. |
|
tintAndShade | Representa a propriedade tintAndShade de uma única borda. |
|
weight | Representa a propriedade weight de uma única borda. |
|
CellBorderCollection | bottom | Representa a propriedade format.borders.bottom . |
diagonalDown | Representa a propriedade format.borders.diagonalDown . |
|
diagonalUp | Representa a propriedade format.borders.diagonalUp . |
|
horizontal | Representa a propriedade format.borders.horizontal . |
|
left | Representa a propriedade format.borders.left . |
|
direita | Representa a propriedade format.borders.right . |
|
top | Representa a propriedade format.borders.top . |
|
vertical | Representa a propriedade format.borders.vertical . |
|
CellProperties | address | Representa a propriedade address . |
addressLocal | Representa a propriedade addressLocal . |
|
hidden | Representa a propriedade hidden . |
|
CellPropertiesFill | color | Representa a propriedade format.fill.color . |
padrão | Representa a propriedade format.fill.pattern . |
|
patternColor | Representa a propriedade format.fill.patternColor . |
|
patternTintAndShade | Representa a propriedade format.fill.patternTintAndShade . |
|
tintAndShade | Representa a propriedade format.fill.tintAndShade . |
|
CellPropertiesFont | bold | Representa a propriedade format.font.bold . |
color | Representa a propriedade format.font.color . |
|
italic | Representa a propriedade format.font.italic . |
|
name | Representa a propriedadeformat.font.name . |
|
size | Representa a propriedadeformat.font.size . |
|
strikethrough | Representa a propriedade format.font.strikethrough . |
|
subscript | Representa a propriedade format.font.subscript . |
|
superscript | Representa a propriedade format.font.superscript . |
|
tintAndShade | Representa a propriedade format.font.tintAndShade . |
|
underline | Representa a propriedade format.font.underline . |
|
CellPropertiesFormat | autoIndent | Representa a propriedade autoIndent . |
Borders | Representa a propriedade borders . |
|
fill | Representa a propriedade fill . |
|
font | Representa a propriedade font . |
|
horizontalAlignment | Representa a propriedade horizontalAlignment . |
|
indentLevel | Representa a propriedade indentLevel . |
|
protection | Representa a propriedade protection . |
|
readingOrder | Representa a propriedade readingOrder . |
|
shrinkToFit | Representa a propriedade shrinkToFit . |
|
textOrientation | Representa a propriedade textOrientation . |
|
useStandardHeight | Representa a propriedade useStandardHeight . |
|
useStandardWidth | Representa a propriedade useStandardWidth . |
|
verticalAlignment | Representa a propriedade verticalAlignment . |
|
wrapText | Representa a propriedade wrapText . |
|
CellPropertiesProtection | formulaHidden | Representa a propriedade format.protection.formulaHidden . |
bloqueado | Representa a propriedade format.protection.locked . |
|
ChangedEventDetail | valueAfter | Representa o valor após a alteração. |
valueBefore | Representa o valor antes da alteração. | |
valueTypeAfter | Representa o tipo de valor após a alteração. | |
valueTypeBefore | Representa o tipo de valor antes da alteração. | |
Chart | activate() | Ativa o gráfico na interface do usuário do Excel. |
pivotOptions | Encapsula as opções para um gráfico dinâmico. | |
ChartAreaFormat | colorScheme | Especifica o esquema de cores do gráfico. |
roundedCorners | Especifica se a área do gráfico tem cantos arredondados. | |
ChartAxis | linkNumberFormat | Especifica se o formato de número está ligado às células. |
ChartBinOptions | allowOverflow | Especifica se a capacidade excedida da classe está ativada num gráfico de histograma ou gráfico pareto. |
allowUnderflow | Especifica se o subfluxo de discretização está ativado num gráfico de histograma ou gráfico pareto. | |
Count | Especifica a contagem de discretizações de um gráfico de histograma ou gráfico pareto. | |
overflowValue | Especifica o valor de capacidade excedida do contentor de um gráfico de histograma ou gráfico pareto. | |
type | Especifica o tipo de classe para um gráfico de histograma ou pareto. | |
underflowValue | Especifica o valor de subfluxo de classe de um gráfico de histograma ou gráfico pareto. | |
width | Especifica o valor da largura da classe de um gráfico de histograma ou gráfico pareto. | |
ChartBoxwhiskerOptions | quartileCalculation | Especifica se o tipo de cálculo quartil de um gráfico de caixa e bigodes. |
showInnerPoints | Especifica se os pontos internos são apresentados num gráfico de caixa e bigode. | |
showMeanLine | Especifica se a linha média é apresentada num gráfico de caixa e bigode. | |
showMeanMarker | Especifica se o marcador médio é apresentado num gráfico de caixa e whisker. | |
showOutlierPoints | Especifica se os pontos atípicos são apresentados num gráfico de caixa e bigodes. | |
ChartDataLabel | linkNumberFormat | Especifica se o formato de número está ligado às células (para que o formato de número seja alterado nas etiquetas quando for alterado nas células). |
ChartDataLabels | linkNumberFormat | Especifica se o formato de número está ligado às células. |
ChartErrorBars | endStyleCap | Especifica se as barras de erro têm um limite de estilo final. |
format | Especifica o tipo de formatação das barras de erro. | |
include | Especifica quais partes das barras de erro devem ser incluídas. | |
tipo | O tipo de intervalo marcado pelas barras de erro. | |
visible | Especifica se as barras de erro são apresentadas. | |
ChartErrorBarsFormat | line | Representa a formatação de linha do gráfico. |
ChartMapOptions | labelStrategy | Especifica a estratégia de etiquetas de mapa de séries de um gráfico de mapa de região. |
level | Especifica o nível de mapeamento de séries de um gráfico de mapa de região. | |
projectionType | Especifica o tipo de projeção de série de um gráfico de mapa de região. | |
ChartPivotOptions | showAxisFieldButtons | Especifica se pretende apresentar os botões de campo do eixo num gráfico dinâmico. |
showLegendFieldButtons | Especifica se pretende apresentar os botões do campo de legenda num gráfico dinâmico. | |
showReportFilterFieldButtons | Especifica se pretende apresentar os botões do campo de filtro de relatório num gráfico dinâmico. | |
showValueFieldButtons | Especifica se pretende apresentar os botões de campo mostrar valor num gráfico dinâmico. | |
ChartSeries | binOptions | Encapsula as opções de bin para gráficos de histograma e gráficos de pareto. |
boxwhiskerOptions | Encapsula as opções para os gráficos de caixa estreita. | |
bubbleScale | Este pode ser um valor inteiro de 0 (zero) a 300, representando a porcentagem do tamanho padrão. | |
gradientMaximumColor | Especifica a cor para o valor máximo de uma série de gráficos de mapa de região. | |
gradientMaximumType | Especifica o tipo para o valor máximo de uma série de gráficos de mapa de região. | |
gradientMaximumValue | Especifica o valor máximo de uma série de gráficos de mapa de região. | |
gradientMidpointColor | Especifica a cor para o valor de ponto intermédio de uma série de gráficos de mapa de região. | |
gradientMidpointType | Especifica o tipo para o valor de ponto médio de uma série de gráficos de mapa de região. | |
gradientMidpointValue | Especifica o valor de ponto intermédio de uma série de gráficos de mapa de região. | |
gradientMinimumColor | Especifica a cor para o valor mínimo de uma série de gráficos de mapa de região. | |
gradientMinimumType | Especifica o tipo para o valor mínimo de uma série de gráficos de mapa de região. | |
gradientMinimumValue | Especifica o valor mínimo de uma série de gráficos de mapa de região. | |
gradientStyle | Especifica o estilo de gradação de série de um gráfico de mapa de região. | |
invertColor | Especifica a cor de preenchimento para pontos de dados negativos numa série. | |
mapOptions | Encapsula as opções para um gráfico de mapa de região. | |
parentLabelStrategy | Especifica a área de estratégia de etiqueta principal da série para um gráfico treemap. | |
showConnectorLines | Especifica se as linhas de conexão são apresentadas em gráficos de cascata. | |
showLeaderLines | Especifica se as linhas de preenchimento são apresentadas para cada etiqueta de dados na série. | |
splitValue | Especifica o valor de limiar que separa duas secções de um gráfico circular de circular ou de um gráfico de barras de circulares. | |
xErrorBars | Representa o objeto da barra de erros de uma série de gráficos. | |
yErrorBars | Representa o objeto da barra de erros de uma série de gráficos. | |
ChartTrendlineLabel | linkNumberFormat | Especifica se o formato de número está ligado às células (para que o formato de número seja alterado nas etiquetas quando for alterado nas células). |
ColumnProperties | address | Representa a propriedade address . |
addressLocal | Representa a propriedade addressLocal . |
|
columnIndex | Representa a propriedade columnIndex . |
|
ConditionalFormat | getRanges() | Devolve o RangeAreas , composto por um ou mais intervalos retangulares, aos quais o formato conditonal é aplicado. |
DataValidation | getInvalidCells() | Devolve um RangeAreas objeto, composto por um ou mais intervalos retangulares, com valores de célula inválidos. |
getInvalidCellsOrNullObject() | Devolve um RangeAreas objeto, composto por um ou mais intervalos retangulares, com valores de célula inválidos. |
|
FilterCriteria | subField | A propriedade utilizada pelo filtro para efetuar um filtro avançado em valores avançados. |
GeometricShape | id | Retorna o identificador de forma. |
shape | Devolve o Shape objeto da forma geométrica. |
|
GroupShapeCollection | getCount() | Retorna o número de formas no grupo de forma. |
getItem(key: string) | Obtém uma forma com o respetivo nome ou ID. | |
getItemAt(index: number) | Obtém uma forma com base em sua posição na coleção. | |
items | Obtém os itens filhos carregados nesta coleção. | |
HeaderFooter | centerFooter | O rodapé central da folha de cálculo. |
centerHeader | O cabeçalho central da folha de cálculo. | |
leftFooter | O rodapé esquerdo da folha de cálculo. | |
leftHeader | O cabeçalho esquerdo da folha de cálculo. | |
rightFooter | O rodapé direito da folha de cálculo. | |
rightHeader | O cabeçalho direito da folha de cálculo. | |
HeaderFooterGroup | defaultForAllPages | O cabeçalho/rodapé geral, usado em todas as páginas, a menos que seja especificada a página par/ímpar ou a primeira página. |
evenPages | O cabeçalho/rodapé a ser usado para páginas pares, o cabeçalho/rodapé ímpar deve ser especificado para páginas ímpares. | |
firstPage | O cabeçalho/rodapé da primeira página. Para todas as outras páginas, geral ou par/ímpar é usado. | |
oddPages | O cabeçalho/rodapé a ser usado para páginas ímpares, o cabeçalho/rodapé par deve ser especificado para páginas pares. | |
state | O estado pelo qual os cabeçalhos/rodapés estão definidos. | |
useSheetMargins | Obtém ou define um sinalizador indicando se os cabeçalhos/rodapés estão alinhados com as margens da página que foram definidas nas opções de layout de página da planilha. | |
useSheetScale | Obtém ou define um sinalizador que indica se os cabeçalhos/rodapés devem ser dimensionados pela escala de porcentagem da página definida nas opções de layout de página da planilha. | |
Image | format | Retorna o formato da imagem. |
id | Especifica o identificador da forma para o objeto de imagem. | |
shape | Devolve o Shape objeto associado à imagem. |
|
IterativeCalculation | enabled | True se o Excel usará a interação para resolver referências circulares. |
maxChange | Especifica a quantidade máxima de alterações entre cada iteração à medida que o Excel resolve as referências circulares. | |
maxIteration | Especifica o número máximo de iterações que o Excel pode utilizar para resolve uma referência circular. | |
Line | beginArrowheadLength | Representa o comprimento da ponta da seta no início da linha especificada. |
beginArrowheadStyle | Representa o estilo da ponta de seta no início da linha especificada. | |
BeginArrowheadWidth | Representa a largura da ponta da seta no início da linha especificada. | |
beginConnectedShape | Representa a forma na qual o início da linha especificada está conectado. | |
beginConnectedSite | Representa o site de conexão ao qual o início de um conector está conectado. | |
connectBeginShape (forma: Excel.Shape, connectionSite: número) | Conecta o início do conector especificado a uma forma específica. | |
connectEndShape (forma: Excel.Shape, connectionSite: número) | Anexa o final do conector especificado a uma forma específica. | |
connectorType | Representa o tipo de conector de linha. | |
disconnectBeginShape() | Desconecta o início do conector especificado de uma forma. | |
disconnectEndShape() | Desconecta o final do conector especificado de uma forma. | |
endArrowheadLength | Representa o comprimento da ponta de seta no final da linha especificada. | |
endArrowheadStyle | Representa o estilo da ponta de seta no final da linha especificada. | |
endArrowheadWidth | Representa a largura da ponta de seta no final da linha especificada. | |
endConnectedShape | Representa a forma na qual o final da linha especificada está conectado. | |
endConnectedSite | Representa o site de conexão ao qual o final de um conector está conectado. | |
id | Especifica o identificador da forma. | |
isBeginConnected | Especifica se o início da linha especificada está ligado a uma forma. | |
isEndConnected | Especifica se o fim da linha especificada está ligado a uma forma. | |
shape | Devolve o Shape objeto associado à linha. |
|
PageBreak | columnIndex | Especifica o índice de colunas para a quebra de página. |
delete() | Exclui um objeto de quebra de página. | |
getCellAfterBreak() | Obtém a primeira célula após a quebra de página. | |
rowIndex | Especifica o índice de linhas para a quebra de página. | |
PageBreakCollection | add(pageBreakRange: Intervalo | cadeia) | Adiciona uma quebra de página antes da célula superior esquerda do intervalo especificado. |
getCount() | Obtém o número de quebras de página na coleção. | |
getItem(index: number) | Obtém um objeto de quebra de página através do índice. | |
items | Obtém os itens filhos carregados nesta coleção. | |
removePageBreaks() | Redefine todas as quebras de página manuais na coleção. | |
PageLayout | blackAndWhite | A opção de impressão a preto e branco da folha de cálculo. |
bottomMargin | A margem inferior da página da folha de cálculo a utilizar para imprimir em pontos. | |
centerHorizontally | O sinalizador horizontal central da folha de cálculo. | |
centerVertically | O sinalizador central da folha de cálculo é sinalizador verticalmente. | |
draftMode | A opção modo de rascunho da folha de cálculo. | |
firstPageNumber | O número da primeira página da folha de cálculo a imprimir. | |
footerMargin | A margem de rodapé da folha de cálculo, em pontos, para utilização ao imprimir. | |
getPrintArea() | Obtém o RangeAreas objeto, composto por um ou mais intervalos retangulares, que representa a área de impressão da folha de cálculo. |
|
getPrintAreaOrNullObject() | Obtém o RangeAreas objeto, composto por um ou mais intervalos retangulares, que representa a área de impressão da folha de cálculo. |
|
getPrintTitleColumns() | Obtém o objeto range que representa as colunas de título. | |
getPrintTitleColumnsOrNullObject() | Obtém o objeto range que representa as colunas de título. | |
getPrintTitleRows() | Obtém o objeto range representando as linhas do título. | |
getPrintTitleRowsOrNullObject() | Obtém o objeto range representando as linhas do título. | |
headerMargin | A margem de cabeçalho da folha de cálculo, em pontos, para utilização ao imprimir. | |
headersFooters | Configuração de cabeçalho e rodapé da planilha. | |
leftMargin | A margem esquerda da folha de cálculo, em pontos, para utilização ao imprimir. | |
orientation | A orientação da folha de cálculo da página. | |
paperSize | O tamanho do papel da página da folha de cálculo. | |
printComments | Especifica se os comentários da folha de cálculo devem ser apresentados ao imprimir. | |
printErrors | A opção de erros de impressão da folha de cálculo. | |
printGridlines | Especifica se as linhas de grelha da folha de cálculo serão impressas. | |
printHeadings | Especifica se os cabeçalhos da folha de cálculo serão impressos. | |
printOrder | A opção de ordem de impressão da página da folha de cálculo. | |
rightMargin | A margem direita da folha de cálculo, em pontos, para utilização ao imprimir. | |
setPrintArea(printArea: Intervalo | RangeAreas | cadeia) | Define a área de impressão da planilha. | |
setPrintMargins(unit: Excel.PrintMarginUnit, marginOptions: Excel.PageLayoutMarginOptions) | Define as margens das páginas da planilha com unidades. | |
setPrintTitleColumns(printTitleColumns: Intervalo | cadeia) | Define as colunas que contêm as células que serão repetidas à esquerda de cada página da planilha para impressão. | |
setPrintTitleRows(printTitleRows: Intervalo | cadeia) | Define as linhas que contêm as células que serão repetidas na parte de cada página da planilha para impressão. | |
topMargin | A margem superior da folha de cálculo, em pontos, para utilização ao imprimir. | |
zoom | As opções de zoom de impressão da folha de cálculo. | |
PageLayoutMarginOptions | bottom | Especifica a margem inferior do esquema de página na unidade especificada para utilizar para impressão. |
footer | Especifica a margem do rodapé do esquema de página na unidade especificada para utilizar para impressão. | |
header | Especifica a margem do cabeçalho do esquema de página na unidade especificada para utilizar para impressão. | |
left | Especifica a margem esquerda do esquema de página na unidade especificada para impressão. | |
direita | Especifica a margem direita do esquema de página na unidade especificada para utilizar para impressão. | |
top | Especifica a margem superior do esquema de página na unidade especificada para utilizar para impressão. | |
PageLayoutZoomOptions | horizontalFitToPages | Número de páginas a ser horizontalmente ajustado. |
scale | O valor do dimensionamento da página de impressão pode estar entre 10 e 400. | |
verticalFitToPages | Número de páginas a ser verticalmente ajustado. | |
PivotField | sortByValues(sortBy: Excel.SortBy, valuesHierarchy: Excel.DataPivotHierarchy, pivotItemScope?: Array<PivotItem | string>) | Classifica o Campo dinâmico por valores especificados em um determinado escopo. |
PivotLayout | autoFormat | Especifica se a formatação será formatada automaticamente quando é atualizada ou quando os campos são movidos. |
getDataHierarchy(célula: Intervalo | cadeia) | Obtém o DataHierarchy que é usado para calcular o valor em um intervalo especificado dentro da Tabela dinâmica. | |
getPivotItems(eixo: Excel.PivotAxis, célula: Intervalo | cadeia) | Obtém os Itens dinâmicos de um eixo que compõem o valor em um intervalo especificado dentro da Tabela dinâmica. | |
preserveFormatting | Especifica se a formatação é preservada quando o relatório é atualizado ou recalculado por operações como dinamização, ordenação ou alteração de itens de campo de página. | |
setAutoSortOnCell(célula: Intervalo | cadeia, ordenarPor: Excel.SortBy) | Define a Tabela Dinâmica para classificar automaticamente usando a célula especificada para selecionar automaticamente todos os critérios e contextos necessários. | |
PivotTable | enableDataValueEditing | Especifica se a Tabela Dinâmica permite que os valores no corpo dos dados sejam editados pelo utilizador. |
useCustomSortLists | Especifica se a Tabela Dinâmica utiliza listas personalizadas ao ordenar. | |
Range | Preenchimento Automático(destinationRange?: Intervalo | cadeia, Preenchimento AutomáticoType?: Excel.AutoFillType) | Preenche um intervalo entre o intervalo atual e o intervalo de destino com a lógica de Preenchimento Automático especificada. |
convertDataTypeToText() | Converte as células de intervalo com tipos de dados em texto. | |
convertToLinkedDataType(serviceID: number, languageCulture: string) | Converte as células de intervalo em tipos de dados ligados na folha de cálculo. | |
copyFrom(sourceRange: Intervalo | RangeAreas | string, copyType?: Excel.RangeCopyType, skipBlanks?: booleano, transpor?: booleano) | Copia dados de células ou formatação do intervalo de origem ou RangeAreas para o intervalo atual. |
|
find(text: string, criteria: Excel.SearchCriteria) | Localiza certa cadeia de caracteres com base em critérios especificados. | |
findOrNullObject(text: string, criteria: Excel.SearchCriteria) | Localiza certa cadeia de caracteres com base em critérios especificados. | |
flashFill() | Efetua uma Pré-visualização da Conclusão Automática para o intervalo atual. | |
getCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions) | Retorna uma matriz 2D encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada célula. | |
getColumnProperties(columnPropertiesLoadOptions: ColumnPropertiesLoadOptions) | Retorna uma única matriz dimensional encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada coluna. | |
getRowProperties(rowPropertiesLoadOptions: RowPropertiesLoadOptions) | Retorna uma única matriz dimensional encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada célula. | |
getSpecialCells(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType) | Obtém o RangeAreas objeto, composto por um ou mais intervalos retangulares, que representa todas as células que correspondem ao tipo e valor especificados. |
|
getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType) | Obtém o RangeAreas objeto, composto por um ou mais intervalos, que representa todas as células que correspondem ao tipo e valor especificados. |
|
getTables(fullyContained?: boolean) | Obtém uma coleção de tabelas com escopo que se sobrepõe ao intervalo. | |
linkedDataTypeState | Representa o estado do tipo de dados de cada célula. | |
removeDuplicates(columns: number[], includesHeader: boolean) | Remove valores duplicados do intervalo especificado pelas colunas. | |
replaceAll(text: string, replacement: string, criteria: Excel.ReplaceCriteria) | Localiza e substitui a cadeia de caracteres fornecida com base nos critérios especificados no intervalo atual. | |
setCellProperties(cellPropertiesData: SettableCellProperties[][]) | Atualizações o intervalo com base numa matriz 2D de propriedades de células, encapsulando elementos como tipo de letra, preenchimento, limites e alinhamento. | |
setColumnProperties(columnPropertiesData: SettableColumnProperties[]) | Atualizações o intervalo com base numa matriz unidimensional de propriedades de coluna, encapsulando elementos como tipo de letra, preenchimento, limites e alinhamento. | |
setDirty() | Define um intervalo a ser recalculado quando o próximo recálculo ocorrer. | |
setRowProperties(rowPropertiesData: SettableRowProperties[]) | Atualizações o intervalo com base numa matriz unidimensional de propriedades de linha, encapsulando elementos como tipo de letra, preenchimento, limites e alinhamento. | |
RangeAreas | address | Devolve a RangeAreas referência no estilo A1. |
addressLocal | Devolve a RangeAreas referência na região do utilizador. |
|
areaCount | Devolve o número de intervalos retangulares que compõem este RangeAreas objeto. |
|
areas | Devolve uma coleção de intervalos retangulares que compõem este RangeAreas objeto. |
|
calculate() | Calcula todas as células no RangeAreas . |
|
cellCount | Devolve o número de células no RangeAreas objeto, somando as contagens de células de todos os intervalos retangulares individuais. |
|
clear(applyTo?: Excel.ClearApplyTo) | Limpa valores, formato, preenchimento, limite e outras propriedades em cada uma das áreas que compõem este RangeAreas objeto. |
|
conditionalFormats | Devolve uma coleção de formatos condicionais que se cruzam com quaisquer células neste RangeAreas objeto. |
|
convertDataTypeToText() | Converte todas as células em RangeAreas com tipos de dados em texto. |
|
convertToLinkedDataType(serviceID: number, languageCulture: string) | Converte todas as células nos RangeAreas tipos de dados ligados. |
|
copyFrom(sourceRange: Intervalo | RangeAreas | string, copyType?: Excel.RangeCopyType, skipBlanks?: booleano, transpor?: booleano) | Copia dados de células ou formatação do intervalo de origem ou RangeAreas para o atual RangeAreas . |
|
dataValidation | Devolve um objeto de validação de dados para todos os intervalos no RangeAreas . |
|
format | Devolve um RangeFormat objeto, encapsulando o tipo de letra, o preenchimento, os limites, o alinhamento e outras propriedades para todos os intervalos no RangeAreas objeto. |
|
getEntireColumn() | Devolve um RangeAreas objeto que representa todas as colunas do RangeAreas (por exemplo, se a corrente RangeAreas representar as células "B4:E11, H2", devolve uma RangeAreas que representa as colunas "B:E, H:H"). |
|
getEntireRow() | Devolve um RangeAreas objeto que representa todas as linhas do RangeAreas (por exemplo, se a corrente RangeAreas representar as células "B4:E11", devolve uma RangeAreas que representa as linhas "4:11"). |
|
getIntersection(anotherRange: Intervalo | RangeAreas | cadeia) | Devolve o RangeAreas objeto que representa a interseção dos intervalos especificados ou RangeAreas . |
|
getIntersectionOrNullObject(anotherRange: Range | RangeAreas | cadeia) | Devolve o RangeAreas objeto que representa a interseção dos intervalos especificados ou RangeAreas . |
|
getOffsetRangeAreas(rowOffset: number, columnOffset: number) | Devolve um RangeAreas objeto que é movido pelo desvio de linhas e colunas específico. |
|
getSpecialCells(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType) | Devolve um RangeAreas objeto que representa todas as células que correspondem ao tipo e valor especificados. |
|
getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType) | Devolve um RangeAreas objeto que representa todas as células que correspondem ao tipo e valor especificados. |
|
getTables(fullyContained?: boolean) | Devolve uma coleção de tabelas no âmbito que se sobrepõem a qualquer intervalo neste RangeAreas objeto. |
|
getUsedRangeAreas(valuesOnly?: boolean) | Devolve o utilizado RangeAreas que compreende todas as áreas utilizadas de intervalos retangulares individuais no RangeAreas objeto. |
|
getUsedRangeAreasOrNullObject(valuesOnly?: boolean) | Devolve o utilizado RangeAreas que compreende todas as áreas utilizadas de intervalos retangulares individuais no RangeAreas objeto. |
|
isEntireColumn | Especifica se todos os intervalos neste RangeAreas objeto representam colunas inteiras (por exemplo, "A:C, Q:Z"). |
|
isEntireRow | Especifica se todos os intervalos neste RangeAreas objeto representam linhas inteiras (por exemplo, "1:3, 5:7"). |
|
setDirty() | Define o RangeAreas para ser recalculado quando ocorrer o próximo recálculo. |
|
style | Representa o estilo de todos os intervalos neste RangeAreas objeto. |
|
worksheet | Devolve a folha de cálculo do atual RangeAreas . |
|
RangeBorder | tintAndShade | Especifica um duplo que ilumina ou escurece uma cor para o limite do intervalo, o valor é entre -1 (mais escuro) e 1 (mais brilhante), com 0 para a cor original. |
RangeBorderCollection | tintAndShade | Especifica um duplo que ilumina ou escurece uma cor para limites de intervalo. |
RangeCollection | getCount() | Devolve o número de intervalos em RangeCollection . |
getItemAt(index: number) | Devolve o objeto de intervalo com base na respetiva posição no RangeCollection . |
|
items | Obtém os itens filhos carregados nesta coleção. | |
RangeFill | padrão | O padrão de um intervalo. |
patternColor | O código de cores HTML que representa a cor do padrão de intervalo, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). | |
patternTintAndShade | Especifica um duplo que ilumina ou escurece uma cor de padrão para o preenchimento do intervalo. | |
tintAndShade | Especifica um duplo que ilumina ou escurece uma cor para o preenchimento do intervalo. | |
RangeFont | strikethrough | Especifica a status rasurado do tipo de letra. |
subscript | Especifica a status inferior à linha do tipo de letra. | |
superscript | Especifica a status superior à linha do tipo de letra. | |
tintAndShade | Especifica um duplo que ilumina ou escurece uma cor para o tipo de letra do intervalo. | |
RangeFormat | autoIndent | Especifica se o texto é automaticamente avanço quando o alinhamento do texto é definido como distribuição igual. |
indentLevel | Um número inteiro entre 0 e 250 que indica o nível de recuo. | |
readingOrder | A ordem de leitura para o intervalo. | |
shrinkToFit | Especifica se o texto diminui automaticamente para caber na largura da coluna disponível. | |
RemoveDuplicatesResult | removed | Número de linhas duplicadas removidas pela operação. |
uniqueRemaining | Número de linhas restantes exclusivas presentes no intervalo resultante. | |
ReplaceCriteria | completeMatch | Especifica se a correspondência tem de ser completa ou parcial. |
matchCase | Especifica se a correspondência é sensível a maiúsculas e minúsculas. | |
RowProperties | address | Representa a propriedade address . |
addressLocal | Representa a propriedade addressLocal . |
|
rowIndex | Representa a propriedade rowIndex . |
|
SearchCriteria | completeMatch | Especifica se a correspondência tem de ser completa ou parcial. |
matchCase | Especifica se a correspondência é sensível a maiúsculas e minúsculas. | |
searchDirection | Especifica a direção da pesquisa. | |
SettableCellProperties | format | Representa a propriedade format . |
hiperlink | Representa a propriedade hyperlink . |
|
style | Representa a propriedade style . |
|
SettableColumnProperties | columnHidden | Representa a propriedade columnHidden . |
format | Representa a propriedade format . |
|
SettableRowProperties | format | Representa a propriedade format . |
rowHidden | Representa a propriedade rowHidden . |
|
Shape | altTextDescription | Especifica o texto de descrição alternativo de um Shape objeto. |
altTextTitle | Especifica o texto de título alternativo para um Shape objeto. |
|
connectionSiteCount | Retorna o número de locais de conexão nessa forma. | |
delete() | Remove a forma da planilha. | |
fill | Retorna a formatação de preenchimento dessa forma. | |
geometricShape | Retorna a forma geométrica associada à forma. | |
geometricShapeType | Especifica o tipo de forma geométrica desta forma geométrica. | |
getAsImage(format: Excel.PictureFormat) | Converte a forma numa imagem e devolve a imagem como uma cadeia codificada em Base64. | |
group | Retorna o grupo de forma associado à forma. | |
height | Especifica a altura, em pontos, da forma. | |
id | Especifica o identificador da forma. | |
image | Retorna a imagem associada à forma. | |
incrementLeft(increment: number) | Move a forma horizontalmente pelo número especificado de pontos. | |
incrementRotation(increment: number) | O formato é girado em sentido horário ao redor do eixo z pelo número especificado de graus. | |
incrementTop(increment: number) | Move a forma verticalmente pelo número especificado de pontos. | |
left | A distância, em pontos, da lateral esquerda da forma do lado esquerdo da planilha. | |
level | Especifica o nível da forma especificada. | |
line | Retorna a linha associada à forma. | |
lineFormat | Retorna a formatação de linha do objeto de forma. | |
lockAspectRatio | Especifica se a proporção desta forma está bloqueada. | |
name | Especifica o nome da forma. | |
onActivated | Ocorre quando a forma é ativada. | |
onDeactivated | Ocorre quando a forma é desativada. | |
parentGroup | Especifica o grupo principal desta forma. | |
rotation | Especifica a rotação, em graus, da forma. | |
scaleHeight(scaleFactor: number, scaleType: Excel.ShapeScaleType, scaleFrom?: Excel.ShapeScaleFrom) | Dimensiona a altura da forma por um fator especificado. | |
scaleWidth(scaleFactor: number, scaleType: Excel.ShapeScaleType, scaleFrom?: Excel.ShapeScaleFrom) | Dimensiona a largura da forma por um fator especificado. | |
setZOrder(position: Excel.ShapeZOrder) | Move a forma especificada para cima ou para baixo na ordem z da coleção, que a desloca para frente ou para trás de outras formas. | |
textFrame | Retorna o objeto text frame de uma forma. | |
top | A distância, em pontos, da borda superior da forma até a borda superior da planilha. | |
tipo | Retorna o tipo dessa forma. | |
visible | Especifica se a forma está visível. | |
width | Especifica a largura, em pontos, da forma. | |
zOrderPosition | Retorna a posição da forma especificada na ordem z, com 0 representando a parte inferior da pilha do pedido. | |
ShapeActivatedEventArgs | shapeId | Obtém o ID da forma ativada. |
tipo | Obtém o tipo do evento. | |
worksheetId | Obtém o ID da folha de cálculo na qual a forma está ativada. | |
ShapeCollection | addGeometricShape(geometricShapeType: Excel.GeometricShapeType) | Adiciona uma forma geométrica à planilha. |
addGroup(valores: Cadeia<de matriz | Forma>) | Um subconjunto de formas na planilha do conjunto de grupos. | |
addImage(base64ImageString: string) | Cria uma imagem a partir de uma cadeia codificada em Base64 e adiciona-a à folha de cálculo. | |
addLine(startLeft: number, startTop: number, endLeft: number, endTop: number, connectorType?: Excel.ConnectorType) | Adiciona uma linha à planilha. | |
addTextBox(text?: string) | Adiciona uma caixa de texto na planilha com o texto fornecido como conteúdo. | |
getCount() | Retorna o número de formas da planilha. | |
getItem(key: string) | Obtém uma forma com o respetivo nome ou ID. | |
getItemAt(index: number) | Obtém uma forma usando sua posição na coleção. | |
items | Obtém os itens filhos carregados nesta coleção. | |
ShapeDeactivatedEventArgs | shapeId | Obtém o ID da forma desativada. |
tipo | Obtém o tipo do evento. | |
worksheetId | Obtém o ID da folha de cálculo na qual a forma é desativada. | |
ShapeFill | clear() | Limpa a formatação do preenchimento de um objeto de forma. |
foregroundColor | Representa a cor de primeiro plano do preenchimento da forma no formato de cor HTML, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja") | |
setSolidColor(color: string) | Define a formatação de preenchimento de um formato com uma cor uniforme. | |
transparency | Especifica a percentagem de transparência do preenchimento como um valor de 0,0 (opaco) a 1,0 (claro). | |
tipo | Retorna o tipo de preenchimento da forma. | |
ShapeFont | bold | Representa o status da fonte em negrito. |
color | Representação do código de cores HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). | |
italic | Representa o status da fonte em itálico. | |
name | Representa o nome do tipo de letra (por exemplo, "Calibri"). | |
size | Representa o tamanho do tipo de letra em pontos (por exemplo, 11). | |
underline | Tipo de sublinhado aplicado à fonte. | |
ShapeGroup | id | Especifica o identificador da forma. |
shape | Devolve o Shape objeto associado ao grupo. |
|
shapes | Devolve a coleção de Shape objetos. |
|
ungroup() | Desagrupa todas as formas agrupadas no grupo de forma especificado. | |
ShapeLineFormat | color | Representa a cor da linha no formato de cor HTML, no formato #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). |
dashStyle | Representa o estilo de linha da forma. | |
style | Representa o estilo de linha da forma. | |
transparency | Representa o grau de transparência da linha especificada como um valor de 0,0 (opaco) a 1,0 (claro). | |
visible | Especifica se a formatação de linha de um elemento de forma é visível. | |
weight | Representa a espessura da linha, em pontos. | |
SortField | subField | Especifica o subcampo que é o nome da propriedade de destino de um valor avançado para ordenar. |
StyleCollection | getCount() | Obtém o número de estilos na coleção. |
getItemAt(index: number) | Obtém um estilo com base em sua posição na coleção. | |
Table | autoFilter | Representa o AutoFilter objeto da tabela. |
TableAddedEventArgs | source | Obtém a origem do evento. |
tableId | Obtém o ID da tabela que é adicionada. | |
tipo | Obtém o tipo do evento. | |
worksheetId | Obtém o ID da folha de cálculo na qual a tabela é adicionada. | |
TableChangedEventArgs | detalhes | Obtém as informações sobre os detalhes da alteração. |
TableCollection | onAdded | Ocorre quando uma nova tabela é adicionada a um livro. |
onDeleted | Ocorre quando a tabela especificada é excluída em uma pasta de trabalho. | |
TableDeletedEventArgs | source | Obtém a origem do evento. |
tableId | Obtém o ID da tabela que é eliminada. | |
tableName | Obtém o nome da tabela que é eliminada. | |
tipo | Obtém o tipo do evento. | |
worksheetId | Obtém o ID da folha de cálculo na qual a tabela é eliminada. | |
TableScopedCollection | getCount() | Obtém o número de tabelas na coleção. |
getFirst() | Obtém a primeira tabela na coleção. | |
getItem(key: string) | Obtém uma tabela pelo nome ou ID. | |
items | Obtém os itens filhos carregados nesta coleção. | |
TextFrame | autoSizeSetting | As definições de dimensionamento automático para a moldura de texto. |
bottomMargin | Representa margem inferior, em pontos, do quadro de texto. | |
deleteText() | Exclui todo o texto no quadro de texto. | |
hasText | Especifica se a moldura de texto contém texto. | |
horizontalAlignment | Representa o alinhamento horizontal do quadro de texto. | |
horizontalOverflow | Representa o comportamento de excedente horizontal do quadro de texto. | |
leftMargin | Representa margem esquerda, em pontos, do quadro de texto. | |
orientation | Representa o ângulo para o qual o texto é orientado para a moldura de texto. | |
readingOrder | Representa a ordem de leitura do quadro de texto, da direita para a esquerda ou da direita para a esquerda. | |
rightMargin | Representa margem direita, em pontos, do quadro de texto. | |
textRange | Representa o texto que está anexado a uma forma, bem como propriedades e métodos para manipular o texto. | |
topMargin | Representa margem superior, em pontos, do quadro de texto. | |
verticalAlignment | Representa o alinhamento vertical do quadro de texto. | |
verticalOverflow | Representa o comportamento de excedente vertical do quadro de texto. | |
TextRange | font | Devolve um ShapeFont objeto que representa os atributos do tipo de letra para o intervalo de texto. |
getSubstring(start: number, length?: number) | Retorna um objeto TextRange para a subcadeia de caracteres no intervalo especificado. | |
text | Representa o conteúdo de texto sem formatação do intervalo de texto. | |
Workbook | autoSave | Especifica se o livro está no modo guardar automaticamente. |
calculationEngineVersion | Retorna um número sobre a versão do Mecanismo de Cálculo do Excel. | |
chartDataPointTrack | True se todos os gráficos na pasta de trabalho estiverem rastreando os pontos de dados reais aos quais eles estão anexados. | |
getActiveChart() | Obtém o gráfico ativo no momento na pasta de trabalho. | |
getActiveChartOrNullObject() | Obtém o gráfico ativo no momento na pasta de trabalho. | |
getIsActiveCollabSession() | Devolve true se o livro estiver a ser editado por vários utilizadores (através da cocriação). |
|
getSelectedRanges() | Obtém um ou mais intervalos atualmente selecionados da pasta de trabalho. | |
isDirty | Especifica se foram feitas alterações desde a última vez que o livro foi guardado. | |
onAutoSaveSettingChanged | Ocorre quando a definição Guardar Automaticamente é alterada no livro. | |
previouslySaved | Especifica se o livro já foi guardado localmente ou online. | |
usePrecisionAsDisplayed | True se os cálculos dessa pasta de trabalho forem efetuados usando apenas a precisão dos números conforme forem exibidos. | |
WorkbookAutoSaveSettingChangedEventArgs | tipo | Obtém o tipo do evento. |
Planilha | autoFilter | Representa o AutoFilter objeto da folha de cálculo. |
enableCalculation | Determina se o Excel deve recalcular a folha de cálculo quando necessário. | |
findAll(text: string, criteria: Excel.WorksheetSearchCriteria) | Localiza todas as ocorrências da cadeia especificada com base nos critérios especificados e devolve-as como um RangeAreas objeto, composto por um ou mais intervalos retangulares. |
|
findAllOrNullObject(text: string, criteria: Excel.WorksheetSearchCriteria) | Localiza todas as ocorrências da cadeia especificada com base nos critérios especificados e devolve-as como um RangeAreas objeto, composto por um ou mais intervalos retangulares. |
|
getRanges(address?: string) | Obtém o RangeAreas objeto, representando um ou mais blocos de intervalos retangulares, especificados pelo endereço ou nome. |
|
horizontalPageBreaks | Obtém a coleção de quebra de página horizontal da planilha. | |
onFormatChanged | Ocorre quando o formato é alterado em uma planilha específica. | |
pageLayout | Obtém o PageLayout objeto da folha de cálculo. |
|
replaceAll(text: string, replacement: string, criteria: Excel.ReplaceCriteria) | Localiza e substitui a cadeia de caracteres fornecida com base nos critérios especificados na planilha atual. | |
shapes | Retorna a coleção de todos os objetos Shape na planilha. | |
verticalPageBreaks | Obtém a coleção de quebra de página vertical da planilha. | |
WorksheetChangedEventArgs | detalhes | Representa as informações sobre o detalhe da alteração. |
WorksheetCollection | onChanged | Ocorre quando uma planilha da pasta de trabalho é alterada. |
onFormatChanged | Ocorre quando uma folha de cálculo no livro tem um formato alterado. | |
onSelectionChanged | Ocorre quando a seleção é alterada em uma planilha. | |
WorksheetFormatChangedEventArgs | address | Obtém o endereço do intervalo que representa a área alterada de uma planilha específica. |
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. | |
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 os dados foram alterados. | |
WorksheetSearchCriteria | completeMatch | Especifica se a correspondência tem de ser completa ou parcial. |
matchCase | Especifica se a correspondência é sensível a maiúsculas e minúsculas. |
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.