PDFlib 8 Windows COM/.NET Tutorial

11.6.2 Rectangle Properties
Rectangle properties apply to all Block types. They describe the appearance of the Block
rectangle itself. Required entries will automatically be generated by the Block Plugin.
Table 11.5 lists the rectangle properties.
Table 11.5 Rectangle properties
keyword
backgroundcolor
bordercolor
linewidth
Rect
Status
possible values and explanation
(Color) If this property is present and contains a color space keyword different from None, a rectangle will
be drawn and filled with the supplied color. This may be useful to cover existing page contents. Default:
None
(Color) If this property is present and contains a color space keyword different from None, a rectangle will
be drawn and stroked with the supplied color. Default: None
(Float; must be greater than 0) Stroke width of the line used to draw the Block rectangle; only used if
bordercolor is set. Default: 1
(Rectangle; required) The Block coordinates. The origin of the coordinate system is in the lower left corner
of the page. However, the Block Plugin displays the coordinates in Acrobat’s notation, i.e., with the origin
in the upper left corner of the page. The coordinates will be displayed in the unit which is currently selected
in Acrobat, but will always be stored in points in the PDF file.
(Keyword) Describes how the Block will be processed by PPS and the Preview feature (default: active):
active The Block will be fully processed according to its properties.
ignore The Block will be ignored.
ignoredefault
Like active, except that the defaulttext/image/pdf properties will be ignored, i.e. the Block
remains empty if no variable contents are available (especially in the Preview). This may be
useful to make sure that the Block’s default contents will not be used for filling Blocks on the
server side although the Block may contain default contents for generating Previews. It can
also be used to disable the default contents for previewing a Block without removing the
default contents from the Block properties.
static No variable contents will be placed; instead, the Block’s default text, image, or PDF contents
will be used if available.
11.6 Block Properties 301