Bezeichnung
pcontext:Itemize -- Unterteilt einen Textabschnitt in Segmente
Übersicht
list = pcontext:Itemize(text$, start_index, length, attrs[, base_dir])
Beschreibung
Unterteilt einen Textabschnitt in Segmente mit einheitlicher Richtungsebene und Schriftart. Jedes Byte des Textes ist in genau einem der Elemente in der zurückgegebenen Liste enthalten. Die erzeugte Liste der Elemente ist in logischer Reihenfolge (die Startoffsets der Elemente sind aufsteigend).

Optional können Sie die Basisrichtung im Argument base_dir angeben. Die Basisrichtung wird beim Berechnen bidirektionaler Ebenen verwendet. Wenn base_dir weggelassen wird, wird die Basisrichtung aus dem Kontext ermittelt. Eine Liste der Basisrichtungen finden Sie unter pcontext:SetBaseDir().

Beachten Sie, dass Sie die einzelnen Pango-Elemente in der Liste mit pitem:Free() löschen müssen.

Eingaben
text$
der aufzulistende Text
start_index
erstes zu verarbeitendes Byte im Text
length
die Anzahl der zu verarbeitenden Bytes (nicht Zeichen) nach start_index. Dieser Wert muss >= 0 sein
attrs
eine Pango-Attributliste mit der Menge der Attribute, die für Text gelten
base_dir
optional: Basisrichtung, die für die bidirektionale Verarbeitung zu verwenden ist
Rückgabewerte
list
eine Tabelle mit einer Liste von Pango-Elementen; der Aufrufer ist dafür verantwortlich, jedes Element mit pitem:Free() zu löschen
Navigation zeigen