Sideobjekt-redigeringstransaktioner

Komponent: TPdf · Enhed: PDFium

Samler native sideobjekt-mutationer i én atomar side-afgrænset operation

Syntax

procedure BeginPageObjectEditTransaction(AllowSignedDocument: Boolean = False);
function CommitPageObjectEditTransaction: Boolean;
procedure RollbackPageObjectEditTransaction;
property PageObjectEditTransactionStatus: TPdfPageObjectEditTransactionStatus;

Description

BeginPageObjectEditTransaction gemmer et afgrænset, reproducerbart snapshot af det aktive dokument og binder transaktionen til den aktuelle side

Sideobjekt-insert-, remove-, transform-, egenskabs-, content-mark-, annotationsobjekt- og annotationsudseende-mutationer forbliver native PDFium-operationer, mens content-genereringen er udskudt

CommitPageObjectEditTransaction kalder FPDFPage_GenerateContent én gang, når mindst én mutation lykkedes, og returnerer True, eller returnerer False uden generering for en no-op-transaktion

RollbackPageObjectEditTransaction gendanner det validerede baseline-snapshot uden at serialisere de udskudte mutationer

Status

TPdfPageObjectEditTransactionStatus rapporterer Active, Dirty, det én-baserede PageNumber, successfulde MutationCount og ContentGenerationCount

De endelige mutations- og genereringstællere forbliver tilgængelige efter commit til diagnostik

Failure behaviour

Ved fejl i commit-genereringen genindlæses baseline-snapshotet, før fejlen kastes igen
Gemning, genindlæsning, sletning eller skift af den aktive side afvises, mens transaktionen er aktiv
Sideobjekt- og dokument-redigeringstransaktioner kan ikke indlejres i nogen af retningerne
Signede dokumenter kræver eksplicit AllowSignedDocument-godkendelse
Baseline-snapshotet skal være inden for TPdfEditJournalOptions.MaxSnapshotBytes

Example

Pdf.BeginPageObjectEditTransaction;
try
  Pdf.TransformPageObject(0, Matrix);
  Pdf.SetPageObjectMarkParam(0, 0, Param);
  Pdf.CommitPageObjectEditTransaction;
except
  if Pdf.PageObjectEditTransactionStatus.Active then
    Pdf.RollbackPageObjectEditTransaction;
  raise;
end;