Excel. Worksheet class

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.stringify`a 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

Excel.AutoFilter

Comentarios

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

Excel.ChartCollection

Comentarios

comments

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

readonly comments: Excel.CommentCollection;

Valor de propiedad

Excel.CommentCollection

Comentarios

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

Excel.RequestContext

customProperties

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

readonly customProperties: Excel.WorksheetCustomPropertyCollection;

Valor de propiedad

Excel.WorksheetCustomPropertyCollection

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

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

Excel.WorksheetFreezePanes

Comentarios

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

Excel.PageBreakCollection

Comentarios

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

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

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

Excel.NamedSheetViewCollection

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

Excel.NamedItemCollection

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

Excel.PageLayout

Comentarios

pivotTables

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

readonly pivotTables: Excel.PivotTableCollection;

Valor de propiedad

Excel.PivotTableCollection

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

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

Excel.WorksheetProtection

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

Excel.ShapeCollection

Comentarios

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

Excel.SlicerCollection

Comentarios

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

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

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

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

Excel.TableCollection

Comentarios

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

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

Excel.DocumentTaskCollection

Comentarios

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

Excel.PageBreakCollection

Comentarios

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

visibility

Visibilidad de la hoja de cálculo.

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

Valor de propiedad

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

Comentarios

Detalles del método

activate()

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

activate(): void;

Devoluciones

void

Comentarios

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

Excel.Worksheet

Hoja de cálculo recién creada.

Comentarios

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

Excel.Worksheet

Hoja de cálculo recién creada.

Comentarios

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

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

Excel.RangeAreas

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

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

Excel.RangeAreas

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

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

Excel.Range

Comentarios

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

Excel.Worksheet

Comentarios

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

Excel.Worksheet

Comentarios

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

Excel.Worksheet

Comentarios

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

Excel.Worksheet

Comentarios

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

Excel.Range

Comentarios

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

Excel.Range

Comentarios

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

Excel.RangeAreas

Comentarios

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

Excel.Range

Comentarios

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

Excel.Range

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

Excel.Worksheet

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

Excel.Worksheet

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

Excel.Worksheet

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

OfficeExtension.ClientResult<number>

Número de reemplazos realizados.

Comentarios

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

OfficeExtension.EventHandlers<Excel.WorksheetActivatedEventArgs>

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

Excel.Interfaces.WorksheetData

Detalles del evento

onActivated

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

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

Tipo de evento

Comentarios

OfficeExtension.EventHandlers<Excel.WorksheetCalculatedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetChangedEventArgs>

Comentarios

OfficeExtension.EventHandlers<Excel.WorksheetColumnSortedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetDeactivatedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetFilteredEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetFormatChangedEventArgs>

Comentarios

OfficeExtension.EventHandlers<Excel.WorksheetFormulaChangedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetNameChangedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetProtectionChangedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetRowHiddenChangedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetRowSortedEventArgs>

Comentarios

OfficeExtension.EventHandlers<Excel.WorksheetSelectionChangedEventArgs>

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

OfficeExtension.EventHandlers<Excel.WorksheetSingleClickedEventArgs>

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