Novedades de la API de JavaScript de Excel 1.14
ExcelApi 1.14 agregó objetos para controlar la característica de tabla de datos de un gráfico, un método para localizar todas las celdas anteriores de una fórmula y eventos de protección de hojas de cálculo para realizar un seguimiento de los cambios en el estado de protección de una hoja de cálculo. También agregó varios getItemOrNullObject
métodos para objetos como CommentCollection
, ShapeCollection
y StyleCollection
para mejorar el control de errores.
Área de característica | Descripción | Objetos relevantes |
---|---|---|
Tablas de datos de gráficos | Controlar la apariencia, el formato y la visibilidad de las tablas de datos en los gráficos. | Chart, ChartDataTable, ChartDataTableFormat |
Precedentes de fórmulas | Devuelve todas las celdas anteriores de una fórmula. | Range |
Consultas | Recupere Power Query atributos como el nombre, la fecha de actualización y el recuento de consultas. | Query, QueryCollection |
Eventos de protección de hojas de cálculo | Realice un seguimiento de los cambios en el estado de protección de una hoja de cálculo y el origen de esos cambios. | WorksheetProtectionChangedEventArgs, Worksheet, WorksheetCollection |
Lista de API
En la tabla siguiente se enumeran las API del conjunto de requisitos de la API de JavaScript de Excel 1.14. 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.14 o anterior, consulte Api de Excel en el conjunto de requisitos 1.14 o anterior.
Clase | Campos | Descripción |
---|---|---|
AutoFilter | clearColumnCriteria(columnIndex: number) | Borra los criterios de filtro de columna del Autofiltro. |
ChangeDirectionState | deleteShiftDirection | Representa la dirección (por ejemplo, hacia arriba o hacia la izquierda) que las celdas restantes se desplazarán cuando se elimine una celda o celdas. |
insertShiftDirection | Representa la dirección (por ejemplo, hacia abajo o hacia la derecha) que las celdas existentes se desplazarán cuando se inserte una nueva celda o celdas. | |
Chart | getDataTable() | Obtiene la tabla de datos del gráfico. |
getDataTableOrNullObject() | Obtiene la tabla de datos del gráfico. | |
ChartDataTable | format | Representa el formato de una tabla de datos de gráfico, que incluye el formato de relleno, fuente y borde. |
showHorizontalBorder | Especifica si se va a mostrar el borde horizontal de la tabla de datos. | |
showLegendKey | Especifica si se va a mostrar la clave de leyenda de la tabla de datos. | |
showOutlineBorder | Especifica si se va a mostrar el borde de esquema de la tabla de datos. | |
showVerticalBorder | Especifica si se va a mostrar el borde vertical de la tabla de datos. | |
visible | Especifica si se va a mostrar la tabla de datos del gráfico. | |
ChartDataTableFormat | border | Representa el formato de borde de la tabla de datos del gráfico, que incluye el color, el estilo de línea y el peso. |
fill | Representa el formato de relleno de un objeto, que incluye información del formato de fondo. | |
font | Representa los atributos de fuente (como el nombre de fuente, el tamaño de fuente y el color) del objeto actual. | |
CommentCollection | getItemOrNullObject(commentId: string) | Obtiene un comentario de la colección en función de su identificador. |
CommentReplyCollection | getItemOrNullObject(commentReplyId: string) | Devuelve una respuesta de comentario identificada por su Id. |
ConditionalFormatCollection | getItemOrNullObject(id: string) | Devuelve un formato condicional identificado por su identificador. |
GroupShapeCollection | getItemOrNullObject(key: string) | Obtiene una forma con su nombre o identificador. |
Query | error | Obtiene el mensaje de error de consulta desde la última vez que se actualizó la consulta. |
loadedTo | Obtiene la consulta cargada en el tipo de objeto. | |
loadedToDataModel | Especifica si la consulta se cargó en el modelo de datos. | |
name | Obtiene el nombre de la consulta. | |
refreshDate | Obtiene la fecha y hora en que se actualizó por última vez la consulta. | |
rowsLoadedCount | Obtiene el número de filas que se cargaron cuando se actualizó por última vez la consulta. | |
QueryCollection | getCount() | Obtiene el número de consultas del libro. |
getItem(key: string) | Obtiene una consulta de la colección en función de su nombre. | |
items | Obtiene los elementos secundarios cargados en esta colección. | |
Range | getPrecedents() | Devuelve un WorkbookRangeAreas objeto que representa el rango que contiene todas las celdas anteriores de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo. |
ShapeCollection | getItemOrNullObject(key: string) | Obtiene una forma con su nombre o identificador. |
StyleCollection | getItemOrNullObject(name: string) | Obtiene un estilo por nombre. |
TableScopedCollection | getItemOrNullObject(key: string) | Obtener una tabla por nombre o identificador. |
Workbook | Consultas | Devuelve una colección de consultas Power Query que forman parte del libro. |
Worksheet | onProtectionChanged | Se produce cuando se cambia el estado de protección de la hoja de cálculo. |
tabId | Devuelve un valor que representa esta hoja de cálculo que puede leer Open Office XML. | |
WorksheetChangedEventArgs | changeDirectionState | Representa un cambio en la dirección en que las celdas de una hoja de cálculo se desplazarán cuando se elimine o inserte una celda o celdas. |
triggerSource | Representa el origen del desencadenador del evento. | |
WorksheetCollection | onProtectionChanged | Se produce cuando se cambia el estado de protección de la hoja de cálculo. |
WorksheetProtectionChangedEventArgs | isProtected | Obtiene el estado de protección actual de la hoja de cálculo. |
source | Origen del evento. | |
type | Obtiene el tipo del evento. | |
worksheetId | Obtiene el identificador de la hoja de cálculo en la que se cambia el estado de protección. |