DynaPDF Manual - Page 158
Previous Page 157 Index Next Page 159
Function Reference
Page 158 of 839
Append
Syntax:
SI32 pdfAppend(
const PPDF* IPDF) // Instance pointer
This function appends an empty page to the document. The default page format for new created
pages is DIN A4. However, when changing the page format, the next page is created in the same
format as the previous one. The CropBox is also set to the values of the previous page. The other
bounding boxes such as ArtBox, BleedBox and so on must be set manually for each page.
The page format can be changed with the function SetPageFormat() if a predefined format should be
used, or manually with SetBBox(). SetBBox() must also be used to set a user defined bounding box
(ArtBox, BleedBox, CropBox, TrimBox).
The meaning of the bounding boxes are described under the property Get/SetBBox().
The graphics state of a new page is initialzed with the following default values:
Parameter
Data type
Initial Value
CharSpacing
float
0.0f
Clipping Path
Vector array
Crop box or Media box
DashPattern
double*
NULL (Solid line)
DashPhase
UI32
0
FillColor
BYTE[32]
Black
FillColorSpace
TExtColorSpace, IColorSpace*
esDeviceRGB, NULL
FillPattern
IPattern*
NULL
Font
IFont*
NULL
Leading
float
0.0f
LineCapStyle
TLineCapStyle
csButtCap
LineJoinStyle
TLineJoinStyle
jsMiterJoin
LineWidth
float
1.0f
Matrix
TCTM
{1, 0, 0, 1, 0, 0}
MiterLimit
float
10.0f
StrokeColor
BYTE[32]
Black
StrokeColorSpace
TExtColorSpace, IColorSpace*
esDeviceRGB, NULL
StrokePattern
IPattern*
NULL
TextDrawMode
TDrawMode
dmNormal
TextScale
float
100.0f
WordSpacing
float
0.0f
Return values:
If the function succeeds the return value is 1. If the function fails the return value is zero.
Previous topic: Embedding ICC Profiles, AddRenderingIntent (obsolete), AddRenderingIntentEx (obsolete), AddValToChoiceField
Next topic: ApplyAppEvent, ApplyPattern