PDFium Component Docs

FlattenAllPages methode

Component: TPdf  ·  Unit: PDFium
Gemakswrapper die elke pagina in het document samenvoegt. Geeft True terug wanneer elke pagina voltooit met FLATTEN_SUCCESS of FLATTEN_NOTHINGTODO. Aanbevolen workflow: GenerateFormAppearances → FlattenAllPages → SaveAs

Syntax

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

nFlagInteger. Selecteert het samenvoegingsprofiel dat op elke pagina wordt toegepast. Geef FLAT_NORMALDISPLAY (0, standaard) door om te optimaliseren voor weergave op het scherm, of FLAT_PRINT (1) om te optimaliseren voor afgedrukte uitvoer.

Return Value

True als elke pagina in het document FLATTEN_SUCCESS (1) of FLATTEN_NOTHINGTODO (2) teruggaf; False als een pagina FLATTEN_FAIL (0) teruggaf.

Description

FlattenAllPages is een gemakswrapper die over elke pagina in het geladen document itereert en het equivalent van FlattenPage op elke pagina aanroept. Annotaties en AcroForm-widgets over alle pagina's worden in één aanroep samengevoegd tot permanente, niet-bewerkbare pagina-inhoud.

De methode geeft alleen True terug wanneer alle pagina's voltooien met FLATTEN_SUCCESS of FLATTEN_NOTHINGTODO. Eén pagina die FLATTEN_FAIL teruggeeft zorgt ervoor dat de methode False teruggeeft, hoewel het samenvoegen doorgaat voor de resterende pagina's.

Wanneer het document ingevulde formuliervelden bevat, roept u altijd GenerateFormAppearances aan vóór FlattenAllPages. Zonder weergavestromen verschijnen de veldwaarden niet in de samengevoegde uitvoer. De aanbevolen volledige workflow is: wijs FormField[]-waarden toe → GenerateFormAppearances → FlattenAllPages → SaveAs.

Om één pagina samen te voegen en de individuele resultaatcode te inspecteren gebruikt u in plaats daarvan FlattenPage.

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