Excel Camera en Aspose.Cells for Java

Excel Camera es un objeto de hoja de cálculo que renderiza una imagen en vivo de un rango de celdas y flota sobre la capa de dibujo como una imagen ordinaria. Aspose.Cells admite dos modos de creación, una imagen dinámica que se actualiza automáticamente cada vez que cambian los datos de origen y una imagen estática que captura una instantánea única de un rango. Este artículo recorre ambos enfoques para que pueda elegir el que se adapte a su diseño.

¿Qué es Excel Camera?

Excel Camera es esencialmente un objeto de imagen anclado a una fila y columna específicas en la capa de dibujo de la hoja de cálculo. A diferencia de una imagen insertada regular, la Cámara está vinculada a un rango de origen mediante una fórmula estilo A1 como "A1:F10". Cada vez que cualquier celda dentro de ese rango cambia, la imagen de la Cámara se actualiza automáticamente para reflejar el nuevo contenido. La Cámara conserva el formato completo del área de origen — bordes, colores de fondo, fuentes y formatos de número — por lo que todo lo visible dentro de las celdas aparece también dentro de la imagen de la Cámara. Esto hace que la Cámara sea especialmente útil para paneles, resúmenes, paneles laterales y diseños de informes donde se desea una vista previa visible de una región remota sin desplazarse ni repetir datos. Se aplican dos advertencias: debe llamar a updateSelectedValue() antes de guardar el libro y el archivo se exportará a HTML o PDF, ya que esos formatos dependen de los datos de imagen incrustados en lugar de un recálculo en vivo.

Método 1 — Agregar una imagen de Cámara dinámica

La Cámara dinámica es el enfoque más común y es la coincidencia más cercana a la herramienta Cámara integrada de Excel. Funciona agregando una imagen sin contenido de imagen inicial y luego asignándole un Formula que hace referencia al rango de origen. Después de asignar la fórmula, llamar a updateSelectedValue() actualiza los datos de imagen incrustados para que estén sincronizados con las celdas que refleja. La Cámara no se implementa a través de una clase dedicada — se construye completamente sobre el tipo Picture estándar. Las API clave son:

  • PictureCollection.add(int upperLeftRow, int upperLeftColumn, InputStream stream) — agrega una imagen anclada en la fila y columna dadas. Pasar null para el parámetro stream crea una imagen vacía que actúa como el marcador de posición para una Cámara dinámica. El método devuelve el índice de la nueva imagen.
  • worksheet.getPictures().get(index) — acceso por índice para recuperar un Picture específico de la colección.
  • Picture.setFormula(String value) — establece la referencia estilo A1 al rango de origen que refleja la Cámara, como "A1:F10".
  • Picture.updateSelectedValue() — un método void que actualiza los datos de imagen incrustados desde las celdas referenciadas por Formula.

El siguiente código crea un libro, agrega una imagen vacía anclada en la fila 10 columna 6, la vincula al rango de origen A1:F10 mediante setFormula, actualiza los datos de imagen incrustados y guarda el libro.

import java.io.InputStream;
import com.aspose.cells.PictureCollection;
import com.aspose.cells.SaveFormat;
import com.aspose.cells.Workbook;
import com.aspose.cells.Worksheet;
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
worksheet.setName("CameraDemo");
// Dynamic Camera: add an empty picture, link it via Formula to A1:F10, then refresh
PictureCollection pictures = worksheet.getPictures();
int index = pictures.add(10, 6, (InputStream) null);
pictures.get(index).setFormula("A1:F10");
pictures.get(index).updateSelectedValue();
workbook.save("output_dynamic.xlsx", SaveFormat.XLSX);

Método 2 — Agregar una imagen de Cámara estática

La Cámara estática es esencialmente una vista previa renderizada de una sola vez de un rango de celdas. En lugar de mantener un enlace en vivo, renderiza el rango a bytes de imagen una vez, envuelve esos bytes en un ByteArrayInputStream y los agrega como una imagen regular. El contenido de la imagen queda fijo en el momento de la creación y no se actualiza automáticamente cuando cambian las celdas de origen. Las API clave son:

  • Cells.createRange(String address) — construye un objeto Range a partir de una dirección estilo A1 como "A1:F10".
  • Range.toImage(ImageOrPrintOptions options) — renderiza el rango a bytes de imagen. Pasar null usa las opciones de renderizado predeterminadas; existen sobrecargas para un control más fino sobre la salida.
  • new ByteArrayInputStream(byte[] buffer) — envuelve los bytes de imagen renderizados en un ByteArrayInputStream que se puede alimentar a PictureCollection.add.
  • PictureCollection.add(int upperLeftRow, int upperLeftColumn, InputStream stream) — agrega la imagen anclada en la fila y columna dadas, esta vez pasando el ByteArrayInputStream producido por el renderizado. El siguiente código crea un libro, construye un Range para A1:F10, lo renderiza a bytes de imagen mediante Range.toImage(null), envuelve los bytes en un ByteArrayInputStream, agrega la imagen anclada en la fila 10 columna 6 y guarda el libro.
import java.io.ByteArrayInputStream;
import com.aspose.cells.PictureCollection;
import com.aspose.cells.Range;
import com.aspose.cells.SaveFormat;
import com.aspose.cells.Workbook;
import com.aspose.cells.Worksheet;
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
worksheet.setName("CameraDemo");
// Cámara Estática: construir Rango, renderizar a bytes, envolver en ByteArrayInputStream, agregar como imagen
Range range = worksheet.getCells().createRange("A1:F10");
PictureCollection pictures = worksheet.getPictures();
pictures.add(10, 6, new ByteArrayInputStream(range.toImage(null)));
workbook.save("output_static.xlsx", SaveFormat.XLSX);

Elegir entre dinámico y estático

  • Cámara dinámica: se actualiza en cada recálculo, admite exportación a HTML y PDF después de updateSelectedValue() y conserva el comportamiento de enlace en vivo durante toda la vida útil del archivo.
  • Cámara estática: un renderizado de una sola vez que nunca se actualiza, útil cuando se desea una instantánea visual fija incrustada en tiempo de compilación en lugar de un espejo en vivo de los datos. Aspose.Cells admite tanto una Cámara dinámica y autoactualizable basada en Picture.Formula más updateSelectedValue() como una Cámara estática de una sola vez basada en Range.toImage más un ByteArrayInputStream. Elija el enfoque dinámico cuando su salida necesite mantenerse sincronizada con las celdas de origen, y elija el enfoque estático cuando solo necesite una instantánea visual fija en tiempo de compilación.

Artículos relacionados

Gestión de objetos OLE Gestionar SmartArt