Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Sets need appearance flag.

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 13.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.SetNeedAppearance"; PDF; Flag )   More


Parameter Description Example
PDF The PDF reference returned from DynaPDF.New. $pdf
Flag The new value.
Pass 1 to ask viewer to redraw form content or 0 to not.


Returns OK or error.


Sets need appearance flag.
The global NeedAppearance flag of an Interactive Form specifies whether a PDF viewer should rebuild the field appearances when opening the file or whether the existing definitions should be used. DynaPDF creates always appearance streams for all field types. However, in certain cases it can be useful to let the viewer render fields with their own algorithms because the exact way how Adobe’s Acrobat builds the field appearances is not documented.
For example, when editing the contents of a text field in Adobe’s Acrobat the viewer rebuilds first the field appearance before placing the editing cursor into the field. The new appearance created from Adobe’s Acrobat can be slightly different in comparison to the one that was created by DynaPDF. The visible contents, especially of text fields, is sometimes not absolutely stable.
If the NeedAppearance flag is set, the viewer uses already its own algorithms to build the field appearances when opening the file. This avoids visible changes when editing a field. However, the NeedAppearance flag must not be set to true if a form contains page templates.

See also SetNeedAppearance function in DynaPDF manual.


Require appearance rendering:

Set Variable [ $r ; Value: MBS( "DynaPDF.SetNeedAppearance"; $pdf; 1 ) ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 26th March 2023, last changed 27th March 2023

DynaPDF.SetMiterLimit - DynaPDF.SetNumberFormat