Compartir a través de


Excel.Worksheet class

Una hoja de cálculo de Excel es una cuadrícula de celdas. Puede contener datos, tablas, gráficos etcetera. Para obtener más información sobre el modelo de objetos de hoja de cálculo, lea Trabajar con hojas de cálculo mediante la API de JavaScript de Excel.

Extends

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

// Get a Worksheet object by its name and activate it.
await Excel.run(async (context) => { 
    const wSheetName = 'Sheet1';
    const worksheet = context.workbook.worksheets.getItem(wSheetName);
    worksheet.activate();
    await context.sync(); 
});

Propiedades

autoFilter

Representa el AutoFilter objeto de la hoja de cálculo.

charts

Devuelve una colección de gráficos que forman parte de la hoja de cálculo.

comments

Devuelve una colección de todos los objetos Comments en la hoja de cálculo.

context

Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.

customProperties

Obtiene una colección de propiedades personalizadas de nivel de hoja de cálculo.

enableCalculation

Determina si Excel debe recalcular la hoja de cálculo cuando sea necesario. True si Excel vuelve a calcular la hoja de cálculo cuando sea necesario. False si Excel no actualiza la hoja.

freezePanes

Obtiene un objeto que se puede usar para manipular paneles inmovilizados en la hoja de cálculo.

horizontalPageBreaks

Obtiene la colección de saltos de página horizontales de la hoja de cálculo. Esta colección solo contiene saltos de página manuales.

id

Devuelve un valor que identifica de forma única la hoja de cálculo de un libro determinado. El valor del identificador permanece igual, incluso cuando se cambia el nombre de la hoja de cálculo o cuando esta se mueve.

name

Nombre para mostrar de la hoja de cálculo. El nombre debe tener menos de 32 caracteres.

namedSheetViews

Devuelve una colección de vistas de hoja que están presentes en la hoja de cálculo.

names

Colección de nombres en el ámbito de la hoja de cálculo actual.

pageLayout

Obtiene el PageLayout objeto de la hoja de cálculo.

pivotTables

Colección de tablas dinámicas que forman parte de la hoja de cálculo.

position

Posición de base cero de la hoja de cálculo dentro del libro.

protection

Devuelve el objeto de protección de hoja de una hoja de cálculo.

shapes

Devuelve la colección de todos los objetos Shape en la hoja de cálculo.

showGridlines

Especifica si las líneas de cuadrícula son visibles para el usuario.

showHeadings

Especifica si los encabezados son visibles para el usuario.

slicers

Devuelve una colección de segmentaciones de datos que forman parte de la hoja de cálculo.

standardHeight

Devuelve el ancho estándar (predeterminado) de todas las filas de la hoja de cálculo, en puntos.

standardWidth

Especifica el ancho estándar (predeterminado) de todas las columnas de la hoja de cálculo. Una unidad de ancho de columna equivale al ancho de un carácter con el estilo Normal. En las fuentes proporcionales se utiliza el ancho del carácter 0 (cero).

tabColor

Color de pestaña de la hoja de cálculo. Al recuperar el color de la pestaña, si la hoja de cálculo es invisible, el valor será null. Si la hoja de cálculo está visible pero el color de la pestaña se establece en automático, se devolverá una cadena vacía. De lo contrario, la propiedad se establecerá en un color, en el formulario #RRGGBB (por ejemplo, "FFA500"). Al establecer el color, use una cadena vacía para establecer un color "auto" o un color real en caso contrario.

tabId

Devuelve un valor que representa esta hoja de cálculo que puede leer Open Office XML. Se trata de un valor entero, que es diferente de worksheet.id (que devuelve un identificador único global) y worksheet.name (que devuelve un valor como "Sheet1").

tables

Colección de tablas que forman parte de la hoja de cálculo.

tasks

Devuelve una colección de tareas que están presentes en la hoja de cálculo.

verticalPageBreaks

Obtiene la colección de saltos de página verticales de la hoja de cálculo. Esta colección solo contiene saltos de página manuales.

visibility

Visibilidad de la hoja de cálculo.

Métodos

activate()

Activa la hoja de cálculo en la interfaz de usuario de Excel.

calculate(markAllDirty)

Calcula todas las celdas de una hoja de cálculo.

copy(positionType, relativeTo)

Copia una hoja de cálculo y la coloca en la posición especificada.

copy(positionTypeString, relativeTo)

Copia una hoja de cálculo y la coloca en la posición especificada.

delete()

Elimina la hoja de cálculo del libro. Tenga en cuenta que si la visibilidad de la hoja de cálculo está establecida en "VeryHidden", se producirá un error en la operación de eliminación con una InvalidOperation excepción. Primero debe cambiar su visibilidad a oculta o visible antes de eliminarla.

findAll(text, criteria)

Busca todas las repeticiones de la cadena especificada en función de los criterios especificados y las devuelve como un RangeAreas objeto, que comprende uno o varios intervalos rectangulares.

findAllOrNullObject(text, criteria)

Busca todas las repeticiones de la cadena especificada en función de los criterios especificados y las devuelve como un RangeAreas objeto, que comprende uno o varios intervalos rectangulares.

getCell(row, column)

Obtiene el Range objeto que contiene la celda única en función de los números de fila y columna. La celda puede estar fuera de los límites de su rango primario, siempre y cuando permanezca dentro de la cuadrícula de la hoja de cálculo.

getNext(visibleOnly)

Obtiene la hoja de cálculo que sigue a esta. Si no hay ninguna hoja de cálculo después de esta, este método producirá un error.

getNextOrNullObject(visibleOnly)

Obtiene la hoja de cálculo que sigue a esta. Si no hay ninguna hoja de cálculo después de esta, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

getPrevious(visibleOnly)

Obtiene la hoja de cálculo que precede a esta. Si no hay hojas de cálculo anteriores, este método producirá un error.

getPreviousOrNullObject(visibleOnly)

Obtiene la hoja de cálculo que precede a esta. Si no hay hojas de cálculo anteriores, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

getRange(address)

Obtiene el Range objeto , que representa un único bloque rectangular de celdas, especificado por la dirección o el nombre.

getRangeByIndexes(startRow, startColumn, rowCount, columnCount)

Obtiene el Range objeto que comienza en un índice de fila y un índice de columna determinados, y abarca un determinado número de filas y columnas.

getRanges(address)

Obtiene el RangeAreas objeto , que representa uno o varios bloques de intervalos rectangulares, especificados por la dirección o el nombre.

getUsedRange(valuesOnly)

El rango usado es el rango más pequeño que abarque todas las celdas que tengan asignado un valor o un formato. Si toda la hoja de cálculo está en blanco, esta función devolverá la celda superior izquierda (es decir, no producirá un error).

getUsedRangeOrNullObject(valuesOnly)

El rango usado es el rango más pequeño que abarque todas las celdas que tengan asignado un valor o un formato. Si toda la hoja de cálculo está en blanco, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

replaceAll(text, replacement, criteria)

Busca y reemplaza la cadena especificada, según los criterios especificados dentro de la hoja de cálculo actual.

set(properties, options)

Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto de API del mismo tipo.

set(properties)

Establece varias propiedades en el objeto al mismo tiempo, en función de un objeto cargado existente.

showOutlineLevels(rowLevels, columnLevels)

Muestra los grupos de filas o columnas por sus niveles de esquema. Describe los grupos y resume una lista de datos de la hoja de cálculo. Los rowLevels parámetros y columnLevels especifican cuántos niveles del esquema se mostrarán. El intervalo de argumentos aceptable está comprendido entre 0 y 8. Un valor de 0 no cambia la presentación actual. Un valor mayor que el número actual de niveles muestra todos los niveles.

toJSON()

Invalida el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify(). (JSON.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto Excel.Worksheet original es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como Excel.Interfaces.WorksheetData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

Eventos

onActivated

Se produce cuando se activa la hoja de cálculo.

onCalculated

Se produce cuando se calcula la hoja de cálculo.

onChanged

Se produce cuando los datos cambian en una hoja de cálculo específica.

onColumnSorted

Se produce cuando se han ordenado una o más columnas. Esto sucede como resultado de una operación de ordenación de izquierda a derecha.

onDeactivated

Se produce cuando se desactiva la hoja de cálculo.

onFiltered

Se produce cuando se aplica un filtro en una hoja de cálculo específica.

onFormatChanged

Se produce cuando se cambia el formato una hoja de cálculo concreta.

onFormulaChanged

Se produce cuando se cambian una o varias fórmulas en esta hoja de cálculo. Este evento es para cuando cambia la propia fórmula, no para el valor de datos resultante del cálculo de la fórmula.

onNameChanged

Se produce cuando se cambia el nombre de la hoja de cálculo.

onProtectionChanged

Se produce cuando se cambia el estado de protección de la hoja de cálculo.

onRowHiddenChanged

Se produce cuando el estado oculto de una o varias filas ha cambiado en una hoja de cálculo específica.

onRowSorted

Se produce cuando se han ordenado una o más filas. Esto sucede cuando se produce una operación de ordenación de arriba a abajo.

onSelectionChanged

Se produce cuando la selección cambia en una hoja de cálculo específica.

onSingleClicked

Se produce cuando se produce una acción de pulsar o hacer clic con el botón izquierdo en la hoja de cálculo. Este evento no se desencadenará al hacer clic en los casos siguientes:

  • El usuario arrastra el mouse para la selección múltiple.

  • El usuario selecciona una celda en el modo cuando se seleccionan argumentos de celda para las referencias de fórmula.

onVisibilityChanged

Se produce cuando se cambia la visibilidad de la hoja de cálculo.

Detalles de las propiedades

autoFilter

Representa el AutoFilter objeto de la hoja de cálculo.

readonly autoFilter: Excel.AutoFilter;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml

// This function adds a percentage AutoFilter to the active worksheet 
// and applies the filter to a column of the used range.
await Excel.run(async (context) => {
    // Retrieve the active worksheet and the used range on that worksheet.
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const farmData = sheet.getUsedRange();

    // Add a filter that will only show the rows with the top 50% of values in column 3.
    sheet.autoFilter.apply(farmData, 3, {
        criterion1: "50",
        filterOn: Excel.FilterOn.topPercent
    });

    await context.sync();
});

charts

Devuelve una colección de gráficos que forman parte de la hoja de cálculo.

readonly charts: Excel.ChartCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

comments

Devuelve una colección de todos los objetos Comments en la hoja de cálculo.

readonly comments: Excel.CommentCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

context

Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.

context: RequestContext;

Valor de propiedad

customProperties

Obtiene una colección de propiedades personalizadas de nivel de hoja de cálculo.

readonly customProperties: Excel.WorksheetCustomPropertyCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.12 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/26-document/custom-properties.yaml

await Excel.run(async (context) => {
  // Load the keys and values of all custom properties in the current worksheet.
  const customWorksheetProperties = context.workbook.worksheets.getActiveWorksheet().customProperties;
  customWorksheetProperties.load(["key", "value"]);
  await context.sync();

  // Log each custom property to the console.
  // Note that your document may have more properties than those you have set using this snippet.
  customWorksheetProperties.items.forEach((property) => {
    console.log(`${property.key}:${property.value}`);
  });
});

enableCalculation

Determina si Excel debe recalcular la hoja de cálculo cuando sea necesario. True si Excel vuelve a calcular la hoja de cálculo cuando sea necesario. False si Excel no actualiza la hoja.

enableCalculation: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

freezePanes

Obtiene un objeto que se puede usar para manipular paneles inmovilizados en la hoja de cálculo.

readonly freezePanes: Excel.WorksheetFreezePanes;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

horizontalPageBreaks

Obtiene la colección de saltos de página horizontales de la hoja de cálculo. Esta colección solo contiene saltos de página manuales.

readonly horizontalPageBreaks: Excel.PageBreakCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

id

Devuelve un valor que identifica de forma única la hoja de cálculo de un libro determinado. El valor del identificador permanece igual, incluso cuando se cambia el nombre de la hoja de cálculo o cuando esta se mueve.

readonly id: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

name

Nombre para mostrar de la hoja de cálculo. El nombre debe tener menos de 32 caracteres.

name: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

namedSheetViews

Devuelve una colección de vistas de hoja que están presentes en la hoja de cálculo.

readonly namedSheetViews: Excel.NamedSheetViewCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApiOnline 1.1 ]

names

Colección de nombres en el ámbito de la hoja de cálculo actual.

readonly names: Excel.NamedItemCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.4 ]

pageLayout

Obtiene el PageLayout objeto de la hoja de cálculo.

readonly pageLayout: Excel.PageLayout;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

pivotTables

Colección de tablas dinámicas que forman parte de la hoja de cálculo.

readonly pivotTables: Excel.PivotTableCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.3 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-get-pivottables.yaml

await Excel.run(async (context) => {
  // Get the names of all the PivotTables in the current worksheet.
  const pivotTables = context.workbook.worksheets.getActiveWorksheet().pivotTables;
  pivotTables.load("name");
  await context.sync();

  // Display the names in the console.
  console.log("PivotTables in the current worksheet:")
  pivotTables.items.forEach((pivotTable) => {
    console.log(`\t${pivotTable.name}`);
  });
});

position

Posición de base cero de la hoja de cálculo dentro del libro.

position: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

// Set worksheet position.
await Excel.run(async (context) => { 
    const wSheetName = 'Sheet1';
    const worksheet = context.workbook.worksheets.getItem(wSheetName);
    worksheet.position = 2;
    await context.sync(); 
});

protection

Devuelve el objeto de protección de hoja de una hoja de cálculo.

readonly protection: Excel.WorksheetProtection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Ejemplos

// Unprotecting a worksheet with unprotect() will remove all 
// WorksheetProtectionOptions options applied to a worksheet.
// To remove only a subset of WorksheetProtectionOptions use the 
// protect() method and set the options you wish to remove to true.
await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem("Sheet1");
  sheet.protection.protect({
    allowInsertRows: false, // Protect row insertion
    allowDeleteRows: true // Unprotect row deletion
  });
});

shapes

Devuelve la colección de todos los objetos Shape en la hoja de cálculo.

readonly shapes: Excel.ShapeCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

showGridlines

Especifica si las líneas de cuadrícula son visibles para el usuario.

showGridlines: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/gridlines.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    sheet.showGridlines = true;

    await context.sync();
});

showHeadings

Especifica si los encabezados son visibles para el usuario.

showHeadings: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

slicers

Devuelve una colección de segmentaciones de datos que forman parte de la hoja de cálculo.

readonly slicers: Excel.SlicerCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-slicer.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Pivot");
    const slicer = sheet.slicers.add(
        "Farm Sales", /* The slicer data source. For PivotTables, this can be the PivotTable object reference or name. */
        "Type" /* The field in the data source to filter by. For PivotTables, this can be a PivotField object reference or ID. */
    );
    slicer.name = "Fruit Slicer";
    await context.sync();
});

standardHeight

Devuelve el ancho estándar (predeterminado) de todas las filas de la hoja de cálculo, en puntos.

readonly standardHeight: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

standardWidth

Especifica el ancho estándar (predeterminado) de todas las columnas de la hoja de cálculo. Una unidad de ancho de columna equivale al ancho de un carácter con el estilo Normal. En las fuentes proporcionales se utiliza el ancho del carácter 0 (cero).

standardWidth: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

tabColor

Color de pestaña de la hoja de cálculo. Al recuperar el color de la pestaña, si la hoja de cálculo es invisible, el valor será null. Si la hoja de cálculo está visible pero el color de la pestaña se establece en automático, se devolverá una cadena vacía. De lo contrario, la propiedad se establecerá en un color, en el formulario #RRGGBB (por ejemplo, "FFA500"). Al establecer el color, use una cadena vacía para establecer un color "auto" o un color real en caso contrario.

tabColor: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/tab-color.yaml

await Excel.run(async (context) => {
    const activeSheet = context.workbook.worksheets.getActiveWorksheet();
    activeSheet.tabColor = "#FF0000";

    await context.sync();
});

tabId

Devuelve un valor que representa esta hoja de cálculo que puede leer Open Office XML. Se trata de un valor entero, que es diferente de worksheet.id (que devuelve un identificador único global) y worksheet.name (que devuelve un valor como "Sheet1").

readonly tabId: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: ExcelApi 1.14 ]

tables

Colección de tablas que forman parte de la hoja de cálculo.

readonly tables: Excel.TableCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

tasks

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Devuelve una colección de tareas que están presentes en la hoja de cálculo.

readonly tasks: Excel.DocumentTaskCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi BETA (SOLO VERSIÓN PRELIMINAR) ]

verticalPageBreaks

Obtiene la colección de saltos de página verticales de la hoja de cálculo. Esta colección solo contiene saltos de página manuales.

readonly verticalPageBreaks: Excel.PageBreakCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

visibility

Visibilidad de la hoja de cálculo.

visibility: Excel.SheetVisibility | "Visible" | "Hidden" | "VeryHidden";

Valor de propiedad

Excel.SheetVisibility | "Visible" | "Hidden" | "VeryHidden"

Comentarios

[ Conjunto de API: ExcelApi 1.1 para leer la visibilidad; 1.2 para establecerla. ]

Detalles del método

activate()

Activa la hoja de cálculo en la interfaz de usuario de Excel.

activate(): void;

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

await Excel.run(async (context) => { 
    const wSheetName = 'Sheet1';
    const worksheet = context.workbook.worksheets.getItem(wSheetName);
    worksheet.activate();
    await context.sync(); 
});

calculate(markAllDirty)

Calcula todas las celdas de una hoja de cálculo.

calculate(markAllDirty: boolean): void;

Parámetros

markAllDirty

boolean

True, para marcar todo como sucio.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.6 ]

copy(positionType, relativeTo)

Copia una hoja de cálculo y la coloca en la posición especificada.

copy(positionType?: Excel.WorksheetPositionType, relativeTo?: Excel.Worksheet): Excel.Worksheet;

Parámetros

positionType
Excel.WorksheetPositionType

Ubicación del libro para colocar la hoja de cálculo recién creada. El valor predeterminado es "None", que inserta la hoja de cálculo al principio de la hoja de cálculo.

relativeTo
Excel.Worksheet

Hoja de cálculo existente que determina la posición de la hoja de cálculo recién creada. Esto solo es necesario si positionType es "Antes" o "Después".

Devoluciones

Hoja de cálculo recién creada.

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-copy.yaml

await Excel.run(async (context) => {

    let myWorkbook = context.workbook;
    let sampleSheet = myWorkbook.worksheets.getActiveWorksheet();
    let copiedSheet = sampleSheet.copy("End")

    sampleSheet.load("name");
    copiedSheet.load("name");

    await context.sync();

    console.log("'" + sampleSheet.name + "' was copied to '" + copiedSheet.name + "'")
});

copy(positionTypeString, relativeTo)

Copia una hoja de cálculo y la coloca en la posición especificada.

copy(positionTypeString?: "None" | "Before" | "After" | "Beginning" | "End", relativeTo?: Excel.Worksheet): Excel.Worksheet;

Parámetros

positionTypeString

"None" | "Before" | "After" | "Beginning" | "End"

Ubicación del libro para colocar la hoja de cálculo recién creada. El valor predeterminado es "None", que inserta la hoja de cálculo al principio de la hoja de cálculo.

relativeTo
Excel.Worksheet

Hoja de cálculo existente que determina la posición de la hoja de cálculo recién creada. Esto solo es necesario si positionType es "Antes" o "Después".

Devoluciones

Hoja de cálculo recién creada.

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

delete()

Elimina la hoja de cálculo del libro. Tenga en cuenta que si la visibilidad de la hoja de cálculo está establecida en "VeryHidden", se producirá un error en la operación de eliminación con una InvalidOperation excepción. Primero debe cambiar su visibilidad a oculta o visible antes de eliminarla.

delete(): void;

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

await Excel.run(async (context) => { 
    const wSheetName = 'Sheet1';
    const worksheet = context.workbook.worksheets.getItem(wSheetName);
    worksheet.delete();
    await context.sync(); 
});

findAll(text, criteria)

Busca todas las repeticiones de la cadena especificada en función de los criterios especificados y las devuelve como un RangeAreas objeto, que comprende uno o varios intervalos rectangulares.

findAll(text: string, criteria: Excel.WorksheetSearchCriteria): Excel.RangeAreas;

Parámetros

text

string

Cadena que se va a buscar.

criteria
Excel.WorksheetSearchCriteria

Criterios de búsqueda adicionales, incluido si la búsqueda debe coincidir con toda la celda o distinguir entre mayúsculas y minúsculas.

Devoluciones

Objeto RangeAreas , que consta de uno o varios intervalos rectangulares, que coincide con los criterios de búsqueda. Si ninguna celda cumple este criterio, se producirá un ItemNotFound error.

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

findAllOrNullObject(text, criteria)

Busca todas las repeticiones de la cadena especificada en función de los criterios especificados y las devuelve como un RangeAreas objeto, que comprende uno o varios intervalos rectangulares.

findAllOrNullObject(text: string, criteria: Excel.WorksheetSearchCriteria): Excel.RangeAreas;

Parámetros

text

string

Cadena que se va a buscar.

criteria
Excel.WorksheetSearchCriteria

Criterios de búsqueda adicionales, incluido si la búsqueda debe coincidir con toda la celda o distinguir entre mayúsculas y minúsculas.

Devoluciones

Objeto RangeAreas , que consta de uno o varios intervalos rectangulares, que coincide con los criterios de búsqueda. Si no hay coincidencias, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-find-all.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    const foundRanges = sheet.findAllOrNullObject("Complete", {
        completeMatch: true,
        matchCase: false
    });

    await context.sync();

    if (foundRanges.isNullObject) {
        console.log("No complete projects");
    } else {
        foundRanges.format.fill.color = "green"
    }
});

getCell(row, column)

Obtiene el Range objeto que contiene la celda única en función de los números de fila y columna. La celda puede estar fuera de los límites de su rango primario, siempre y cuando permanezca dentro de la cuadrícula de la hoja de cálculo.

getCell(row: number, column: number): Excel.Range;

Parámetros

row

number

Número de fila de la celda que se va a recuperar. Indizado con cero.

column

number

Número de columna de la celda que se va a recuperar. Indizado con cero.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

await Excel.run(async (context) => { 
    const sheetName = "Sheet1";
    const rangeAddress = "A1:F8";
    const worksheet = context.workbook.worksheets.getItem(sheetName);
    const cell = worksheet.getCell(0,0);
    cell.load('address');
    await context.sync();

    console.log(cell.address);
});

getNext(visibleOnly)

Obtiene la hoja de cálculo que sigue a esta. Si no hay ninguna hoja de cálculo después de esta, este método producirá un error.

getNext(visibleOnly?: boolean): Excel.Worksheet;

Parámetros

visibleOnly

boolean

Opcional. Si truees , solo tiene en cuenta las hojas de cálculo visibles, omitiendo las ocultas.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.5 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/reference-worksheets-by-relative-position.yaml

await Excel.run(async (context) => {
    const sheets = context.workbook.worksheets;

    // We don't want to include the default worksheet that was created
    // when the workbook was created, so our "firstSheet" will be the one
    // after the literal first. Note chaining of navigation methods.
    const firstSheet = sheets.getFirst().getNext();
    const lastSheet = sheets.getLast();
    const firstTaxRateRange = firstSheet.getRange("B2");
    const lastTaxRateRange = lastSheet.getRange("B2");

    firstSheet.load("name");
    lastSheet.load("name");
    firstTaxRateRange.load("text");
    lastTaxRateRange.load("text");

    await context.sync();

    let firstYear = firstSheet.name.substr(5, 4);
    let lastYear = lastSheet.name.substr(5, 4);
    console.log(`Tax Rate change from ${firstYear} to ${lastYear}`, `Tax rate for ${firstYear}: ${firstTaxRateRange.text[0][0]}\nTax rate for ${lastYear}: ${lastTaxRateRange.text[0][0]}`)

    await context.sync();
});

getNextOrNullObject(visibleOnly)

Obtiene la hoja de cálculo que sigue a esta. Si no hay ninguna hoja de cálculo después de esta, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

getNextOrNullObject(visibleOnly?: boolean): Excel.Worksheet;

Parámetros

visibleOnly

boolean

Opcional. Si truees , solo tiene en cuenta las hojas de cálculo visibles, omitiendo las ocultas.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.5 ]

getPrevious(visibleOnly)

Obtiene la hoja de cálculo que precede a esta. Si no hay hojas de cálculo anteriores, este método producirá un error.

getPrevious(visibleOnly?: boolean): Excel.Worksheet;

Parámetros

visibleOnly

boolean

Opcional. Si truees , solo tiene en cuenta las hojas de cálculo visibles, omitiendo las ocultas.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.5 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/reference-worksheets-by-relative-position.yaml

await Excel.run(async (context) => {
    const sheets = context.workbook.worksheets;
    const currentSheet = sheets.getActiveWorksheet();
    const previousYearSheet = currentSheet.getPrevious();
    const currentTaxDueRange = currentSheet.getRange("C2");
    const previousTaxDueRange = previousYearSheet.getRange("C2");

    currentSheet.load("name");
    previousYearSheet.load("name");
    currentTaxDueRange.load("text");
    previousTaxDueRange.load("text");

    await context.sync();

    let currentYear = currentSheet.name.substr(5, 4);
    let previousYear = previousYearSheet.name.substr(5, 4);
    console.log("Two Year Tax Due Comparison", `Tax due for ${currentYear} was ${currentTaxDueRange.text[0][0]}\nTax due for ${previousYear} was ${previousTaxDueRange.text[0][0]}`)

    await context.sync();
});

getPreviousOrNullObject(visibleOnly)

Obtiene la hoja de cálculo que precede a esta. Si no hay hojas de cálculo anteriores, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

getPreviousOrNullObject(visibleOnly?: boolean): Excel.Worksheet;

Parámetros

visibleOnly

boolean

Opcional. Si truees , solo tiene en cuenta las hojas de cálculo visibles, omitiendo las ocultas.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.5 ]

getRange(address)

Obtiene el Range objeto , que representa un único bloque rectangular de celdas, especificado por la dirección o el nombre.

getRange(address?: string): Excel.Range;

Parámetros

address

string

Opcional. Cadena que representa la dirección o el nombre del intervalo. Por ejemplo, "A1:B2". Si no se especifica, se devuelve todo el intervalo de la hoja de cálculo.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

// Use the range address to get the range object.
await Excel.run(async (context) => { 
    const sheetName = "Sheet1";
    const rangeAddress = "A1:F8";
    const worksheet = context.workbook.worksheets.getItem(sheetName);
    const range = worksheet.getRange(rangeAddress);
    range.load('cellCount');
    await context.sync();
    
    console.log(range.cellCount);
});

getRangeByIndexes(startRow, startColumn, rowCount, columnCount)

Obtiene el Range objeto que comienza en un índice de fila y un índice de columna determinados, y abarca un determinado número de filas y columnas.

getRangeByIndexes(startRow: number, startColumn: number, rowCount: number, columnCount: number): Excel.Range;

Parámetros

startRow

number

Fila de inicio (indizada en cero).

startColumn

number

Columna De inicio (indizada en cero).

rowCount

number

Número de filas que se van a incluir en el intervalo.

columnCount

number

Número de columnas que se van a incluir en el intervalo.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

getRanges(address)

Obtiene el RangeAreas objeto , que representa uno o varios bloques de intervalos rectangulares, especificados por la dirección o el nombre.

getRanges(address?: string): Excel.RangeAreas;

Parámetros

address

string

Opcional. Cadena que contiene las direcciones o nombres separados por comas o punto y coma de los intervalos individuales. Por ejemplo, "A1:B2, A5:B5" o "A1:B2; A5:B5". Si no se especifica, se devuelve un RangeAreas objeto para toda la hoja de cálculo.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-areas.yaml

await Excel.run(async (context) => {

    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const specifiedRanges = sheet.getRanges("D3:D5, G3:G5");
    specifiedRanges.format.fill.color = "pink";

    await context.sync();
})

getUsedRange(valuesOnly)

El rango usado es el rango más pequeño que abarque todas las celdas que tengan asignado un valor o un formato. Si toda la hoja de cálculo está en blanco, esta función devolverá la celda superior izquierda (es decir, no producirá un error).

getUsedRange(valuesOnly?: boolean): Excel.Range;

Parámetros

valuesOnly

boolean

Opcional. Si truees , solo tiene en cuenta las celdas con valores como celdas usadas (omitiendo el formato). [Conjunto de api: ExcelApi 1.2]

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Ejemplos

await Excel.run(async (context) => { 
    const wSheetName = 'Sheet1';
    const worksheet = context.workbook.worksheets.getItem(wSheetName);
    const usedRange = worksheet.getUsedRange();
    usedRange.load('address');
    await context.sync();
    
    console.log(usedRange.address);
});

getUsedRangeOrNullObject(valuesOnly)

El rango usado es el rango más pequeño que abarque todas las celdas que tengan asignado un valor o un formato. Si toda la hoja de cálculo está en blanco, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea *OrNullObject methods and properties( Métodos y propiedades de *OrNullObject).

getUsedRangeOrNullObject(valuesOnly?: boolean): Excel.Range;

Parámetros

valuesOnly

boolean

Opcional. Solo tiene en cuenta las celdas con valores como celdas usadas.

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.4 ]

load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(options?: Excel.Interfaces.WorksheetLoadOptions): Excel.Worksheet;

Parámetros

options
Excel.Interfaces.WorksheetLoadOptions

Proporciona opciones para las propiedades del objeto que se van a cargar.

Devoluciones

load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames?: string | string[]): Excel.Worksheet;

Parámetros

propertyNames

string | string[]

Una cadena delimitada por comas o una matriz de cadenas que especifican las propiedades que se van a cargar.

Devoluciones

Ejemplos

// Get worksheet properties based on sheet name.
await Excel.run(async (context) => { 
    const wSheetName = 'Sheet1';
    const worksheet = context.workbook.worksheets.getItem(wSheetName);
    worksheet.load('position')
    await context.sync();
    
    console.log(worksheet.position);
});

load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.Worksheet;

Parámetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select es una cadena delimitada por comas que especifica las propiedades que se van a cargar y propertyNamesAndPaths.expand es una cadena delimitada por comas que especifica las propiedades de navegación que se van a cargar.

Devoluciones

replaceAll(text, replacement, criteria)

Busca y reemplaza la cadena especificada, según los criterios especificados dentro de la hoja de cálculo actual.

replaceAll(text: string, replacement: string, criteria: Excel.ReplaceCriteria): OfficeExtension.ClientResult<number>;

Parámetros

text

string

Cadena que se va a buscar.

replacement

string

Cadena que reemplaza a la cadena original.

criteria
Excel.ReplaceCriteria

Criterios de reemplazo adicionales.

Devoluciones

Número de reemplazos realizados.

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

set(properties, options)

Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto de API del mismo tipo.

set(properties: Interfaces.WorksheetUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parámetros

properties
Excel.Interfaces.WorksheetUpdateData

Objeto JavaScript con propiedades estructuradas isomórficamente con las propiedades del objeto al que se llama al método.

options
OfficeExtension.UpdateOptions

Proporciona una opción para suprimir errores si el objeto properties intenta establecer propiedades de solo lectura.

Devoluciones

void

Ejemplos

// Set the color and name of the current worksheet.
await Excel.run(async (context) => {
  const activeSheet = context.workbook.worksheets.getActiveWorksheet();
  activeSheet.set({
    tabColor: "yellow",
    name: "MySheet"
  });

  await context.sync();
});

set(properties)

Establece varias propiedades en el objeto al mismo tiempo, en función de un objeto cargado existente.

set(properties: Excel.Worksheet): void;

Parámetros

properties
Excel.Worksheet

Devoluciones

void

showOutlineLevels(rowLevels, columnLevels)

Muestra los grupos de filas o columnas por sus niveles de esquema. Describe los grupos y resume una lista de datos de la hoja de cálculo. Los rowLevels parámetros y columnLevels especifican cuántos niveles del esquema se mostrarán. El intervalo de argumentos aceptable está comprendido entre 0 y 8. Un valor de 0 no cambia la presentación actual. Un valor mayor que el número actual de niveles muestra todos los niveles.

showOutlineLevels(rowLevels: number, columnLevels: number): void;

Parámetros

rowLevels

number

Número de niveles de fila de un esquema que se van a mostrar.

columnLevels

number

Número de niveles de columna de un esquema que se va a mostrar.

Devoluciones

void

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/outline.yaml

Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();

    // This shows the top 3 outline levels; collapsing any additional sublevels.
    sheet.showOutlineLevels(3, 3);
    await context.sync();
});

toJSON()

Invalida el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify(). (JSON.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto Excel.Worksheet original es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como Excel.Interfaces.WorksheetData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

toJSON(): Excel.Interfaces.WorksheetData;

Devoluciones

Detalles del evento

onActivated

Se produce cuando se activa la hoja de cálculo.

readonly onActivated: OfficeExtension.EventHandlers<Excel.WorksheetActivatedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Ejemplos

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    sheet.onActivated.add(function (event) {
        return Excel.run(async (context) => {
            console.log("The activated worksheet ID is: " + event.worksheetId);
            await context.sync();
        });
    });
    await context.sync();
});

onCalculated

Se produce cuando se calcula la hoja de cálculo.

readonly onCalculated: OfficeExtension.EventHandlers<Excel.WorksheetCalculatedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    sheet.onCalculated.add(function (event) {
        return Excel.run(async (context) => {
            console.log("The worksheet has recalculated.");
            await context.sync();
        });
    });
    await context.sync();
});

onChanged

Se produce cuando los datos cambian en una hoja de cálculo específica.

readonly onChanged: OfficeExtension.EventHandlers<Excel.WorksheetChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet.yaml

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    sheet.onChanged.add(onChange);
    await context.sync();

    console.log("Added a worksheet-level data-changed event handler.");
});

onColumnSorted

Se produce cuando se han ordenado una o más columnas. Esto sucede como resultado de una operación de ordenación de izquierda a derecha.

readonly onColumnSorted: OfficeExtension.EventHandlers<Excel.WorksheetColumnSortedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/event-column-and-row-sort.yaml

await Excel.run(async (context) => {
    console.log("Adding column handler");
    const sheet = context.workbook.worksheets.getActiveWorksheet();

    // This will fire whenever a column has been moved as the result of a sort action.
    sheet.onColumnSorted.add((event) => {
        return Excel.run((context) => {
            console.log("Column sorted: " + event.address);
            const sheet = context.workbook.worksheets.getActiveWorksheet();

            // Clear formatting for section, then highlight the sorted area.
            sheet.getRange("A1:E5").format.fill.clear();
            if (event.address !== "") {
                sheet.getRanges(event.address).format.fill.color = "yellow";
            }

            return context.sync();
        });
    });
});

onDeactivated

Se produce cuando se desactiva la hoja de cálculo.

readonly onDeactivated: OfficeExtension.EventHandlers<Excel.WorksheetDeactivatedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Ejemplos

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    sheet.onDeactivated.add(function (event) {
        return Excel.run(async (context) => {
            console.log("The deactivated worksheet is: " + event.worksheetId);
            await context.sync();
        });
    });
    await context.sync();
});

onFiltered

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Se produce cuando se aplica un filtro en una hoja de cálculo específica.

readonly onFiltered: OfficeExtension.EventHandlers<Excel.WorksheetFilteredEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi BETA (SOLO VERSIÓN PRELIMINAR) ]

onFormatChanged

Se produce cuando se cambia el formato una hoja de cálculo concreta.

readonly onFormatChanged: OfficeExtension.EventHandlers<Excel.WorksheetFormatChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

onFormulaChanged

Se produce cuando se cambian una o varias fórmulas en esta hoja de cálculo. Este evento es para cuando cambia la propia fórmula, no para el valor de datos resultante del cálculo de la fórmula.

readonly onFormulaChanged: OfficeExtension.EventHandlers<Excel.WorksheetFormulaChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-formula-changed.yaml

await Excel.run(async (context) => {
  // Retrieve the worksheet named "Sample".
  let sheet = context.workbook.worksheets.getItem("Sample");
  
  // Register the formula changed event handler for this worksheet.
  sheet.onFormulaChanged.add(formulaChangeHandler);
  await context.sync();
  
  console.log("Registered a formula changed event handler for this worksheet.");
});

...

async function formulaChangeHandler(event: Excel.WorksheetFormulaChangedEventArgs) {
  await Excel.run(async (context) => {
    // Retrieve details about the formula change event.
    const cellAddress = event.formulaDetails[0].cellAddress;
    const previousFormula = event.formulaDetails[0].previousFormula;
    const source = event.source;
    
    // Print out the change event details.
    console.log(
      `The formula in cell ${cellAddress} changed. 
      The previous formula was: ${previousFormula}. 
      The source of the change was: ${source}.`
    );
  });
}

onNameChanged

Se produce cuando se cambia el nombre de la hoja de cálculo.

readonly onNameChanged: OfficeExtension.EventHandlers<Excel.WorksheetNameChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.17 ]

onProtectionChanged

Se produce cuando se cambia el estado de protección de la hoja de cálculo.

readonly onProtectionChanged: OfficeExtension.EventHandlers<Excel.WorksheetProtectionChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.14 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet-protection.yaml

// This function registers an event handler for the onProtectionChanged event of a worksheet.
await Excel.run(async (context) => {
    // Set "Sample" as the active worksheet.
    context.workbook.worksheets.getItemOrNullObject("Sample").delete();
    const sheet = context.workbook.worksheets.add("Sample");
    sheet.activate();

    // Register the onProtectionChanged event handler.
    sheet.onProtectionChanged.add(checkProtection);
    await context.sync();
    console.log("Added a worksheet protection change event handler.");
});

...

async function checkProtection(event: Excel.WorksheetProtectionChangedEventArgs) {
    // This function is an event handler that returns the protection status of a worksheet
    // and information about the changed worksheet.
    await Excel.run(async (context) => {
        const protectionStatus = event.isProtected;
        const worksheetId = event.worksheetId;
        const source = event.source;
        console.log("Protection status changed. Protection status is now: " + protectionStatus + ".");
        console.log("    ID of changed worksheet: " + worksheetId + ".");
        console.log("    Source of change event: " + source + ".");
    });
}

onRowHiddenChanged

Se produce cuando el estado oculto de una o varias filas ha cambiado en una hoja de cálculo específica.

readonly onRowHiddenChanged: OfficeExtension.EventHandlers<Excel.WorksheetRowHiddenChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.11 ]

Ejemplos

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    sheet.onRowHiddenChanged.add(function (event) {
        return Excel.run(async (context) => {
            console.log(`Row ${event.address} is now ${event.changeType}`);
            await context.sync();
        });
    });
    await context.sync();
});

onRowSorted

Se produce cuando se han ordenado una o más filas. Esto sucede cuando se produce una operación de ordenación de arriba a abajo.

readonly onRowSorted: OfficeExtension.EventHandlers<Excel.WorksheetRowSortedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/event-column-and-row-sort.yaml

await Excel.run(async (context) => {
    console.log("Adding row handler");
    const sheet = context.workbook.worksheets.getActiveWorksheet();

    // This will fire whenever a row has been moved as the result of a sort action.
    sheet.onRowSorted.add((event) => {
        return Excel.run((context) => {
            console.log("Row sorted: " + event.address);
            const sheet = context.workbook.worksheets.getActiveWorksheet();

            // Clear formatting for section, then highlight the sorted area.
            sheet.getRange("A1:E5").format.fill.clear();
            if (event.address !== "") {
                sheet.getRanges(event.address).format.fill.color = "yellow";
            }

            return context.sync();
        });
    });
});

onSelectionChanged

Se produce cuando la selección cambia en una hoja de cálculo específica.

readonly onSelectionChanged: OfficeExtension.EventHandlers<Excel.WorksheetSelectionChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Ejemplos

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    sheet.onSelectionChanged.add(function (event) {
        return Excel.run(async (context) => {
            console.log("The selected range has changed to: " + event.address);
            await context.sync();
        });
    });
    await context.sync();
});

onSingleClicked

Se produce cuando se produce una acción de pulsar o hacer clic con el botón izquierdo en la hoja de cálculo. Este evento no se desencadenará al hacer clic en los casos siguientes:

  • El usuario arrastra el mouse para la selección múltiple.

  • El usuario selecciona una celda en el modo cuando se seleccionan argumentos de celda para las referencias de fórmula.

readonly onSingleClicked: OfficeExtension.EventHandlers<Excel.WorksheetSingleClickedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/event-worksheet-single-click.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    sheet.onSingleClicked.add((event) => {
        return Excel.run((context) => {
            console.log(`Click detected at ${event.address} (pixel offset from upper-left cell corner: ${event.offsetX}, ${event.offsetY})`);
            return context.sync();
        });
    });

    console.log("The worksheet click handler is registered.");

    await context.sync();
});

onVisibilityChanged

Se produce cuando se cambia la visibilidad de la hoja de cálculo.

readonly onVisibilityChanged: OfficeExtension.EventHandlers<Excel.WorksheetVisibilityChangedEventArgs>;

Tipo de evento

Comentarios

[ Conjunto de API: ExcelApi 1.17 ]