octoleo/qpdf
2
1
Fork 0
mirror of https://github.com/qpdf/qpdf.git synced 2024-12-22 10:58:58 +00:00
Code Issues Releases Wiki Activity

Add QPDFAcroFormDocumentHelper::addFormField

Browse Source
This commit is contained in:
Jay Berkenbilt 2021-02-18 11:18:24 -05:00
parent 5cec6b4c3d
commit de8929a41c
4 changed files with 39 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
ChangeLog
View File

@ -1,5 +1,8 @@
2021-02-18 Jay Berkenbilt <ejb@ql.org>
* Add QPDFAcroFormDocumentHelper::addFormField, which adds a new
form field, initializing the AcroForm dictionary if needed.
* Add QPDFPageObjectHelper::getMatrixForFormXObjectPlacement,
which returns the transformation matrix required to map from a
form field's coordinate system into a specific rectangle within

7
include/qpdf/QPDFAcroFormDocumentHelper.hh
View File

@ -106,6 +106,13 @@ class QPDFAcroFormDocumentHelper: public QPDFDocumentHelper
bool
hasAcroForm();
// Add a form field, initializing the document's AcroForm
// dictionary if needed. Calling this method invalidates the
// cache, which makes it possible to add a field that is not yet
// associated with an annotation or page.
QPDF_DLL
void addFormField(QPDFFormFieldObjectHelper);
// Return a vector of all terminal fields in a document. Terminal
// fields are fields that have no children that are also fields.
// Terminal fields may still have children that are annotations.

20
libqpdf/QPDFAcroFormDocumentHelper.cc
View File

@ -32,6 +32,26 @@ QPDFAcroFormDocumentHelper::hasAcroForm()
return this->qpdf.getRoot().hasKey("/AcroForm");
}
void
QPDFAcroFormDocumentHelper::addFormField(QPDFFormFieldObjectHelper ff)
{
invalidateCache();
auto acroform = this->qpdf.getRoot().getKey("/AcroForm");
if (! acroform.isDictionary())
{
acroform = this->qpdf.makeIndirectObject(
QPDFObjectHandle::newDictionary());
this->qpdf.getRoot().replaceKey("/AcroForm", acroform);
}
auto fields = acroform.getKey("/Fields");
if (! fields.isArray())
{
fields = QPDFObjectHandle::newArray();
acroform.replaceKey("/Fields", fields);
}
fields.appendItem(ff.getObjectHandle());
}
std::vector<QPDFFormFieldObjectHelper>
QPDFAcroFormDocumentHelper::getFormFields()
{

10
manual/qpdf-manual.xml
View File

@ -5286,12 +5286,20 @@ print "\n";
<listitem>
<para>
Add
<function>QPDFPageObjectHelper::getMatrixForFormXObjectPlacement</function>
<function>QPDFPageObjectHelper::getMatrixForFormXObjectPlacement</function>,
which returns the transformation matrix required to map from
a form field's coordinate system into a specific rectangle
within the page.
</para>
</listitem>
<listitem>
<para>
Add method
<function>QPDFAcroFormDocumentHelper::addFormField</function>,
which adds a new form field, initializing the AcroForm
dictionary if needed.
</para>
</listitem>
<listitem>
<para>
Add <function>QUtil::path_basename</function> to return the