Aryan dae75842fc Add APIs to read and write attachment descriptions
This CL introduces FPDFAttachment_GetDescription() and
FPDFAttachment_SetDescription() to allow embedders to retrieve and
modify the "/Desc" key within an embedded file's file specification
dictionary.

To support these new public APIs, this CL updates CPDF_FileSpec with
helper methods to access its underlying dictionary directly, both in
const and mutable contexts.

Bug: 42270947
Change-Id: Icd917d4ebbef4682a588e99fdefc85f383d24d48
Reviewed-on: https://pdfium-review.googlesource.com/c/pdfium/+/151150
Commit-Queue: Lei Zhang <thestig@chromium.org>
Reviewed-by: Lei Zhang <thestig@chromium.org>
Reviewed-by: Andy Phan <andyphan@chromium.org>
2026-07-13 11:02:03 -07:00
..

public/ README

The header files in this directory are the only ones that should ever be
included by an embedder of PDFium.  If there arises a need for functionality
beyond what is present here, then a new API must be added here to provide it.

Documentation for the API is within the headers. Start by reading fpdfview.h.

These header files must be entirely contained in this directory; they must
never include other header files from outside of it.

These files must compile cleanly without warnings on both C and C++ compilers.

Changes to these files must be carefully considered to avoid breaking
compatibility.