Borttagning av native-annoteringar

Ta bort befintliga sidannoteringar via deras nollbaserade sidindex och exakta Unicode-NM-värde, medan den ursprungliga PDF-revisionen behålls och en separat inkrementell utdata förbereds

Den nativa ingångspunkten är THPDFHeadlessDocument.SaveAnnotationRemovalsToFile; ordinära Windows-dokument använder THPDFWindowsFormDataTransaction.RemoveAnnotations

Identitet och beroenden

Varje identitet innehåller ett giltigt sidindex och ett icke-tomt namn; matchningen är skiftlägeskänlig efter avkodning av PDF-textsträngen, utan Unicode-normalisering eller matchning mot visningstext

Samma namn på olika sidor identifierar olika annoteringar; ett frånvarande namn på den valda sidan är en no-op

Att ta bort en annotering tar också bort dess popup och de svar som beror på den, inklusive nästlade svar och popup-beroenden; en besöksmängd gör beroendecykler ändliga, och varje borttagen annotering räknas en gång i det returnerade antalet

Att ta bort en popup ensam behåller dess ägare och rensar ägarens Popup-post; obesläktade annoteringar behåller sin ursprungliga ordning och data

Duplicerade begärda identiteter, ett tvetydigt begärt namn på en sida eller en annoteringsordlista som delas av flera sidarrayposter orsakar misslyckande före publicering

Publicering och säkerhet

Den nativa metoden lämnar det inlästa dokumentet oförändrat vid framgång och misslyckande; läs in den resulterande PDF:en för att anta borttagningen

Publiceringen använder en förberedd fil och atomärt destinationsbyte; en misslyckad eller avbruten förberedelse bevarar den befintliga destinationen, och destinationen får inte aliasa den inlästa källan

Noll borttagningar publicerar en exakt kopia av den aktuella källrevisionen; att upprepa samma borttagning mot det resulterande dokumentet returnerar noll och behåller dess byte

En inkrementell revision tar bort annoteringar från den aktuella sidgrafen medan äldre byte och revisioner behålls; denna operation är inte säker radering eller redaction, och borttaget innehåll kan förbli återställbart från filhistoriken

Behörigheter och resursgränser

Faktiska borttagningar kräver autentiserad annoteringsbehörighet för krypterad indata och godkännande enligt signaturpolicy för signerad indata; att lyckas öppna en krypterad PDF ger inte i sig behörighet att ändra annoteringar

Autentiserad certifiering P1 och P2 avvisar annoteringsändringar; en tillåten P3-uppdatering bevarar de ursprungliga signerade bytena, med signaturintegritet och certifikatbindningskontroller tillämpade på det faktiska dokumentet

Konfigurera nödvändigt certifikatförtroende, tidsstämplar och återkallningspolicy explicit när dessa kontroller ingår i applikationens säkerhetskrav

Borttagningsalternativ avgränsar annoteringsantal, operationsarbete, namnlagring och arbetsminne, med samarbetsvilligt avbrott delat med dokumentet eller transaktionen

Aktuell gräns

En vald Widget, eller en Widget som nås via borttagningsberoenden, avvisas eftersom borttagning av formulärfält kräver en AcroForm-fältträdtransaktion; detta API tar inte bort fält och kopplar inte tyst bort deras widgets

Operationen kör inte annoteringsåtgärder eller skript och tolkar inte borttagning som tillämpning av en Redact-annotering

Se JSON- och callback-operationer för annotations.remove, explicit indata-IO och de separata commit-stegen för PDF, resultat och kontext