TXLSXImages is the worksheet image collection exposed by TXLSXWorksheet.Images e each TXLSXImage carries image bytes, format e drawing anchor geometry
Declarations
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;Key members
| Row and Col | One-based top-left anchor cell |
| WidthEMU and HeightEMU | Native drawing dimensions in English Metric Units |
| WidthInch, WidthCM and WidthPt | Convenience geometry views that update the underlying EMU dimensions |
| AnchorType | Selects move e size with cells, move only, o absolute drawing behaviour |
| CropLeft, CropTop, CropRight and CropBottom | Trova l'immagine ancorata alla coordinata di una cella in base 1 |
| Transparency | Trasparenza uniforme dell'immagine da 0 a 100 percento |
| Brightness and Contrast | Regolazioni di luminosità da -100 a 100 percento |
| Rotation | Rotazione della forma in senso orario, in gradi, limitata all'intervallo da -360 a 360 |
| AltText | Testo alternativo di accessibilità per l'immagine, usato da screen reader e strumenti assistivi |
| AltTextTitle | Accessible title for the picture |
| FillMode | Stira l'immagine una volta sola o la ripete a mosaico sulla forma |
| HasPreservedXml and ClearPreservedXml | Ispeziona o scarta il DrawingML importato, a prova di modifica, per una singola immagine |
| FindAt | Trova l'immagine ancorata alla coordinata di una cella in base 1 |
Esempio
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;
Vedere also