TXLSXImages é a coleção de imagens da folha de cálculo exposta por TXLSXWorksheet.Images , e cada TXLSXImage contém bytes da imagem, formato e geometria da âncora de desenho
Declarações
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;Membros principais
| Row and Col | Célula de ancoragem superior esquerda com índices baseados em um |
| WidthEMU and HeightEMU | Dimensões nativas do desenho em Unidades Métricas Inglesas |
| WidthInch, WidthCM and WidthPt | Visualizações geométricas práticas que atualizam as dimensões EMU subjacentes |
| AnchorType | Seleciona comportamento de mover e redimensionar com células, mover apenas ou desenho absoluto |
| CropLeft, CropTop, CropRight and CropBottom | Localiza a imagem ancorada em uma coordenada de célula baseada em um |
| Transparency | Transparência uniforme da imagem de 0 a 100 por cento |
| Brightness and Contrast | Ajustes de luminosidade de -100 a 100 por cento |
| Rotation | Rotação da forma no sentido dos ponteiros do relógio, em graus, limitada entre -360 e 360 |
| AltText | Texto alternativo de acessibilidade para a imagem, consumido por leitores de ecrã e ferramentas de apoio |
| AltTextTitle | Accessible title for the picture |
| FillMode | Estica a imagem uma vez ou repete-a em mosaico pela forma |
| HasPreservedXml and ClearPreservedXml | Inspeciona ou descarta o DrawingML importado seguro para edição de uma imagem |
| FindAt | Encontra a imagem ancorada numa coordenada de célula de base 1 |
Exemplo
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;
Veja também