PDFium Delphi Component Docs

FlattenAllPages Metod

Component: TPdf  ·  Unit: PDFium
Bekvämlighetsfunktion som plattar till varje sida i dokumentet. Returnerar True när varje sida avslutas med FLATTEN_SUCCESS eller FLATTEN_NOTHINGTODO. Rekommenderat arbetsflöde: GenerateFormAppearances → FlattenAllPages → SaveAs

Syntax

function FlattenAllPages(nFlag: Integer = FLAT_NORMALDISPLAY): Boolean;

nFlagInteger. Väljer utplattningsprofilen som tillämpas på varje sida. Skicka FLAT_NORMALDISPLAY (0, standard) för att optimera för skärmvisning, eller FLAT_PRINT (1) för att optimera för utskriftsutdata

Return Value

True om varje sida i dokumentet returnerade antingen FLATTEN_SUCCESS (1) eller FLATTEN_NOTHINGTODO (2); False om någon sida returnerade FLATTEN_FAIL (0)

Description

FlattenAllPages är en bekvämlighetsomslutning som itererar över varje sida i det inlästa dokumentet och anropar motsvarigheten till FlattenPage på varje sida. Annoteringar och AcroForm-widgetar på alla sidor sammanfogas till permanent, icke-redigerbart sidinnehåll i ett enda anrop

Metoden returnerar True endast när alla sidor slutförs med FLATTEN_SUCCESS eller FLATTEN_NOTHINGTODO. Att en enda sida returnerar FLATTEN_FAIL får metoden att returnera False, men utplattningen fortsätter för de återstående sidorna

När dokumentet innehåller ifyllda formulärfält anropar du alltid GenerateFormAppearances före FlattenAllPages. Utan utseendeströmmar visas inte fältvärdena i den utplattade utdata. Det rekommenderade hela arbetsflödet är: tilldela FormField[]-värden → GenerateFormAppearances → FlattenAllPages → SaveAs

För att platta till en enda sida och granska dess enskilda resultatkod använder du FlattenPage i stället

Example

begin
  // Fill fields, generate appearances, flatten entire document
  Pdf1.FormField[0] := 'Jane Doe';
  Pdf1.FormField[1] := '2026-05-20';
  Pdf1.GenerateFormAppearances;
  if Pdf1.FlattenAllPages(FLAT_NORMALDISPLAY) then
    Pdf1.SaveAs('output_flat_all.pdf')
  else
    ShowMessage('One or more pages could not be flattened');
end;

See Also

FlattenPage, GenerateFormAppearances, SaveAs