Variabler
mark_text
Listenbefehl
Funktion
Markiert einen nullterminierten String.
Aufruf
mark_text( Text )
Parameter
Text
Hinweise
• Der zu markierende Text (Zeichenfolge, Byte-Array, nullterminierter String) muss mit
einem \0-Zeichen (0-Byte, NUL) enden. Das 0\-Zeichen selbst wird nicht markiert.
• Beim Laden eines mark_text-Befehls wird der zu markierende Text, sofern er aus mehr
als 12 Zeichen besteht (\0 nicht mitgezählt), in Blöcke zu je 12 Zeichen zerteilt und für
jeden Block ein separater mark_text-Befehl in den Listenspeicher geschrieben (man
sollte darauf achten, dass es dabei zu keinem unerwünschten Speicherüberlauf des
jeweiligen Speicherbereichs kommt). Beim Abarbeiten der einzelnen mark_text-Befehle
werden dann entsprechend des gewählten Zeichensatzes die zugehörigen mark_char-
Befehle (indizierte Zeichen) ausgeführt.
• Der gewünschte Zeichensatz kann vor dem mark_text-Befehl mit
ausgewählt werden. In der Voreinstellung wird der Zeichensatz 0 verwendet. Wenn
innerhalb eines aufgerufenen indizierten Zeichens der Befehl
verwendet wird, werden alle nachfolgend aufgerufenen indizierten Zeichen mit diesem
Zeichensatz markiert.
• Wird beim Laden eines mark_text-Befehls das Ende einer Liste ("Liste 1" oder "Liste 2")
erreicht, wird beim Anfang der jeweiligen Liste fortgefahren. Im geschützten Bereich
(als Bestandteil eines indizierten Unterprogramms) dagegen wird das Laden abgebro-
chen (get_last_error-Returncode RTC5_REJECTED) und das indizierte Unterprogramm
nicht gespeichert.
• Absolute Vektor- und Bogenbefehle werden nach Aufruf mit mark_text auch absolut
ausgeführt. Wenn der Text an unterschiedlichen Stellen im Bildfeld markiert werden soll,
dürfen die indizierten Zeichendefinitionen nur relative Mark-, Bogen- oder Jump-
Befehle enthalten oder es ist der Befehl
• Der mark_text-Befehl sollte nicht innerhalb einer indizierten Zeichendefinition
verwendet werden. Der entsprechende Text würde nicht markiert und das indizierte
Zeichen daher nicht vollständig ausgeführt.
®
®
RTC
4 RTC
5 Neuer Befehl.
Verweise
mark_text_abs
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
10 Befehle und Funktionen
PC-Speicheradresse des ersten Zeichens (Byte) des zu markierenden Textes als
Pointer auf einen nullterminierten String.
®
5 PC/104-Plus-Karte, RTC
mark_text_abs
zu verwenden.
®
5 PCIe/104-Karte
select_char_set
select_char_set
400