CellPicture

Class CellPicture

java.lang.Object

com.grapecity.documents.excel.CellPicture

---

public class CellPicture extends Object

表示嵌入在单元格中的图片（单元格内图片）。

示例：

 Workbook workbook = new Workbook();
 IWorksheet worksheet = workbook.getActiveSheet();
 byte[] imageBytes = java.util.Base64.getDecoder().decode(
         "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aF9sAAAAASUVORK5CYII=");
 CellPicture picture = new CellPicture(imageBytes, "Company logo");
 worksheet.getRange("A1").setCellPicture(picture);
 CellPicture savedPicture = worksheet.getRange("A1").getCellPicture();
 String altText = savedPicture.getAltText();
 

• Constructor Summary

  Constructors

  Constructor

  Description

  CellPicture(byte[] imageData)

  使用指定的图像数据初始化 CellPicture 类的新实例。传入的数组将被复制，因此对原始数组的后续修改不会影响该实例。

  CellPicture(byte[] imageData, String altText)

  使用指定的图像数据和替换文字初始化 CellPicture 类的新实例。传入的数组将被复制，因此对原始数组的后续修改不会影响该实例。

• Method Summary

  All MethodsInstance MethodsConcrete Methods

  Modifier and Type

  Method

  Description

  String

  getAltText()

  获取图片的替代文本。替代文本也用作筛选和排序的显示值。

  byte[]

  getImageData()

  获取图像二进制数据的副本。

  void

  setAltText(String altText)

  设置图片的替代文本。修改后必须通过 IRange.setCellPicture(CellPicture) 重新设置，修改才会生效。

  Methods inherited from class java.lang.Object

  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Constructor Details

  • CellPicture

    public CellPicture(byte[] imageData)

    使用指定的图像数据初始化 CellPicture 类的新实例。传入的数组将被复制，因此对原始数组的后续修改不会影响该实例。

    Parameters:

    imageData - 图像二进制数据。支持的类型：PNG、JPG、GIF、BMP、SVG。

  • CellPicture

    public CellPicture(byte[] imageData, String altText)

    使用指定的图像数据和替换文字初始化 CellPicture 类的新实例。传入的数组将被复制，因此对原始数组的后续修改不会影响该实例。

    Parameters:

    imageData - 图像二进制数据。支持的类型：PNG、JPG、GIF、BMP、SVG。

    altText - 图片的替换文字。

• Method Details

  • getImageData

    public byte[] getImageData()

    获取图像二进制数据的副本。

    
     byte[] imageBytes = java.util.Base64.getDecoder().decode(
             "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aF9sAAAAASUVORK5CYII=");
     worksheet.getRange("A1").setCellPicture(new CellPicture(imageBytes, "Company logo"));
     CellPicture picture = worksheet.getRange("A1").getCellPicture();
     byte[] copiedImageData = picture.getImageData();
     

    Returns:

    图像二进制数据的副本；如果不存在图像数据，则为 null。修改返回的数组不会影响此 CellPicture 中存储的数据。

  • getAltText

    public String getAltText()

    获取图片的替代文本。替代文本也用作筛选和排序的显示值。

    
     byte[] imageBytes = java.util.Base64.getDecoder().decode(
             "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aF9sAAAAASUVORK5CYII=");
     worksheet.getRange("A1").setCellPicture(new CellPicture(imageBytes, "Company logo"));
     CellPicture picture = worksheet.getRange("A1").getCellPicture();
     String altText = picture.getAltText();
     

    Returns:

    图片的替代文本。

  • setAltText

    public void setAltText(String altText)

    设置图片的替代文本。修改后必须通过 IRange.setCellPicture(CellPicture) 重新设置，修改才会生效。

    
     java.util.function.Supplier<byte[]> imageDataProvider = () -> java.util.Base64.getDecoder().decode(
             "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aF9sAAAAASUVORK5CYII=");
     byte[] imageBytes = imageDataProvider.get();
     CellPicture picture = new CellPicture(imageBytes);
     picture.setAltText("Company logo");
     worksheet.getRange("A1").setCellPicture(picture);
     

    Parameters:

    altText - 图片的替代文本。