AddTextToBuffer [TQL]

--------------------OLD_TEXT---------------------

AddTextToBuffer [TQL]

 

Top  Previous  Next

Füge einen Text in den Textzwischenspeicher ein.

Mit AddTextToBuffer wird ein Text in den Textpuffer eingefügt. Der Text kann dabei entweder direkt über die Kommandozeile mitgegeben oder als Attributwert eines Objekts eingelesen werden.

Zusätzlich können einige Funktionsparameter schon in der Kommandozeile übergeben werden (alle Parameter sind nicht case-sensitiv).

Voraussetzung

Die Datenbank muß eröffnet sein

Ein Objekt muß eröffnet sein.

Parameter

LBL/

Es wird der Attributname festgelegt, dessen zugehöriger Attributwert den Text enthält.

Die Angabe des Parameters ist zwingend und erfolgt in der Form LBL/s, wobei s ein beliebiges Textwort sein darf. Wird der Parameter nicht mit angegeben, so wird ein eigens dafür vorgesehener Dialog gestartet.

<TEXT>

Jede Zeichenfolge, die keinem der vorangehenden Parameter entspricht wird automatisch als Text interpretiert. Soll die Zeichenfolge ein oder mehrere Leerzeichen enthalten, muß sie entsprechend durch Hochkommata eingeschloßen werden.

/H

Es wird eine Hilfe für die Funktion AddTextToBuffer gegeben. Der Hilfstext enthält eine kurze Beschreibung der Funktion sowie eine Aufrufanleitung.

Die Angabe des Parameters ist optional und erfolgt in der Form -H oder /H (äquivalente Eingaben).

Rückgabewert

Wert

Beschreibung

0

Aufruf wurde erfolgreich durchgeführt

Sonst

Fehler aufgetreten

Dialog

Attributname angeben, falls noch kein Text definiert wurde: (s)

Der Dialog kann jederzeit über die Eingabe von #CON verlassen werden. Es findet dann keine Textablage im Textpuffer statt.

Wird eine unerlaubte Eingabe gemacht oder das entsprechend ausgewählte Attribut nicht gefunden, so wird eine Fehlermeldung veranlaßt und der Dialog wird entweder wiederholt oder ganz verlassen.

Beispiel

Kommandozeileneingabe

AddTextToBuffer LBL/txt

AddTextToBuffer „Dies ist ein Text“

AddTextToBuffer /H

AddTextToBuffer

Text in den Textpuffer einfügen

Attributnamen angeben: (s) BLA

Zugehöriger Attributwert wird als Text interpretiert und in den Zwischenspeicher (Textpuffer) eingefügt.

Attributnamen angeben: (s) #CON

Abbruch des Dialogs und ver-lassen der Funktion, ohne das eine Aktion stattfindet.

Bemerkung

Siehe auch

 

--------------------OLD_TEXT---------------------

Insert a text in the text buffer.

With AddTextToBuffer if a text is inserted in the text buffer. Besides, the text can be given either directly about the command line, or be read in as an attribute value of an object.

In addition, some functional parametres can be already handed over in the command line (all parametres do not case sensitively).

Condition

The data bank must be opened

An object must be opened.

Parametre

LBL/

The attribute name whose accompanying attribute value contains the text is fixed.

The information of the parametre is compelling and occurs in the form LBL/PAGE, and see any text word may be. If the parametre with is not given, a dialogue specially intended for it is begun.

<TEXT>

Every sign result which corresponds to none of the preliminary parametres is automatically interpreted as a text. Should the sign result contain one or several blanks, it must be enclosed accordingly by single quotation marks.

/H

It becomes a help to the function AddTextToBuffer given. The auxiliary text contains a short description of the function as well as call instructions.

The information of the parametre is optional and occurs in the form -H or /H (equivalent inputs).

Return value

Value

Description

0

Call was carried out successfully

But

Mistake appeared

Dialogue

Attribute name brag, if still no text was defined: (s)

The dialogue is able any time about the input of #CON are left. Then no text filing takes place in the text buffer.

If an unauthorised input is made or the accordingly well-chosen attribute is not found, an error message is arranged and the dialogue is either repeated or is completely left.

Example

Command line input

AddTextToBuffer LBL/txt

AddTextToBuffer „This is a text“

AddTextToBuffer/H

AddTextToBuffer

Text insert in the text buffer

Attribute names brag: (s) BLA

Accompanying attribute value is interpreted as a text and is inserted in the buffer (text buffer).

Attribute names brag: (s) #CON

Demolition of the dialogue and abandonment of the function without which an action takes place.

Remark

See also