SwapText [SWT]

Top  Previous  Next

Ersetzen von Swaptexten.

Mit SwapText können Swaptexte, d.h. Platzhalter für Texte, durch festen Text ersetzt werden. Swaptexte können durch die Funktion AddText erzeugt werden. Die Swaptexte können durch verschiedene Funktionalitäten im Dialog sowohl einzeln als auch in Gruppen ersetzt werden.

Ein Teil der Funktionalität wird über Funktionsparameter gesteuert (alle Parameter sind nicht case-sensitiv).

Voraussetzung

Eine Datenbank muß eröffnet sein.

Swaptexte müssen existieren.

Parameter

/LOOP

Der Parameter bewirkt eine beliebige Wiederholung des Dialogs.

Die Angabe des Parameters ist optional und erfolgt in der Form /LOOP. Fehlt der Parameter, oder ist ein Dialogdurchlauf über die Parameter SEQ bzw. SEQ/n oder n vordefiniert, so wird der Dialog nur genau einmal durchlaufen.

/SINGLE

Der Parameter erzwingt, daß für alle vorzunehmenden Swaptext-Ersetzungen immer der gleiche Ersetzungstext verwendet wird.

Die Angabe des Parameters ist optional und erfolgt in der Form /SINGLE.

TEX/n

Es wird die Referenznummer zur Übernahme eines Textes aus der Texttabelle oder aus dem Textpuffer (-1 als Referenznummer) festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form TEX/n, wobei n aus den natürlichen Zahlen einschließlich der -1 gewählt werden kann. Dabei bedeutet die -1 eine Übernahme des Textes aus dem Textpuffer. Fehlt der Parameter oder entspricht er keiner gültigen Referenznummer, so wird der Ersetzungstext über den Dialog bestimmt.

ZOOM/x

Es wird der Radius in Meter für die Ausschnittsvergrößerung um den Textbezugspunkt festgelegt. Der ursprünglich sichtbare Grafikausschnitt wird automatisch nach jedem Dialogdurchlauf wieder zurückgesetzt.

Die Angabe des Parameters ist optional und erfolgt in der Form ZOOM/x, wobei x aus den echt positiven reellen Zahlen genommen werden kann. Fehlt der Parameter oder wird er kleiner als die Plangenauigkeit angegeben, findet keine Ausschnittseinblendung statt.

SEQ/n

Der Parameter legt fest, daß alle restlichen Swaptexte ab der angegebenen Sequenznummer ersetzt werden.

Die Angabe des Parameters ist optional und erfolgt entweder in der Form SEQ oder in der Form SEQ/n, wobei die Angabe SEQ identisch mit der Angabe SEQ/1 ist. Die Sequenznummer n kann aus dem Bereich der natürlichen Zahlen gewählt werden und muß selbst keinem Swaptext entsprechen – vielmehr werden alle Swaptexte berücksichtigt, die die identische oder eine höhere Nummer besitzen.

/H

Es wird eine Hilfe für die Funktion SwapText gegeben. Der Hilfetext 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).

n

Jede Zeichenfolge, die keinem der vorangehenden Parameter entspricht wird automatisch als Swaptextnummer interpretiert. Im Gegensatz zum Parameter SEQ/n wird hier ausschließlich der Swaptext mit der Nummer n bearbeitet.

Rückgabewert

Wert

Beschreibung

0

Aufruf wurde erfolgreich durchgeführt

sonst

Fehler aufgetreten

Dialog

Eingabe des globalen Ersetzungstextes: (s)

(falls der Parameter SINGLE aktiv und der Parameter TEX inaktiv sind)

Angabe des Verfahrens: <P,CON> (s)

(falls dieses noch nicht über die Funktionsparameter definiert wurde)

Eingabe des Ersetzungstextes: (s)

(falls dieser noch nicht definiert ist)

Die Dialogpunkte 2. und 3. werden evtl. mehrfach wiederholt, falls der Parameter LOOP mit angegeben wurde. Der Dialogpunkt 3. kann zudem innerhalb jeder Wiederholung mehrfach wiederholt werden, falls ein Sequenzverfahren gewählt wurde. Eine Sequenzeingabe kann durch die Eingabe eines Leerstrings abgebrochen werden.

Die Funktion kann über die Eingabe von CON im Dialogpunkt 3. verlassen werden

Wird eine unerlaubte Eingabe gemacht, so wird eine Fehlermeldung veranlaßt und der Dialog wird entweder wiederholt oder ganz verlassen.

Beispiel

Kommandozeileneingabe:

SwapText /LOOP /SINGLE ZOOM/25

SwapText SEQ/5 TEX/3

SwapText SEQ

SwapText ZOOM/30 14

SwapText /H

SwapText

Ersetzen des Swaptextes Nummer 4:

SwapText 4

Ersetzungstext für „SWT4“: (s) Dies ist ein Text

SwapText

Verfahren angeben: <P,CON> (s) 4

Ersetzungstext für „SWT4“: (s) Dies ist ein Text

Mehrere Swaptexte nach verschiedenen Verfahren ersetzten:

SwapText /LOOP

Verfahren angeben: <P,CON> (s) 4

Ersetzungstext für „SWT4“: (s) Dies ist ein Text

Verfahren angeben: <P,CON> (s) SEQ/8

Ersetzungstext für „SWT8“: (s) Katzenbeiser

Ersetzungstext für „SWT9“: (s) Trollinger

Ersetzungstext für „SWT10“: (s) Lemberger

Ersetzungstext für „SWT11“: (s)

Verfahren angeben: <P,CON> (s) SEQ

Ersetzungstext für „SWT1“: (s) Weißherbst

Ersetzungstext für „SWT2“: (s) Rose

Ersetzungstext für „SWT3“: (s)

Verfahren angeben: <P,CON> (s) #CON

Ausschnitt von 25 x 25 Meter um Swaptext beim Ersetzten sichtbar machen:

SwapText ZOOM/25

Verfahren angeben: <P,CON> (s) 45

Ersetzungstext für „SWT45“: (s) Dies ist ein Text

SwapText Nummer 6 automatisch durch den Textpuffer ersetzen:

SwapText 6 TEX/-1

SwapText Nummer 6 automatisch durch den Eintrag Nummer 15 der aktuellen Texttabelle ersetzen:

SwapText 6 TEX/15

Alle SwapTexte durch den Text „Moskito“ ersetzen:

SwapText SEQ /SINGLE

Globalen Ersetzungstext eingeben: (s) Moskito

Alle SwapTexte automatisch durch den Text aus dem Textpuffer ersetzen:

SwapText SEQ /SINGLE TEX/-1

Die SwapTexte k...n durch die entsprechenden Texte aus der Texttabelleneinträgen j...(j+n-k) ersetzen:

SwapText SEQ/k TEX/j

Bemerkung

Wird einer der Kommandozeilenparameter n, SEQ oder SEQ/n angegeben, so wird der Parameter LOOP ignoriert.

Soll eine ganze Sequenze von Swaptexten ersetzt werden, so ist es bei der Eingabe von SEQ/n nicht nötig für n eine gültige Swaptextnummer zu wählen. Handelt es sich bei n um keine gültige Nummer, so wird automatisch bei der nächsten gültigen Swaptextnummer begonnen.

Ist eine Fortsetzung des Dialogs nicht mehr sinnvoll, weil keine Swaptexte mehr vorhanden sind, so wird der Dialog automatisch beendet.

Siehe auch