sdapspdf package¶

You can use this package to make PDF forms using the SDAPS packages. SDAPS itself does not give you a way to submit these though.

To use this feature simply use the sdapspdf package. You need to wrap everything containing PDF form elements inside a Form environment. After this enable form generation by simply setting the pdf_form option for checkboxes and freeform textboxes.

Note

The sdapspdf package imports hyperref internally. So some care might need to be taken to import it after hyperref itself.

The following extra options are added to boxes and checkboxes:

Option	Purpose
pdf_form	Turn on PDF form generation (default: false)
default	Allows enabling a checkbox by default (default: false, set to true to use)
checkboxsymbol	The symbol to use for the checkmark (integer, see PDF specification, default: 8)

Warning

The default for pdf_form might still change to be true.

Note

The SDAPS base package will likely add further macros to make setting these options more convenient.

Example LaTeX codeResult

\begin{Form}
  \ExplSyntaxOn
    % Set the pdf_form option for all boxes (*)
    \sdaps_context_append:nn{*}{pdf_form=true}

    % Or for checkboxes and textboxes separately
    %\sdaps_context_append:nn{checkbox}{pdf_form=true}
    %\sdaps_context_append:nn{textbox}{pdf_form=true}

    \noindent A~checkbox:~\sdaps_checkbox:nn {} {} \newline
    \sdaps_context_set:n{checkbox={default=true}}
    A~checked~checkbox:~\sdaps_checkbox:nn {} {} \newline
    \sdaps_context_set:n{checkbox={default=true,checkboxsymbol=5}}
    A~checked~checkbox~with~different~symbol:~\sdaps_checkbox:nn {} {} \par

    Please~note~that~the~above~rendering~is~slightly~broken~as~the~poppler~
    PDF~renderer~maps~the~checkboxsymbol~incorrectly.~Acrobat~will~show~the~
    other~symbol.\par

    \noindent A~non-stretching~textbox:
    \sdaps_textbox_vhstretch:nnn { text } { 4cm } { 0 }
  \ExplSyntaxOff
\end{Form}

Required code in preamble:

\usepackage{sdapspdf}

$\begin{Form} \ExplSyntaxOn % Set the pdf_form option for all boxes (*) \sdaps_context_append:nn{*}{pdf_form=true} % Or for checkboxes and textboxes separately %\sdaps_context_append:nn{checkbox}{pdf_form=true} %\sdaps_context_append:nn{textbox}{pdf_form=true} \noindent A~checkbox:~\sdaps_checkbox:nn {} {} \newline \sdaps_context_set:n{checkbox={default=true}} A~checked~checkbox:~\sdaps_checkbox:nn {} {} \newline \sdaps_context_set:n{checkbox={default=true,checkboxsymbol=5}} A~checked~checkbox~with~different~symbol:~\sdaps_checkbox:nn {} {} \par Please~note~that~the~above~rendering~is~slightly~broken~as~the~poppler~ PDF~renderer~maps~the~checkboxsymbol~incorrectly.~Acrobat~will~show~the~ other~symbol.\par \noindent A~non-stretching~textbox: \sdaps_textbox_vhstretch:nnn { text } { 4cm } { 0 } \ExplSyntaxOff \end{Form}$

Using PDF forms