PDFium Delphi Component Docs

GenerateFormAppearances Yöntem

Component: TPdf  ·  Unit: PDFium
Her sayfadaki her form widget için /AP (appearance stream) girdisini, her sayfayı FPDF_FFLDraw üzerinden işleyerek yeniden oluşturur. Bu, FormField[i] := value atamalarının önerilen eşlikçi çağrısıdır — bu adım olmadan form değerleri yalnızca alan odaktayken görünür olabilir ve sonraki bir flatten işlemi değerleri sessizce kaybedebilir. Tüm FormField[] atamalarından sonra ve SaveAs / FlattenPage / FlattenAllPages öncesinde çağırın

Syntax

procedure GenerateFormAppearances;

Description

GenerateFormAppearances, düzenlenebilir metin ve combo-box görünümlerini yerel form-fill düzenleyicisi üzerinden yeniden oluşturur ve checkbox ile radio-button görünüm durumlarını eşitler

Yerel metin ve combo-box atamaları görünümlerini form-fill düzenleyicisi üzerinden işler; ham sözlük düzenlemeleri ve başlangıçta eksik görünümler, düzleştirmeden önce bu yeniden üretim adımını yine de gerektirebilir; çünkü düzleştirme, canlı düzenleyicinin görüntüsü yerine saklanan appearance stream'lerini kullanır

Bir formu doldurup kilitlerken doğru iş akışı şudur: tüm FormField[] değerlerini ata → GenerateFormAppearances'i bir kez çağır → isteğe bağlı olarak FlattenPage / FlattenAllPages çağır → SaveAs çağır. Doldurulmuş formu düzleştirmeden kaydetmeniz gerekiyorsa bile, üçüncü taraf PDF görüntüleyicilerle maksimum uyumluluk için GenerateFormAppearances yine de önerilir

Yordam tüm dokümanı tek çağrıda işler; sayfa başına bir varyantı yoktur

Example

begin
  // Assign form field values
  Pdf1.FormField[0] := 'Alice Example';
  Pdf1.FormField[1] := '[email protected]';
  Pdf1.FormField[2] := '2026-05-20';
  
  // Bake appearance streams so values are visible in all viewers
  Pdf1.GenerateFormAppearances;
  
  // Flatten and save a non-editable copy
  Pdf1.FlattenAllPages;
  Pdf1.SaveAs('output_filled_flat.pdf');
end;

Devralınan widget'lar, özgün üst alan değerinin doğrulanmış bir geri yüklemesinin izlediği geçici bir yerel düzenleme kullanır; widget'a gölge bir değer yazılmaz

Devralınan salt okunur alanlar bu düzenleme iş akışını kullanamaz ve hata yükseltir; GenerateFormAppearances işlemsel bir belge işlemi değildir

See Also

FlattenPage, FlattenAllPages, FormField, SaveAs