Partekatu honen bidez:

Trabajar con notas mediante la API de JavaScript de Excel

En este artículo se describe cómo agregar, cambiar y quitar notas en un libro con la API de JavaScript de Excel. Puede obtener más información sobre las notas del artículo Insertar comentarios y notas en Excel . Para obtener información sobre las diferencias entre las notas y los comentarios, vea La diferencia entre los comentarios en subproceso y las notas.

Las notas están vinculadas a una celda individual. Cualquier persona que vea el libro con permisos suficientes puede ver una nota. La propiedad realiza un seguimiento de las Workbook.notes notas de un libro. Esto incluye notas creadas por los usuarios y también notas creadas por el complemento. La Workbook.notes propiedad es un objeto NoteCollection que contiene una colección de objetos Note . Las notas también son accesibles en el nivel hoja de cálculo .

Sugerencia

Para obtener información sobre cómo agregar y editar comentarios con la API de JavaScript de Excel, consulte Trabajar con comentarios mediante la API de JavaScript de Excel.

Agregar una nota

Use el NoteCollection.add método para agregar notas a un libro. Este método toma dos parámetros:

  • cellAddress: celda donde se agrega el comentario. Puede ser una cadena o un objeto Range . El rango debe ser una sola celda.
  • content: el contenido del comentario, como una cadena.

En el ejemplo de código siguiente se muestra cómo agregar una nota a la celda seleccionada en una hoja de cálculo.

await Excel.run(async (context) => {
    // This function adds a note to the selected cell.
    const selectedRange = context.workbook.getSelectedRange();

    // Note that an InvalidArgument error is thrown if multiple cells are selected.
    context.workbook.notes.add(selectedRange, "The first note.");
    await context.sync();
});

Cambiar la visibilidad de la nota

De forma predeterminada, el contenido de una nota está oculto a menos que un usuario mantenga el puntero sobre la celda con la nota o establezca el libro para mostrar las notas. Para mostrar una nota, use la propiedad Note.visible . En el ejemplo de código siguiente se muestra cómo cambiar la visibilidad de una nota.

await Excel.run(async (context) => {
    // This function sets the note on cell A1 to visible.
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const firstNote = sheet.notes.getItem("A1");

    firstNote.load();
    await context.sync();

    firstNote.visible = true;
});

Editar el contenido de una nota

Para editar el contenido de una nota, use la propiedad Note.content . En el ejemplo siguiente se muestra cómo cambiar el contenido de la primera nota de NoteCollection.

await Excel.run(async (context) => {
    // This function changes the content in the first note.
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const note = sheet.notes.getItemAt(0);

    note.content = "Changing the content of the first note.";
    await context.sync();
});

Nota:

Use la Note.authorName propiedad para obtener el autor de una nota. El nombre del autor es una propiedad de solo lectura.

Cambiar el tamaño de una nota

Para hacer que las notas sean más grandes o más pequeñas, use las propiedades Note.height y Note.width .

En el ejemplo siguiente se muestra cómo establecer el tamaño de la primera nota en .NoteCollection

await Excel.run(async (context) => {
    // This function changes the height and width of the first note.
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const note = sheet.notes.getItemAt(0);

    note.width = 400;
    note.height = 200;    

    await context.sync();
});

Eliminación de una nota

Para eliminar una nota, use el método Note.delete . En el ejemplo siguiente se muestra cómo eliminar la nota adjunta a la celda A2.

await Excel.run(async (context) => {
    // This function deletes the note from cell A2.
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const note = sheet.notes.getItem("A2");

    note.delete();
    await context.sync();
});

Vea también

  • Last updated on