Xojo Conferences
MBSOct2019CologneDE

DynaPDF Manual - Page 532

Previous Page 531   Index   Next Page 533

Function Reference
Page 532 of 770
Example:
pdfOpenTag(PDF, btList, NULL, NULL, NULL);
// OK
pdfOpenTag(PDF, btListElem, NULL, NULL, NULL);
// OK
pdfOpenTag(PDF, btListElemText, NULL, NULL, NULL); // OK
pdfWriteText(PDF, 50.0, 50.0, "Some list text!");
pdfCloseTag(PDF);
pdfCloseTag(PDF);
pdfCloseTag(PDF);
pdfOpenTag(PDF, btList, NULL, NULL, NULL);
// OK
pdfOpenTag(PDF, btListElemText, NULL, NULL, NULL);
// Wrong
pdfOpenTag(PDF, btListElem, NULL, NULL, NULL);
// Wrong
pdfWriteText(PDF, 50.0, 50.0, " Some list text!");
pdfCloseTag(PDF);
pdfCloseTag(PDF);
pdfCloseTag(PDF);
pdfOpenTag(PDF, btListElem, NULL, NULL, NULL);
// Wrong
pdfWriteText(PDF, 50.0, 50.0, "List Element!");
pdfCloseTag(PDF);
The tags btAnnot, btField, and btLink can be used to add annotations and form fields to the
structure. Note that the corresponding annotation or form field is required! When opening such a tag
without inserting the corresponding annotation or field before the tag is closed then the structure
will be damaged!
However, the usage of these tags is normally not required because DynaPDF adds fields and
annotations automatically to the structure. When an annotation or form field is inserted within an
open tag then it will be added to this tag. If no open tag is present then it is added to the root of the
page's structure.
Remarks:
The maximum allowed nesting level of marked content operators is 64, including optional content
operators (Layers). At time of publication DynaPDF does not check whether tags are used in the
correct hierarchy.
However, when creating tagged PDF files you should always validate the tagging information with
the accessibility check of Adobe's Acrobat (Menu Advanced/Accessibility/Full Check...).
Tagged PDF files should be created in the logical reader.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is zero.
 

Previous topic: OpenTag

Next topic: Optimize