TXLSXImages je kolekce obrázků vystavená přes TXLSXWorksheet.Images a každá TXLSXImage představuje jeden obrázek ukotvený k buňkám
Deklarace
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;Klíčové členy
| Row and Col | Ukotvovací buňka vlevo nahoře, indexovaná od 1 |
| WidthEMU and HeightEMU | Nativní rozměry kresby v English Metric Units |
| WidthInch, WidthCM and WidthPt | Pohodlné pohledy na geometrii, které aktualizují podkladové rozměry EMU |
| AnchorType | Vybere chování kresby move and size with cells, move only nebo absolute |
| CropLeft, CropTop, CropRight and CropBottom | Hrany ořezu zdrojového obrázku jako procenta 0 až 100 |
| Transparency | Jednotná průhlednost obrázku 0 až 100 procent |
| Brightness and Contrast | Úpravy jasu od -100 do 100 procent |
| Rotation | Rotace tvaru ve stupních po směru hodinových ručiček, oříznutá na -360 až 360 |
| AltText | Alternativní text obrázku pro přístupnost, konzumovaný čtečkami obrazovky a asistivními nástroji |
| AltTextTitle | Přístupný titulek obrázku |
| FillMode | Obrázek jednou roztáhne, nebo ho dláždit přes tvar |
| HasPreservedXml and ClearPreservedXml | Prohlédne či zahodí editačně bezpečný importovaný DrawingML jednoho obrázku |
| FindAt | Najde obrázek ukotvený na 1-based souřadnici buňky |
Příklad
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;
Viz také