Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

DynaPDF Manual - Page 688

Previous Page 687   Index   Next Page 689

Function Reference
Page 688 of 750
SetNeedAppearance
Syntax:
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.
SetNumberFormat
Syntax:
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
{
dsCommaDot,
dsNoneDot,
dsDotComma,
dsNoneComma
}TDecSeparator;
typedef enum
{
nsMinusBlack,
 

Previous topic: SetMiterLimit

Next topic: SetOCGContUsage