DynaPDF Manual - Page 713

Previous Page 712   Index   Next Page 714

Function Reference
Page 713 of 777
LBOOL pdfSetNeedAppearance(
const PPDF* IPDF, // Instance pointer
LBOOL Value)
// Value -> true or false
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.
Return values:
If the function succeeds the return value is 1. If the function failse the return value is 0.
SI32 pdfSetNumberFormat(
const PPDF* IPDF,
// Instance pointer
UI32 TxtField,
// Text field handle
TDecSeparator Sep,
// Decimal separator
UI32 DecPlaces,
// Number of decimal places
TNegativeStyle NegStyle, // Negative number format
const char* CurrStr,
// Currency string or NULL
LBOOL Prepend)
// Position of Currency string
// Thousand separator, decimal separator
typedef enum
typedef enum

Previous topic: SetMinLineWidth2 (Rendering Engine), SetMiterLimit

Next topic: SetOCGContUsage