Show TOC

FunktionsdokumentationTEXT_SYMBOL_SETVALUE Dieses Dokument in der Navigationsstruktur finden

 

Mit der Funktion TEXT_SYMBOL_SETVALUE kann einem SAPscript-Symbol ein Wert zugewiesen werden. Dabei können Sie nur die Werte von Textsymbolen verändern. Systemsymbole, Standardsymbole und Programmsymbole können nicht mit neuen Werten versehen werden.

Die Wertzuweisung bleibt solange erhalten, bis die Symbolverwaltungstabellen in SAPscript initialisiert werden Dies ist z.B. beim OPEN_FORM oder beim Funktionsbaustein TEXT_SYMBOL_REPLACE über den Parameter INIT = ´X´ möglich.

Funktionsaufruf:

Syntax Syntax

  1. CALL FUNCTION 'TEXT_SYMBOL_SETVALUE'
    	EXPORTING
    		NAME		= ?...
    		VALUE		= ?...
    		VALUE_LENGTH	= 0
    		REPLACE_SYMBOLS	= ' '
Ende des Quelltextes.
Export-Parameter:

NAME

Der Parameter enthält den Namen des Symbols, dem ein neuer Wert zugewiesen werden soll.

Es darf nur der Symbolnamen angegeben werden, ohne die Textzusätze bzw. die möglichen Aufbereitungsoptionen. Der Symbolname kann entweder mit oder ohne die Begrenzungszeichen & übergeben werden.

VALUE

Definieren Sie hier den Wert des Symbols. Die Länge des Wertes ist begrenzt. Maximal 80 Zeichen der hier übergebenen Zeichenkette werden als Symbolwert übernommen.

VALUE_LENGTH

Wird dieser Parameter nicht angegeben oder hat er den Wert 0, so wird die Länge des Symbolwertes automatisch ermittelt. Dabei werden alle Zeichen bis zum letzten Leerzeichen als Wert übernommen.

Sollen auch noch abschließende Leerzeichen in die Wertzuweisung aufgenommen werden, so muß dieser Parameter die gewünschte Länge des Symbolwertes enthalten.

Bezugsfeld: SY-TABIX

Defaultwert: 0

REPLACE_SYMBOLS

Der Wert 'X' in diesem Parameter bedeutet, daß Symbole, die im Feld VALUE enthalten sind, sofort durch ihre aktuellen Werte ersetzt, d.h. im zugewiesenen Wert kommen keine SAPscript-Symbole mehr vor.

Ist der Parameter leer, so wird der Inhalt des VALUE-Feldes unverändert übernommen. Darin vorkommende Symbole werden erst dann durch ihren jeweils aktuellen Wert ersetzt, wenn das im Parameter NAME angegebene Symbol im Text aufgerufen wird.

Defaultwert: ' '