HotXLS-documentatie

TXLSXImage en TXLSXImages classes

TXLSXImages is de afbeeldingencollectie van het werkblad, beschikbaar gesteld via TXLSXWorksheet.Images , en elke TXLSXImage draagt afbeeldingsbytes, indeling, ankergeometrie, uitsnede, beeldaanpassingen, vulmodus, rotatie en bewerkingsveilige geïmporteerde DrawingML

Declaraties

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;

Belangrijkste members

Row and ColCel met de ankerpunt linksboven, op 1 gebaseerd
WidthEMU and HeightEMUNative afmetingen van de tekening in English Metric Units
WidthInch, WidthCM and WidthPtHandige geometrieviews die de onderliggende EMU-afmetingen bijwerken
AnchorTypeKiest voor verplaatsen en schalen met cellen, alleen verplaatsen, of absolute plaatsing van de tekening
CropLeft, CropTop, CropRight and CropBottomUitsnijdranden van de bronafbeelding als percentage van 0 tot 100
TransparencyUniforme transparantie van de afbeelding van 0 tot 100 procent
Brightness and ContrastAanpassingen van de luminantie van -100 tot 100 procent
RotationRotatie van de shape met de klok mee in graden, begrensd op -360 tot 360
AltTextAlt-tekst voor toegankelijkheid bij de afbeelding, gelezen door schermlezers en hulpmiddelen
AltTextTitleToegankelijke titel voor de afbeelding
FillModeRekt de afbeelding één keer uit of tegelt die over de shape
HasPreservedXml and ClearPreservedXmlBekijk of verwijder bewerkingsveilige geïmporteerde DrawingML voor één afbeelding
FindAtZoekt de afbeelding die verankerd is op een op 1 gebaseerde celcoördinaat

Voorbeeld

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;

Zie ook