RenderPageThumbnail - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Rendert eine beliebige 1-basierte Seite in eine Bitmap, die innerhalb der angeforderten Thumbnail-Grenzen bleibt

Syntax

function RenderPageThumbnail(PageIndex, MaxWidth, MaxHeight: Integer): TBitmap;

function RenderPageThumbnail(PageIndex, MaxWidth, MaxHeight: Integer; Rotation: TRotation; Options: TRenderOptions; Background: TColor; const ColorScheme: TPdfColorScheme): TBitmap;

Parameter

PageIndex	`Integer` - 1-basierter Seitenindex der zu rendernden Seite
MaxWidth	`Integer` - Maximale Thumbnail-Breite in Pixeln
MaxHeight	`Integer` - Maximale Thumbnail-Höhe in Pixeln
Rotation	`TRotation` - Zusätzliche Drehung im Uhrzeigersinn beim Rendern
Options	`TRenderOptions` - Native PDFium-Render-Flags, die im Cache-Schlüssel enthalten sind
Background	`TColor` - Hintergrundfarbe der Bitmap
ColorScheme	`TPdfColorScheme` - Optionale Farb-Overrides für Pfad und Text im Modus für Sehbehinderung

Rückgabewert

Eine vom Aufrufer verwaltete TBitmap, oder nil, wenn das Dokument inaktiv, der Seitenindex ungültig oder die angeforderte Größe nicht positiv ist

Beschreibung

Die kurze Überladung wahrt das Seiten-Seitenverhältnis und rendert auf weißem Hintergrund, während die vollständige Überladung Rotation, Flags, Hintergrund und Farben für Sehbehinderung steuert

Beide Überladungen nutzen tiefe interne Bitmap-Kopien über die gemeinsame Thumbnail-LRU und geben bei jedem Aufruf eine eigene, vom Aufrufer verwaltete TBitmap zurück

Sie ändert nicht PageNumber, ersetzt nicht die aktuell geladene Seite und löst keine Benachrichtigungen über Seitenwechsel aus

Hinweise

API-Namen, Typnamen, Dateinamen und PDF-Begriffe behalten ihre ursprüngliche Schreibweise, damit die Codesuche zuverlässig bleibt
Verwenden Sie dies für Thumbnail-Leisten oder Navigationspanels, die den Bearbeitungszustand der Haupt-TPdf-Instanz nicht stören dürfen

Beispiel

Bmp := Pdf1.RenderPageThumbnail(3, 180, 240);
try
  if Bmp <> nil then
    Image1.Picture.Assign(Bmp);
finally
  Bmp.Free;
end;

Siehe auch

TPdf.RenderPage, TPdf.Thumbnail, Thumbnail cache, TPdf.PageCount

RenderPageThumbnail Methode