THPDFHeadlessDocument.SaveAnnotationRemovalsToFile method

function SaveAnnotationRemovalsToFile(const FileName: string;
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions): Integer;

Przygotowuje usunięcia adnotacji stron z aktualnie wczytanego źródła i atomowo publikuje osobny PDF do FileName

Identities wybiera adnotacje po poprawnych indeksach stron od zera i dokładnych zdekodowanych wartościach Unicode NM; Options dostarcza dodatnie limity zasobów i opcjonalne współdzielone anulowanie

Wartość zwrotna liczy każdą usuniętą adnotację raz, włącznie z zależnościami popupów i odpowiedzi; może przekroczyć liczbę żądanych tożsamości

Puste żądanie albo poprawne niematchujące tożsamości zwracają zero i publikują dokładne bieżące bajty źródła; zdublowane tożsamości, niejednoznaczne wybrane nazwy i współdzieleni właściciele adnotacji zawodzą

Usunięcie właściciela usuwa przejściowo zależne popupy i odpowiedzi, ze skończoną obsługą cykli; usunięcie tylko jego popupa czyści link Popup zachowanego właściciela

Wybrany albo zależny Widget podnosi hdFieldTypeUnsupported, bo usuwanie drzewa pól to osobna transakcja

Stan i publikacja

Wczytany dokument pozostaje niezmieniony po sukcesie i po niepowodzeniu; wczytaj ponownie opublikowany PDF, by przyjąć zmienioną rewizję

Zmienione wyjście to przyrostowa rewizja zachowująca oryginalny prefiks pliku; zero zmian produkuje dokładną kopię, a ta operacja nie wymazuje bezpiecznie starych rewizji

Ścieżka wyjścia nie może być aliasem wczytanego źródła; niepowodzenie alokacji, niepoprawne wejście, odrzucenie polityki, wyczerpanie budżetu i anulowanie zachowują istniejący cel

Polityka i diagnostyka

Rzeczywiste zmiany wymagają uprawnienia adnotacji zaszyfrowanego dokumentu i uwierzytelnionego przyjęcia polityki podpisów podpisanego dokumentu; certyfikacja P1/P2 odrzuca zmiany, podczas gdy dopuszczone zmiany P3 zachowują oryginalne podpisane zakresy bajtów

Niepoprawne tożsamości i zniekształcona przynależność raportują hdInvalidDocument; wyczerpanie zasobów raportuje hdLimitExceeded; wybór Widgeta raportuje hdFieldTypeUnsupported

Błędy bezpieczeństwa, podpisów i anulowania zachowują swoje istniejące natywne kontrakty diagnostyczne; skonfiguruj wymagania zaufania i znaczników czasu przez opcje polityki podpisów dokumentu

Zobacz THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions i natywne usuwanie adnotacji