THPDFWindowsFormDataTransaction.RemoveAnnotations method

procedure RemoveAnnotations(
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions;
  const Password: AnsiString);

Bereidt één removal-candidate voor via de native geauthenticeerde engine zonder het borrowed THotPDF-document van de transactie te muteren

De transactie moet zijn geconstrueerd met de echte originele bron die hoort bij het geladen document en met het wachtwoord dat nodig is om versleutelde invoer te authenticeren

ChangedAnnotations rapporteert het aantal verwijderd, inclusief cascade-afhankelijkheden; de teller gebruikt de bestaande prepared-change-opslag van de transactie

Na voorbereiding kopieert WritePreparedPDF de begrensde candidate naar een destination-stream; roep TakeCandidate pas aan nadat elke vereiste PDF- en resultaatpublicatie is geslaagd

TakeCandidate draagt het nieuwe THotPDF en diens eigenende THPDFWindowsFormDataSource over; destroy het document vóór diens source

Falen of annulering betekent de transactie weggooien en het borrowed document en de bron behouden; een transactie die al een candidate heeft voorbereid, weigert nog een voorbereiding

Bij nul verwijderingen is de uitvoer de exacte huidige prepared revisie, inclusief pending loaded-document-status die de transactie representeert; het is niet noodzakelijk het originele schijfbestand als de caller unsaved wijzigingen had

Limieten en identiteit

Pagina- en naamselectie, dependency-cascades, ambiguïteitschecks en de Widget-grens volgen native annotatieverwijdering

Een expliciet geleverd cancellation-token moet het token van de transactie zijn; de transactie klemt MaxWorkingBytes af op de helft van diens working capacity en MaxAnnotations op diens objectcapaciteit

De methode handhaaft positieve-capaciteitschecks, versleutelde annotation-permissions en geauthenticeerde signature-policy-toelating; het wachtwoord is geen authorisatie-omzeiling

Zie gewone Windows-verwijdering en THPDFWindowsFormDataTransaction voor eigendoms- en levenscyclusdetails