THPDFHeadlessDocument.PrepareEmbeddedFormDataFDF

function PrepareEmbeddedFormDataFDF(const Bytes: SysUtils.TBytes;
  const Selection: THPDFFDFChildSelections;
  const FieldOptions: THPDFHeadlessFormDataOptions;
  const PackageOptions: THPDFFDFPackageOptions;
  IncludeAnnotations: Boolean = True): THPDFHeadlessPreparedEmbeddedFDF;

Requires a loaded destination PDF and an explicit nonempty embedded child path, decodes the selected fields once, and returns a caller-owned held import plan

FieldOptions limits the selected child field model; PackageOptions limits the enclosing package and cumulative nested selection work

Non-nil field or graph cancellation tokens must match the loaded document token; the plan uses that document token during later preparation and commit

Mutable style-sheet and selector arrays, image-resource records and each image byte buffer are copied after admission; later caller mutation cannot replace a held image or change the plan's options

IncludeAnnotations=True retains a separate annotation projection of the selected graph; False imports fields only when the plan is saved

Inspect FieldCount or CopyFields to select the actual font programs needed for the held values, then publish through SavePreparedEmbeddedFormDataFDFToFile

Free the returned plan in a finally block; reloading or destroying its destination source invalidates it

Held plan class · Package selection, policy and limits