Name
ccontext:TagBegin -- mark beginning of a tag
Synopsis
ccontext:TagBegin(tag_name$, attributes$)
Function
Marks the beginning of the tag_name$ structure. Call ccontext:TagEnd() with the same tag_name$ to mark the end of the structure. The tag_name$ parameter can be one of the following constants:

#CAIRO_TAG_DEST
Create a destination for a hyperlink.
#CAIRO_TAG_LINK
Create hyperlink.

The attributes$ string is of the form "key1=value2 key2=value2 ...". Values may be boolean (true/false or 1/0), integer, float, string, or an array.

String values are enclosed in single quotes ('). Single quotes and backslashes inside the string should be escaped with a backslash.

Boolean values may be set to true by only specifying the key. eg the attribute string "key" is the equivalent to "key=true".

Arrays are enclosed in '[]'. eg "rect=[1.2 4.3 2.0 3.0]".

If no attributes are required, attributes can be an empty string.

See the tags and links description in the Cairo manual for the list of tags and attributes.

Invalid nesting of tags or invalid attributes will cause the context to shutdown with a status of #CAIRO_STATUS_TAG_ERROR.

See ccontext:TagEnd().

Inputs
tag_name$
tag name (see above)
attributes$
tag attributes (see above)
Example
cr:TagBegin(#CAIRO_TAG_LINK, "dest='mydest' internal")
cr:MoveTo(50, 50)
cr:ShowText("This is a hyperlink.")
cr:TagEnd(#CAIRO_TAG_LINK)
The code above creates a hyperlink.
Show TOC