Native Linux ABI form appearances

hpdf_document_execute_json_v1 wypełnia załadowane pola AcroForm przez forms.fill, generując domyślnie pasujące wyglądy normal i zachowując oryginalne rewizje PDF, hasła, słownik bezpieczeństwa i identyfikatory dokumentu

{"schemaVersion":1,"type":"forms.fill","fields":[
  {"name":"Notes","value":"First line Ω
Second café","fontSize":13},
  {"name":"Combo","value":"two"},
  {"name":"Colors","values":["blue","red"]},
  {"name":"Check","checked":true},
  {"name":"Radio","checked":true,"onState":"B"},
  {"name":"Submit","caption":"Send Ω"}
]}

Field values and appearances

Pola tekstowe akceptują value albo typowane richTextRuns; dostarczona wartość obok richTextRuns musi dokładnie zgadzać się z wywiedzionym tekstem zwykłym, łącznie z separatorami akapitów CR

Zwykłe wyglądy respektują dziedziczone ustawienia multiline, comb, wyrównania i rotacji i osadzają wybrany font Unicode TrueType; stylizowane runy niosą jawny styl, rozmiar, kolor, wyrównanie, złamania akapitów i dekoracje fontu

Pola tekstowe password maskują swoje wyglądy i mapowania glifów jedną kropką na skalar Unicode, zachowując rzeczywistą przechowywaną wartość pola i oryginalne szyfrowanie; pola wyboru pliku wyświetlają literalną ścieżkę Unicode bez otwierania wybranego pliku

Pola choice akceptują jeden ciąg value albo kompletną tablicę values, nigdy oba; wartości eksportu mapują się na tekst display opcji, wybory wielokrotne są sortowane po indeksie opcji, a pusta tablica czyści wybór

Checkboxy i grupy radio wymagają Boolean checked; onState defaultowo to Yes i wybiera pasujący widget radio, gdy dostarczony jawnie, podczas gdy czyszczenie aktualizuje stany i pola, i widgetów

Push buttony wymagają caption, malowanej wybranym osadzonym fontem Unicode

forms.read zawiera kompletną tablicę values dla każdego pola choice, łącznie z pustą tablicą po czyszczeniu; skalarne członek value pozostaje dostępny

Dla pól rich, forms.read zwraca też przechowywany ciąg XHTML richText; zwykłe zamiany wartości synchronizują RV, a stylizowane runy wymagają generowania wyglądów

Options and publication

Każda edycja akceptuje fontFamily (default DejaVu Sans), fontSize (12), padding (2), characterSpacing (0), wordSpacing (0) i paintWhiteBackground (true)

Typowane edycje rich mogą też używać tablic fontFamilies i per-run wyboru rodziny, zachowując oryginalne zachowanie pojedynczej rodziny przy braku tablicy

Edycje tekstowe mogą jawnie ustawić appearance:false dla aktualizacji wyłącznie wartości; edycje choice i button wymagają generowania wyglądów

Nieznane pola, zduplikowane edycje, niepoprawne wybory, nadmierne wartości comb, wadliwe parametry, anulowanie, wyczerpanie zasobów i nieudane callbacki pozostawiają bieżący załadowany dokument niezmieniony; wyjście jest przygotowywane przed uruchomieniem jakiegokolwiek callbacka publikacji binarnej

Wynik operacji zawiera updated i bieżącą listę pól; odkryj obsługiwane typy wyglądów przez tablicę zdolności formAppearances

Natywna akceptacja C ABI generuje rzeczywiste wyjścia formularzy plain i AES R5/R6; niezależne sprawdzenia pypdf i MuPDF przeglądają indeksy wyborów, stany widgetów, osadzone fonty, wartości Unicode, szyfrowanie i rzeczywiste piksele wyglądów

Native Linux C ABI · Workflow podpisywania · Pozostały plan dostarczenia