Bezeichnung
ccontext:TagBegin -- Markiert den Anfang eines Tags
Übersicht
ccontext:TagBegin(tag_name$, attributes$)
Beschreibung
Markiert den Anfang der Struktur tag_name$. Rufen Sie ccontext:TagEnd() mit demselben tag_name$ auf, um das Ende der Struktur zu markieren. Der Parameter tag_name$ kann eine der folgenden Konstanten sein:

#CAIRO_TAG_DEST
Erstellt ein Ziel für einen Hyperlink.
#CAIRO_TAG_LINK
Hyperlink erstellen.

Die Zeichenkette attributes$ hat die Form "key1=value2 key2=value2 ...". Die Werte können boolesche Werte (wahr/falsch oder 1/0), Ganzzahlen, Gleitkommazahlen, Zeichenketten oder ein Array sein.

Zeichenkettenwerte werden in einfache Anführungszeichen (') eingeschlossen. Einfache Anführungszeichen und Backslashes (Rückstrich: \) innerhalb der Zeichenkette sollten mit einem Backslash (Rückstrich: \) maskiert werden.

Boolesche Werte können nur durch Angabe des Schlüssels auf "true" gesetzt werden. Beispielsweise ist die AttributZeichenkette "key" das Äquivalent zu "key=true".

Arrays werden in "[]" eingeschlossen. z.B. "rect=[1.2 4.3 2.0 3.0]".

Wenn keine Attribute erforderlich sind, kann attributes$ eine leere Zeichenkette sein.

Die Liste der Tags und Attribute finden Sie in der Beschreibung der Tags und Links im Cairo-Handbuch.

Eine ungültige Verschachtelung von Tags oder ungültige Attribute führen dazu, dass der Kontext mit dem Status #CAIRO_STATUS_TAG_ERROR heruntergefahren wird.

Siehe ccontext:TagEnd().

Eingaben
tag_name$
Tag-Name (siehe oben).
attributes$
Tag-Attribute (siehe oben).
Beispiel
cr:TagBegin(#CAIRO_TAG_LINK, "dest='mydest' internal")
cr:MoveTo(50, 50)
cr:ShowText("This is a hyperlink.")
cr:TagEnd(#CAIRO_TAG_LINK)
Der obige Code erstellt einen Hyperlink.
Navigation zeigen