THPDFLoadedPageRenderSession Class

Behält den Seitenrender-Zustand und ein lebendiges Teil-Bitmap bei, sodass eine geladene Seite über mehrere begrenzte Aufrufe gerendert werden kann

Deklaration

THPDFLoadedPageRenderSession = class(TObject)
public
  function ContinueRender(MaxMilliseconds: Cardinal = 0;
    MaxObjects: Integer = 0): THPDFProgressiveRenderStatus;
  function TakeBitmap: TBitmap;
  property Bitmap: TBitmap read GetBitmap;
  property ObjectsProcessed: Integer read GetObjectsProcessed;
  property TotalObjects: Integer read GetTotalObjects;
  property ProgressiveJPEGScansDecoded: Integer
    read GetProgressiveJPEGScansDecoded;
  property ProgressiveJPEGImagesDecoded: Integer
    read GetProgressiveJPEGImagesDecoded;
  property Status: THPDFProgressiveRenderStatus read GetStatus;
  property IsRegionRender: Boolean read FIsRegionRender;
  property RegionLeft: Single read FRegionLeft;
  property RegionBottom: Single read FRegionBottom;
  property RegionRight: Single read FRegionRight;
  property RegionTop: Single read FRegionTop;
  property RegionVisiblePaintObjects: Integer
    read GetRegionVisiblePaintObjects;
  property RegionCulledPaintObjects: Integer
    read GetRegionCulledPaintObjects;
  property OnProgress: THPDFProgressiveRenderProgressEvent
    read FOnProgress write SetOnProgress;
  property OnProgressiveJPEGScan: THPDFProgressiveJPEGScanEvent
    read FOnProgressiveJPEGScan write SetOnProgressiveJPEGScan;
end;

Unit

HPDFDoc

Statuswerte

• prsReady bedeutet, dass die Seite initialisiert ist und noch kein Inhaltsoperator ausgeführt wurde
• prsPaused bedeutet, dass ein Budget endete, bevor alle Operatoren abgeschlossen waren
• prsCompleted bedeutet, dass das vollständige Seiten-Bitmap verfügbar ist
• prsCancelled bedeutet, dass der Callback oder Token die Sitzung an einer Operatorgrenze gestoppt hat

Verwendungshinweise

• Beide Budgets können null sein, um unbegrenzte Arbeit zu erlauben, während zwei Nullwerte in einem Aufruf bis zu einem Endzustand laufen
• Bitmap bleibt im Besitz der Sitzung und ist für den schreibgeschützten Vorschaugriff gedacht
• TakeBitmap ist nur in einem Endzustand gültig und überträgt den Besitz an den Aufrufer
• ProgressiveJPEGScansDecoded und ProgressiveJPEGImagesDecoded zählen erfolgreiche inkrementelle Bildarbeit, während OnProgressiveJPEGScan nach einem sichtbaren Scan abbrechen kann
• IsRegionRender kennzeichnet ROI-Sitzungen; die Regions-Eigenschaften behalten die gewünschten Benutzerraumgrenzen bei, und die sichtbaren und ausgeblendeten Zähler beschreiben die Auswahl der Display-List-Zeichenobjekte
• Die geladene Instanz THotPDF und der Abbruch-Token müssen am Leben bleiben, bis die Sitzung freigegeben wird

Verwandte APIs

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Progressives Rendern und Abbrechen