Documentación HotXLS

Clases TXLSXImage y TXLSXImages

TXLSXImages es la colección de imágenes de hoja expuesta por TXLSXWorksheet.Images, y cada TXLSXImage contiene los bytes de imagen, el formato y la geometría del anclaje de dibujo

Declaraciones

type
  TXLSXImageFillMode = (xlsxImageFillStretch, xlsxImageFillTile);

  TXLSXImage = class
    procedure Assign(Source: TXLSXImage);
    procedure Scale(APercent: Double; AKeepAspect: Boolean = True);
    procedure ClearPreservedXml;
    property Row, Col: Integer;
    property WidthEMU, HeightEMU: Integer;
    property WidthInch, HeightInch: Double;
    property WidthCM, HeightCM: Double;
    property WidthPt, HeightPt: Double;
    property Format: TXLSXImageFormat;
    property Data: AnsiString;
    property AnchorType: TXLSXAnchorEditAs;
    property CropLeft, CropTop, CropRight, CropBottom: Double;
    property Transparency, Brightness, Contrast: Double;
    property Rotation: Double;
    property AltText: WideString;
    property AltTextTitle: WideString;
    property FillMode: TXLSXImageFillMode;
    property HasPreservedXml: Boolean;
  end;

  TXLSXImages = class
    function Add: TXLSXImage; overload;
    function Add(Source: TXLSXImage): Integer; overload;
    function FindAt(ARow, ACol: Integer): TXLSXImage;
    function DeleteAt(ARow, ACol: Integer): Boolean;
    function DeleteInRange(ARow1, ACol1, ARow2, ACol2: Integer): Integer;
    property Items[Index: Integer]: TXLSXImage; default;
  end;

Miembros principales

Row and ColCelda de anclaje superior izquierda con índices basados en uno
WidthEMU and HeightEMUDimensiones nativas del dibujo en unidades métricas inglesas
WidthInch, WidthCM and WidthPtVistas geométricas prácticas que actualizan las dimensiones EMU subyacentes
AnchorTypeSelecciona comportamiento de mover y cambiar tamaño con celdas, solo mover o dibujo absoluto
CropLeft, CropTop, CropRight and CropBottomBordes de recorte de la imagen de origen como porcentajes de 0 a 100
TransparencyTransparencia uniforme de la imagen de 0 a 100 por ciento
Brightness and ContrastAjustes de luminosidad de -100 a 100 por ciento
RotationRotación de la forma en grados en sentido horario, acotada a -360 through 360
AltTextTexto alternativo de accesibilidad para la imagen, consumido por lectores de pantalla y herramientas de asistencia
AltTextTitleTítulo accesible para la imagen
FillModeEstira la imagen una vez o la repite en mosaico sobre la forma
HasPreservedXml and ClearPreservedXmlInspecciona o descarta el DrawingML importado seguro para ediciones de una imagen
FindAtEncuentra la imagen anclada en una coordenada de celda basada en uno

Ejemplo

var Image: TXLSXImage;
begin
  Image := Sheet.Images.Add;
  Image.Row := 2;
  Image.Col := 4;
  Image.Data := PngBytes;
  Image.Format := xlsxImagePng;
  Image.WidthCM := 6;
  Image.AnchorType := xaOneCell;
  Image.CropLeft := 12.5;
  Image.Transparency := 20;
  Image.Brightness := 10;
  Image.Contrast := -5;
  Image.FillMode := xlsxImageFillStretch;
  Image.Rotation := 15;
end;

Véase también