THPDFLoadedPageRenderSession Class

Uchováva stav vykresľovania stránky a živú čiastočnú bitmapu, aby sa načítaná stránka dala vykresliť vo viacerých ohraničených volaniach

Deklarácia

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;

Jednotka

HPDFDoc

Hodnoty stavu

• prsReady znamená, že stránka je inicializovaná a žiadny operátor obsahu sa nevykonal
• prsPaused znamená, že rozpočet sa skončil pred dokončením všetkých operátorov
• prsCompleted znamená, že je k dispozícii kompletná bitmapa stránky
• prsCancelled znamená, že spätné volanie alebo token zastavil reláciu na hranici operátora

Poznámky k použitiu

• Ktorýkoľvek rozpočet môže byť nula pre neobmedzenú prácu, zatiaľ čo obe nulové hodnoty prebehnú do konečného stavu v jednom volaní
• Bitmap zostáva vo vlastníctve relácie a je určený na prístup len na čítanie v náhľade
• TakeBitmap je platné len v konečnom stave a prenáša vlastníctvo na volajúceho
• ProgressiveJPEGScansDecoded a ProgressiveJPEGImagesDecoded počítajú úspešnú inkrementálnu prácu s obrázkami, zatiaľ čo OnProgressiveJPEGScan môže zrušiť po viditeľnom skene
• IsRegionRender identifikuje relácie ROI; vlastnosti regiónu zachovávajú požadované hranice v užívateľskom priestore a viditeľné a vyradené počítadlá opisujú výber kresliacich objektov zoznamu zobrazenia
• Načítaná inštancia THotPDF a token zrušenia musia zostať nažive, kým sa relácia neuvoľní

Súvisiace API

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Progresívne vykresľovanie a zrušenie