Novedades de la API de JavaScript de Excel 1.4

  • Artículo

Las siguientes son las nuevas incorporaciones a las API de JavaScript de Excel en el conjunto de requisitos 1.4.

Agregar elementos con nombre y nuevas propiedades

Nuevas propiedades:

  • comment
  • scope - Elementos con ámbito de hoja de cálculo o libro.
  • worksheet : devuelve la hoja de cálculo a la que se limita el elemento con nombre.

Nuevos métodos:

  • add(name: string, reference: Range or string, comment: string) : agrega un nuevo nombre a la colección del ámbito especificado.
  • addFormulaLocal(name: string, formula: string, comment: string) : agrega un nuevo nombre a la colección del ámbito especificado mediante la configuración regional del usuario para la fórmula.

API de configuración en el espacio de nombres de Excel

El objeto Setting representa un par clave-valor de una configuración que se conserva en el documento. La funcionalidad de Excel.Setting equivale a Office.Settings, pero usa la sintaxis de la API por lotes, en lugar del modelo de devolución de llamada de la API común.

Las API incluyen getItem() para obtener la entrada de configuración a través de la clave y add() para agregar el par de configuración key:value especificado al libro.

Otros

  • Establezca el nombre de la columna de tabla.
  • Agregue una columna de tabla al final de la tabla.
  • Agregue varias filas a una tabla a la vez.
  • range.getColumnsAfter(count: number) y range.getColumnsBefore(count: number) para obtener un número determinado de columnas a la derecha o izquierda del objeto Range actual.
  • Métodos y propiedades *OrNullObject: esta funcionalidad permite obtener un objeto mediante una clave. Si el objeto no existe, la propiedad del isNullObject objeto devuelto será true. Esto permite a los desarrolladores comprobar si existe un objeto sin tener que controlarlo mediante el control de excepciones. Un *OrNullObject método está disponible en la mayoría de los objetos de colección.
worksheet.getItemOrNullObject("itemName")

Lista de API

En la tabla siguiente se enumeran las API del conjunto de requisitos de la API de JavaScript de Excel 1.4. 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.4 o anterior, consulte Api de Excel en el conjunto de requisitos 1.4 o anterior.

Clase Campos Descripción
BindingCollection getCount() Obtiene el número de enlaces de la colección.
getItemOrNullObject(id: string) Obtiene un objeto de enlace por identificador.
ChartCollection getCount() Devuelve el número de gráficos de la hoja de cálculo.
getItemOrNullObject(name: string) Obtiene un gráfico mediante su nombre.
ChartPointsCollection getCount() Devuelve el número de puntos del gráfico de la serie.
ChartSeriesCollection getCount() Devuelve el número de series incluidas en la colección.
NamedItem comment Especifica el comentario asociado a este nombre.
delete() Elimina el nombre especificado.
getRangeOrNullObject() Devuelve el objeto de rango asociado al nombre.
scope Especifica si el nombre se limita al libro o a una hoja de cálculo específica.
worksheet Devuelve la hoja de cálculo que tiene como ámbito el elemento con nombre.
worksheetOrNullObject Devuelve la hoja de cálculo a la que se limita el elemento con nombre.
NamedItemCollection add(name: string, reference: Range | string, comment?: string) Agrega un nuevo nombre a la colección del ámbito especificado.
addFormulaLocal(name: string, formula: string, comment?: string) Agrega un nuevo nombre a la colección del ámbito especificado, empleando la configuración regional del usuario para la fórmula.
getCount() Obtiene el número de elementos con nombre de la colección.
getItemOrNullObject(name: string) Obtiene un NamedItem objeto con su nombre.
PivotTableCollection getCount() Obtiene el número de tablas dinámicas de una colección.
getItemOrNullObject(name: string) Obtiene una tabla dinámica por nombre.
Range getIntersectionOrNullObject(anotherRange: Range | string) Obtiene el objeto de rango que representa la intersección rectangular de los rangos especificados.
getUsedRangeOrNullObject(valuesOnly?: boolean) Devuelve el intervalo usado del objeto de rango especificado.
RangeViewCollection getCount() Obtiene el número de objetos de RangeView la colección.
Valor delete() Elimina la configuración.
key Clave que representa el identificador de la configuración.
value Representa el valor almacenado para esta configuración.
SettingCollection add(key: string, value: string | number | boolean | Fecha | any[] | any) Establece o agrega la configuración especificada en el libro.
getCount() Obtiene el número de opciones de configuración de la colección.
getItem(key: string) Obtiene una entrada de configuración a través de la clave .
getItemOrNullObject(key: string) Obtiene una entrada de configuración a través de la clave .
items Obtiene los elementos secundarios cargados en esta colección.
onSettingsChanged Se produce cuando se cambia la configuración del documento.
SettingsChangedEventArgs settings Obtiene el Setting objeto que representa el enlace que generó el evento de cambio de configuración.
TableCollection getCount() Obtiene el número de tablas de la colección.
getItemOrNullObject(key: string) Obtener una tabla por nombre o identificador.
TableColumnCollection getCount() Obtiene el número de columnas de la tabla.
getItemOrNullObject(key: number | string) Obtiene un objeto de columna por nombre o identificador.
TableRowCollection getCount() Obtiene el número de filas de la tabla.
Workbook settings Representa una colección de valores asociados al libro.
Worksheet getUsedRangeOrNullObject(valuesOnly?: boolean) El rango usado es el rango más pequeño que abarque todas las celdas que tengan asignado un valor o un formato.
Nombres Colección de nombres en el ámbito de la hoja de cálculo actual.
WorksheetCollection getCount(visibleOnly?: boolean) Obtiene el número de hojas de cálculo de la colección.
getItemOrNullObject(key: string) Obtiene un objeto de hoja de cálculo mediante su nombre o identificador.

Vea también