DynaPDF Manual - Page 254

Previous Page 253   Index   Next Page 255

Function Reference
Page 254 of 839
If the coordinate system is bottom-up the point PosX, PosY defines the lower left corner of the
button. If the coordinate system is top-down it defines the upper left corner.
Like all form fields the width and height is measured incl. the line width of the border. The size of
normal vector graphics is measured without the line width; this must be taken into account when
calculating the width or height of a form field. The line width of the border is derived from the
current graphics state (see SetLineWidth()), it should be either 0, 1, 2, or 3 units (no border, thin,
medium, or thick). The border style can be changed with the functions SetBorderStyle() or
SetFieldBorderStyle().
The values of the combo box are sorted if the parameter Sort is true.
A combo box requires a font. If no font is active the standard font Helvetica is used. Note: If the
form must be compatible to Acrobat 4 the used fonts by the form fields must be restricted to the 14
standard fonts (see SetFont() for further information). Acrobat 4 does not support interactive forms
that use other fonts than the 14 standard fonts. Such a form requires Acrobat 5 or higher.
Form fields support natively the code pages 1252 and MacRoman. However, other code pages and
Unicode can be used too as long as a few external cmaps are available. See SetFieldFont() for further
information.
The font size of a combo box is set to "auto" if either the font size of the active font is set to 1.0 unit or
if no font is active when the field is created.
Specific flags supported by combo boxes:
ffEdit
// Enable adding of values in Adobe's Acrobat
ffSorted
// Change the sort flag if necessary
ffCommitOnSelCh
// Submit the new value immediately (PDF 1.5)
ffDoNotSpellCheck // Disable spell checking (requires ffEdit)
Remarks:
Interactive form fields can be structured into several groups by passing a handle of a group field to
the parameter Parent. See CreateGroupField() for further information.
Return values:
If the function succeeds the return value is the handle of the combo box, a value greater or equal
zero. If the function fails the return value is a negative error code.
 

Previous topic: CreateComboBox

Next topic: CreateDeviceNColorSpace