Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
Ajustar una imagen exactamente a una sola celda es un requisito común al diseñar hojas de cálculo que funcionan como informes visuales, catálogos de productos, directorios de empleados, paneles de control o listas de inventario. En lugar de estirar una imagen por muchas celdas o colocarla sin precisión en una hoja de cálculo, es posible que necesite una imagen limpia y vinculada a la celda que permanezca alineada con la celda propietaria. Aspose.Cells admite este escenario de dos formas complementarias:
Picture a la hoja de cálculo, defina su Placement en MOVE_AND_SIZE y ajuste sus celdas de anclaje (getUpperLeftRow, getUpperLeftColumn, getLowerRightRow, getLowerRightColumn) para que la imagen cubra exactamente una celda.getEmbeddedImage() de la celda. La imagen se escala automáticamente para ajustarse al área de visualización de la celda y se mueve con ella.
El resto de este artículo explica ambos enfoques, describe las API pertinentes y muestra cómo utilizarlas en código.Una imagen flotante es un objeto Picture que reside en la capa de dibujo de la hoja de cálculo. Aunque no forma parte de ninguna celda concreta, se ancla a un rango de celdas. Las celdas de anclaje de la imagen, es decir, sus esquinas superior izquierda e inferior derecha, determinan su extensión visual en la hoja de cálculo. De forma predeterminada, una imagen recién agregada se extiende por varias celdas.
Para hacer que una imagen flotante cubra exactamente una celda, debe:
Worksheet.getPictures().add(int row, int column, InputStream stream), que ancla la nueva imagen a la celda indicada.Picture.setPlacement() en PlacementType.MOVE_AND_SIZE para que la imagen se mueva y cambie de tamaño junto con la celda subyacente cuando el usuario cambie el ancho de la columna o la altura de la fila.El anclaje de la imagen se define mediante cuatro propiedades de índice con base cero:
Picture.getUpperLeftRow(): el índice de fila del borde superior de la imagen.Picture.getUpperLeftColumn(): el índice de columna del borde izquierdo de la imagen.Picture.getLowerRightRow(): el índice de fila del borde inferior de la imagen. Para que el borde inferior de la imagen quede en la parte inferior de la fila r, establezca este valor en r + 1.Picture.getLowerRightColumn(): el índice de columna del borde derecho de la imagen. Para que el borde derecho de la imagen quede en el extremo derecho de la columna c, establezca este valor en c + 1.Picture.getPlacement() devuelve un valor de enumeración de tipo PlacementType que controla cómo se comporta la imagen cuando el usuario cambia el tamaño de la fila o columna subyacente. El valor recomendado para una imagen ajustada a una sola celda es PlacementType.MOVE_AND_SIZE, que hace que la imagen se mueva y cambie de tamaño junto con la celda subyacente, manteniendo el ajuste exacto.
Workbook o abra uno existente.Worksheet de destino mediante workbook.getWorksheets().get(0).InputStream, como FileInputStream, mediante un bloque try-with-resources para que el flujo se cierre correctamente.worksheet.getPictures().add(5, 2, stream) para agregar una imagen anclada a la celda C6. Conserve la referencia Picture devuelta.setUpperLeftRow(5), setUpperLeftColumn(2), setLowerRightRow(6), setLowerRightColumn(3).picture.setPlacement(PlacementType.MOVE_AND_SIZE) para mantener la imagen alineada con C6 cuando se cambie el tamaño de la columna o de la fila.Workbook en el disco como un archivo .xlsx.
El siguiente código demuestra el enfoque completo.import com.aspose.cells.*;
import java.io.FileInputStream;
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
try (FileInputStream fs = new FileInputStream("logo.png"))
{
int picIndex = worksheet.getPictures().add(5, 2, fs);
Picture picture = worksheet.getPictures().get(picIndex);
picture.setUpperLeftRow(5);
picture.setUpperLeftColumn(2);
picture.setLowerRightRow(6);
picture.setLowerRightColumn(3);
picture.setPlacement(PlacementType.MOVE_AND_SIZE);
}
workbook.save("output.xlsx", SaveFormat.XLSX);
Aspose.Cells también ofrece un mecanismo más sencillo para imágenes vinculadas a celdas: el método Cell.setEmbeddedImage(byte[]). Al asignar los bytes de la imagen a esta propiedad, la imagen se adjunta a la propia celda como si fuera contenido insertado en línea.
setEmbeddedImage() sea la opción más concisa cuando el objetivo es simplemente «una imagen que reside dentro de esta celda».Workbook o abra uno existente.Worksheet de destino mediante workbook.getWorksheets().get(0).byte[], por ejemplo, leyendo el archivo mediante Files.readAllBytes() desde java.nio.file.worksheet.getCells().get("C6") o worksheet.getCells().get(5, 2).cell.setEmbeddedImage(bytes).Workbook en el disco como un archivo .xlsx.
El siguiente código demuestra el enfoque completo.import com.aspose.cells.*;
import java.nio.file.Files;
import java.nio.file.Paths;
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
// Obtener la celda objetivo C6
Cell cell = worksheet.getCells().get("C6");
// Leer el archivo de imagen en un array de bytes
byte[] imageData = Files.readAllBytes(Paths.get("logo.png"));
// Incrustar la imagen directamente en la celda
cell.setEmbeddedImage(imageData);
// Opcionalmente, ajustar el alto de la fila y el ancho de la columna para que la imagen incrustada sea más visible
worksheet.getCells().setColumnWidth(2, 30); // Columna C (índice 2)
worksheet.getCells().setRowHeight(5, 100); // Fila 6 (índice 5)
// Guardar el libro de trabajo resultante como un archivo .xlsx
workbook.save("output.xlsx", SaveFormat.XLSX);
Ambos enfoques producen una imagen que se ajusta a una sola celda, pero difieren en cómo se almacena y se comporta:
PictureCollection.Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.