Compartir a través de

Novedades de la API de JavaScript de Excel 1.12

  • Artículo

ExcelApi 1.12 aumentó la compatibilidad con fórmulas en intervalos mediante la adición de API para realizar un seguimiento de matrices dinámicas y buscar los precedentes directos de una fórmula. También agregó el control de API de los filtros de tabla dinámica. También se realizaron mejoras en las áreas de características de comentario, configuración de referencia cultural y propiedades personalizadas.

Área de característica Descripción Objetos relevantes
Eventos de comentario Agrega eventos para agregar, cambiar y eliminar a la colección de comentarios. CommentCollection
Configuración de la referencia cultural de fecha y hora Proporciona acceso a configuraciones culturales adicionales en torno al formato de fecha y hora. CultureInfo, NumberFormatInfoApplication
Precedentes directos Devuelve rangos que se usan para evaluar la fórmula de una celda. Rango
Filtros dinámicos Aplica filtros controlados por valores a los campos de una tabla dinámica. PivotField, PivotFilters
Desbordamiento de intervalos Permite a los complementos buscar rangos asociados a los resultados de la matriz dinámica . Rango
Propiedades personalizadas de nivel de hoja de cálculo Permite que las propiedades personalizadas se establezcan en el ámbito de la hoja de cálculo, además de limitarse al nivel de libro. WorksheetCustomProperty, WorksheetCustomPropertyCollection

Lista de API

En la tabla siguiente se enumeran las API del conjunto de requisitos de la API de JavaScript de Excel 1.12. Para ver la documentación de referencia de API para todas las API admitidas por el conjunto de requisitos de la API de JavaScript de Excel 1.12 o anterior, consulte Api de Excel en el conjunto de requisitos 1.12 o anterior.

Clase Campos Descripción
ChartAxisTitle textOrientation Especifica el ángulo al que está orientado el texto para el título del eje del gráfico.
ChartSeries getDimensionValues(dimension: Excel.ChartSeriesDimension) Obtiene los valores de una sola dimensión de la serie de gráficos.
Comment contentType Obtiene el tipo de contenido del comentario.
CommentAddedEventArgs commentDetails Obtiene la CommentDetail matriz que contiene el identificador de comentario y los identificadores de sus respuestas relacionadas.
source Especifica el origen del evento.
type Obtiene el tipo del evento.
worksheetId Obtiene el identificador de la hoja de cálculo en la que se produjo el evento.
CommentChangedEventArgs changeType Obtiene el tipo de cambio que representa cómo se desencadena el evento modificado.
commentDetails Obtenga la CommentDetail matriz que contiene el identificador de comentario y los identificadores de sus respuestas relacionadas.
source Especifica el origen del evento.
type Obtiene el tipo del evento.
worksheetId Obtiene el identificador de la hoja de cálculo en la que se produjo el evento.
CommentCollection onAdded Se produce cuando se agregan los comentarios.
onChanged Se produce cuando se cambian los comentarios o las respuestas de una colección de comentarios, incluso cuando se eliminan las respuestas.
onDeleted Se produce cuando los comentarios se eliminan en la colección de comentarios.
CommentDeletedEventArgs commentDetails Obtiene la CommentDetail matriz que contiene el identificador de comentario y los identificadores de sus respuestas relacionadas.
source Especifica el origen del evento.
type Obtiene el tipo del evento.
worksheetId Obtiene el identificador de la hoja de cálculo en la que se produjo el evento.
CommentDetail commentId Representa el identificador del comentario.
replyIds Representa los identificadores de las respuestas relacionadas que pertenecen al comentario.
CommentReply contentType Tipo de contenido de la respuesta.
CultureInfo datetimeFormat Define el formato culturalmente adecuado para mostrar la fecha y la hora.
DatetimeFormatInfo dateSeparator Obtiene la cadena usada como separador de fecha.
longDatePattern Obtiene la cadena de formato para un valor de fecha larga.
longTimePattern Obtiene la cadena de formato para un valor de largo tiempo.
shortDatePattern Obtiene la cadena de formato para un valor de fecha corto.
timeSeparator Obtiene la cadena usada como separador de tiempo.
PivotDateFilter comparador El comparador es el valor estático con el que se comparan otros valores.
condition Especifica la condición del filtro, que define los criterios de filtrado necesarios.
exclusivo Si truees , filter excluye los elementos que cumplen los criterios.
lowerBound Límite inferior del intervalo para la condición de between filtro.
upperBound Límite superior del intervalo para la condición de between filtro.
wholeDays Para equalslas condiciones de filtro , before, aftery between , indica si las comparaciones deben realizarse como días enteros.
PivotField applyFilter(filter: Excel.PivotFilters) Establece uno o varios de los pivotfilters actuales del campo y los aplica al campo.
clearAllFilters() Borra todos los criterios de todos los filtros del campo.
clearFilter(filterType: Excel.PivotFilterType) Borra todos los criterios existentes del filtro del campo del tipo especificado (si se aplica uno actualmente).
getFilters() Obtiene todos los filtros aplicados actualmente en el campo.
isFiltered(filterType?: Excel.PivotFilterType) Comprueba si hay filtros aplicados en el campo.
PivotFilters dateFilter Filtro de fecha aplicado actualmente al campo dinámico.
labelFilter Filtro de etiqueta aplicado actualmente al campo dinámico.
manualFilter Filtro manual aplicado actualmente al campo dinámico.
valueFilter Filtro de valor aplicado actualmente al campo dinámico.
PivotLabelFilter comparador El comparador es el valor estático con el que se comparan otros valores.
condition Especifica la condición del filtro, que define los criterios de filtrado necesarios.
exclusivo Si truees , filter excluye los elementos que cumplen los criterios.
lowerBound Límite inferior del intervalo para la condición de between filtro.
substring Subcadena usada para las condiciones de beginsWithfiltro , endsWithy contains .
upperBound Límite superior del intervalo para la condición de between filtro.
PivotManualFilter selectedItems Lista de elementos seleccionados que se van a filtrar manualmente.
PivotTable allowMultipleFiltersPerField Especifica si la tabla dinámica permite la aplicación de varios pivotfilters en un campo dinámico determinado de la tabla.
PivotTableScopedCollection getCount() Obtiene el número de tablas dinámicas de la colección.
getFirst() Obtiene la primera tabla dinámica de la colección.
getItem(key: string) Obtiene una tabla dinámica por nombre.
getItemOrNullObject(name: string) Obtiene una tabla dinámica por nombre.
items Obtiene los elementos secundarios cargados en esta colección.
PivotValueFilter comparador El comparador es el valor estático con el que se comparan otros valores.
condition Especifica la condición del filtro, que define los criterios de filtrado necesarios.
exclusivo Si truees , filter excluye los elementos que cumplen los criterios.
lowerBound Límite inferior del intervalo para la condición de between filtro.
selectionType Especifica si el filtro es para los N elementos superiores o inferiores, el N por ciento superior/inferior o la suma N superior/inferior.
umbral Número de umbral "N" de elementos, porcentaje o suma que se va a filtrar para una condición de filtro superior o inferior.
upperBound Límite superior del intervalo para la condición de between filtro.
value Nombre del "valor" elegido en el campo por el que se va a filtrar.
Rango getDirectPrecedents() Devuelve un WorkbookRangeAreas objeto que representa el rango que contiene todas las celdas precedentes directas de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo.
getPivotTables(fullyContained?: boolean) Obtiene una colección con ámbito de tablas dinámicas que se superponen con el intervalo.
getSpillParent() Obtiene el intervalo que contiene la celda de delimitador de una celda en la que se derrama.
getSpillParentOrNullObject() Obtiene el objeto de rango que contiene la celda delimitadora en la que se derrama la celda.
getSpillingToRange() Obtiene el objeto de intervalo que contiene el intervalo de desbordamiento al llamar en una celda de delimitador.
getSpillingToRangeOrNullObject() Obtiene el objeto de intervalo que contiene el intervalo de desbordamiento al llamar en una celda de delimitador.
hasSpill Indica si todas las celdas tienen un borde de desbordamiento.
numberFormatCategories Representa la categoría de formato numérico de cada celda.
savedAsArray Representa si todas las celdas se guardarían como una fórmula de matriz.
RangeAreasCollection getCount() Obtiene el número de objetos de RangeAreas esta colección.
getItemAt(index: number) Devuelve el RangeAreas objeto en función de la posición de la colección.
items Obtiene los elementos secundarios cargados en esta colección.
WorkbookRangeAreas direcciones Devuelve una matriz de direcciones en estilo A1.
areas Devuelve el RangeAreasCollection objeto .
getRangeAreasBySheet(key: string) Devuelve el objeto según el RangeAreas identificador o el nombre de la hoja de cálculo de la colección.
getRangeAreasOrNullObjectBySheet(key: string) Devuelve el objeto según el RangeAreas nombre o el identificador de la hoja de cálculo de la colección.
Gamas Devuelve intervalos que componen este objeto en un RangeCollection objeto .
Worksheet customProperties Obtiene una colección de propiedades personalizadas de nivel de hoja de cálculo.
WorksheetCustomProperty delete() Elimina la propiedad personalizada.
key Obtiene la clave de la propiedad personalizada.
value Obtiene o establece el valor de la propiedad personalizada.
WorksheetCustomPropertyCollection add(key: string, value: string) Agrega una nueva propiedad personalizada que se asigna a la clave proporcionada.
getCount() Obtiene el número de propiedades personalizadas de esta hoja de cálculo.
getItem(key: string) Obtiene un objeto de propiedad personalizada mediante su clave, que no distingue mayúsculas de minúsculas.
getItemOrNullObject(key: string) Obtiene un objeto de propiedad personalizada mediante su clave, que no distingue mayúsculas de minúsculas.
items Obtiene los elementos secundarios cargados en esta colección.

Vea también