Ansicht
Dokumentation

ABAPWRITE_LIST_ELEMENTS - WRITE LIST ELEMENTS

BAL Application Log Documentation   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

WRITE, list_elements

Kurzreferenz

... ${AS CHECKBOX$}
  $| ${AS ICON$}
  $| ${AS SYMBOL$}
  $| ${AS LINE$} ...

Alternativen:

1. ... AS CHECKBOX

2. ... AS ICON

3. ... AS SYMBOL

4. ... AS LINE

Wirkung

Diese Zusätze dienen der Darstellung spezieller Listenelemente.

Das ausgegebene Datenobjekt dobj muss bestimmte Eigenschaften haben. Die Zusätze können nicht gemeinsam und nur bedingt mit den Zusätzen für interne Formatierungen und externe Formatierungen verwendet werden.

Alternative 1

... AS CHECKBOX

Wirkung

Dieser Zusatz gibt ein eingabebereites einstelliges Ankreuzfeld aus. Für dobj wird ein zeichenartiger Datentyp der Länge 1 erwartet. Wenn das erste Zeichen in dobj "X" oder "x" ist, wird das Ankreuzfeld markiert dargestellt. Wenn das erste Zeichen ungleich "X" oder "x" ist, wird das Ankreuzfeld leer dargestellt. Wenn dobj ein leeres Datenobjekt vom Typ string ist, wird das Ankreuzfeld nicht ausgegeben.

Der Benutzer kann das Ankreuzfeld auf der am Fenster dargestellten Liste markieren und entmarkieren. Wenn der Benutzer das Ankreuzfeld markiert, wird das erste Zeichen des zugeordneten Felds in der Liste auf "X" gesetzt, wenn er es entmarkiert, auf ein Leerzeichen. Die Änderung wird im Listenpuffer gespeichert und kann während eines Listenereignisses ausgewertet werden.

Bei Verwendung des Zusatzes AS CHECKBOX ist keine Längenangabe len hinter AT erlaubt. Außer INPUT, NO-GAP und UNDER haben die gleichzeitig angegebenen anderen Zusätze für interne Formatierungen und externe Formatierungen keine Wirkung.

Der Zusatz AS CHECKBOX wirkt so, als sei gleichzeitig der Zusatz INPUT ON angegeben. Die Standardeinstellungen bzw. ein durch eine vorangehende FORMAT-Anweisung gesetztes Format INPUT OFF wird für die aktuelle WRITE-Anweisung übersteuert. Um die Eingabebereitschaft des Ankreuzfelds abzuschalten, muss gleichzeitig der Zusatz INPUT OFF verwendet werden.

Hinweise

• Enthält eine Listenzeile ausschließlich ein Ankreuzfeld mit einem Leerzeichen, wird sie nicht angezeigt, wenn nicht vorher die Anweisung SET BLANK LINES ON ausgeführt wurde.

• Standardmäßig hat der Zusatz HOTSPOT ON bei einem Ankreuzfeld keine Wirkung. HOTSPOT ON wirkt nur, wenn die Eingabebereitschaft INPUT OFF abgeschaltet ist.
  
  

Beispiel

Ausgabe von zwei Ankreuzfeldern und Auswertung der Benutzereingaben beim Ereignis AT LINE-SELECTION.

Alternative 2

... AS ICON

Wirkung

Dieser Zusatz gibt Ikonen aus, wobei zu beachten ist, dass nicht alle Ikonen für Spool-Listen geeignet sind. Für dobj müssen Datenobjekte vom Typ c angegeben werden, deren Anfangszeichen vom Laufzeit-Framework als die interne Kennung einer Ikone interpretiert werden können.

In der Typgruppe ICON ist für jede darstellbare Ikone eine Konstante deklariert. Die Namen der Konstanten können der Typgruppe oder der Ausgabe des Programms SHOWICON entnommen werden. Dieses Programm zeigt auch die jeweilige Ausgabelänge an und ob eine Ikone spoolbar ist oder nicht.

Wenn der Inhalt von dobj nicht als Ikone interpretiert werden kann oder der Inhalt durch die gleichzeitige Verwendung anderer Zusätze für interne Formatierungen oder externe Formatierungen verändert wird, werden statt Ikonen Leerzeichen ausgegeben.

Hinweise

• Es ist keiner der Zusätze aus den internen Formatierungen und externen Formatierungen verboten. Bei der Verwendung ist darauf zu achten, dass der Inhalt von dobj als Ikone interpretierbar bleibt.

• Die Ausgabelänge wird wie üblich entweder implizit durch den Datentyp von dobj oder durch eine explizite Angabe bestimmt. Nicht durch die Ikone belegte Zeichen des Ausgabereichs werden mit Leerzeichen belegt.

• Die Datenbanktabelle ICONT enthält Beschreibungstexte für die Ikonen.

• Das Programm SHOWICON zeigt für jede Ikone zwei interne Kennungen:

• Eine zweistellige Hexadezimalzahl als Schlüssel.

• Eine aus Großbuchstaben und eventuellen Unterstrichen bestehende sechsstellige Zeichenfolge als interner Name.

Wenn eine mit WRITE ausgegebene Zeichenkette am Anfang eine solche interne Kennung zwischen zwei Zeichen "@" enthält, wird diese in der Listenausgabe auch ohne den Zusatz AS ICON als Ikone dargestellt. Dadurch kann es zu unbeabsichtigten Ausgaben von Ikonen und zu überraschenden Effekten bezüglich der Ausgabelänge kommen, da letztere standardmäßig durch die Länge der Zeichenkette bestimmt wird. Diese Eigenschaft kann aber auch gezielt ausgenutzt werden, beispielsweise um Ikonen am Anfang von Textsymbolen zu verwenden. Kennungen, die nicht am Anfang stehen, werden nicht als Ikone dargestellt.

Beispiel

Anzeige einer Ampel-Ikone.

Beispiel

Anzeige von Ampel-Ikonen über ihre internen Kennungen (Schlüssel und interner Name). Die Kennungen, die nicht am Anfang der Zeichenkette stehen, werden nicht verwandelt.

Alternative 3

... AS SYMBOL

Wirkung

Dieser Zusatz gibt alle Zeichen des Datenobjekts dobj als Symbole aus. In der Typgruppe SYM sind Konstanten der Länge 1 für jedes sinnvoll als Symbol darstellbare Zeichen deklariert, deren Namen die Bedeutung des jeweiligen Symbols wiedergeben. Die Namen der Konstanten und die Bedeutung und Länge der Symbole können der Typgruppe oder der Ausgabe des Programms SHOWSYMB entnommen werden.

Hinweis

Die Ausgabelänge wird wie üblich entweder implizit durch den Datentyp von dobj oder durch eine explizite Angabe bestimmt.

Beispiel

Anzeige eines Hand-Symbols.

Alternative 4

... AS LINE

Wirkung

Dieser Zusatz gibt Linienelemente der Ausgabelänge 1 aus. Linienelemente sind Ecken, Kreuze, Linien und T-Stücke. Für dobj müssen Datenobjekte vom Typ c angegeben werden, deren Inhalt vom Laufzeit-Framework als Linienelemente interpretiert werden kann. In der Typgruppe LINE sind die in der folgenden Tabelle gezeigten Konstanten für Linienelemente deklariert.

Konstante	Bedeutung
line_space	Leer
line_top_left_corner	Obere linke Ecke
line_bottom_left_corner	Untere linke Ecke
line_top_right_corner	Obere rechte Ecke
line_bottom_right_corner	Untere rechte Ecke
line_horizontal_line	Horizontaler Strich
line_vertical_line	Vertikale Linie
line_left_middle_corner	Nach links gedrehtes T-Stück
line_right_middle_corner	Nach rechts gedrehtes T-Stück
line_bottom_middle_corner	Umgedrehtes T-Stück
line_top_middle_corner	T-Stück
line_cross	Kreuz

Wenn dobj einen anderen Inhalt hat oder der Inhalt durch die gleichzeitige Verwendung anderer Zusätze für interne Formatierungen verändert wird, wird statt eines Linienelements ein Leerzeichen ausgegeben. Der Zusatz FRAMES OFF darf nicht gleichzeitig angegeben werden. Die übrigen Zusätze für externe Formatierungen und QUICKINFO werden bei der Ausgabe von Linienelementen ignoriert.

Hinweise

• Die Zeichen "-" und "|" und Ausgaben mit ULINE werden standardmäßig miteinander verbunden, wenn zwischen ihnen keine anderen Zeichen stehen. Dabei ersetzt das System die Zeichen durch obige Linienelemente. Ein allein stehendes Zeichen "|" wird immer durch eine vertikale Linie ersetzt. Die Zeichen "-" von sy-uline werden immer durch eine horizontale Linie ersetzt. Das Standardverhalten kann mit dem Zusatz FRAMES OFF abgeschaltet werden.

• Mit dem Zusatz AS LINE werden Linienelemente exakt so ausgegeben, wie sie definiert sind. Verbindungen entstehen nur dort, wo wirklich Linienelemente aufeinander treffen. Das System führt aber keine automatischen Verlängerungen zwischen den Zeichen "-" bzw. "|" und mit AS LINE explizit ausgegebenen Linienelementen durch.
  
  

Beispiel

Ausgabe von vier zusammenhängenden Rechtecken.

General Data in Customer Master   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13436 Date: 20240523 Time: 125623     sap01-206 ( 194 ms )