.

.

.

ENDTEXT

 

Siehe auch: ECHO, ECHOS, SCREEN, SCRPUT, und VSCRPUT.

 

Verwendung:

 

TEXT kann nur in Batch-Dateien verwendet werden. Sowohl TEXT als auch ENDTEXT müssen als einzige Befehle in der jeweiligen Zeile eingegeben werden und können nicht in eine Befehlsgruppe aufgenommen werden .

 

Der Befehl TEXT ist nützlich für die Anzeige von Menüs, Tabellen, Sonderzeichen oder mehrzeiligen Meldungen. TEXT zeigt alle Zeilen in der Batchdatei zwischen sich selbst und dem abschließenden ENDTEXT an. Die Anzeige beginnt an der aktuellen Anzeigeposition, was es Ihnen ermöglicht, die Anzeige mit anderem Text zu beginnen, z. B. mit dem Befehl ECHOS.

 

Die Zeilen zwischen TEXT und ENDTEXT werden nicht geparst. Folglich wird keine Expansion von Umgebungsvariablen oder eine andere Verarbeitung durchgeführt, und alle Zeilen werden genau so angezeigt, wie sie in der Stapeldatei gespeichert sind, vorbehaltlich der Wahl der Schriftart und etwaiger Unterschiede zwischen dem Programm, das die Datei erstellt hat, und dem Programm, das während der Ausführung der Datei in Kraft ist. Dies erleichtert das Einfügen von Sonderzeichen, z. B.< | >, in den Text. Wenn jedoch die ANSI X3.64-Interpretationsoption aktiviert ist, können Sie die Bildschirmfarben durch Einfügen von ANSI X3.64-Escape-Sequenzen an beliebiger Stelle in den Textblock ändern. Der ENDTEXT-Befehl selbst wird nicht angezeigt.

 

Sie können auch den  CLS- oder den  COLOR-Befehlverwenden , um die Standard-Bildschirmfarben vor der Ausführung von TEXT festzulegen.

 

Umleitung derTEXT-Ausgabe

 

Um den gesamten Textblock umzuleiten, können Sie den TEXT-Befehl selbst umleiten, wie in den folgenden Beispielen gezeigt. Wie bei jedem anderen Befehl wird diese Umleitung nicht durch die Umleitung der gesamten Ausgabe der Batchdatei durch den Befehl beeinflusst, der die Batchdatei gestartet hat. Der Versuch, die eigentlichen Textzeilen umzuleiten oder zu puffern, wird ignoriert. Der Versuch, die ENDTEXT-Zeile umzuleiten oder weiterzuleiten, ist ungültig.

 

Warnung: Wenn der TEXT-Befehl umgeleitet oder weitergeleitet wird und die Umleitung bzw. Weiterleitung fehlschlägt, werden die auf den TEXT-Befehl folgenden Zeilen der Batch-Datei  wie Befehle ausgeführt, was zu Schäden führen kann. Der einfachste Weg, diese Probleme zu vermeiden, ist die Verwendung des ON ERROR-Befehls vor TEXT. Siehe das zweite Beispiel unten.

 

Beispiele:

 

Das folgende Batchdateifragment zeigt ein einfaches Menü an:

 

@echo off & cls

screen 2 0

text

Enter one of the following:

 1 - Spreadsheet

 2 - Word Processing

 3 - Utilities

 4 - Exit

endtext

inkey /k"1234" Enter your selection: %%key

 

Das folgende Beispiel verwendet TEXT zur Anzeige oder zum Anhängen an eine Datei (die als optionaler Parameter der Batchdatei angegeben wird):

 

@echo off

setlocal

setdos /x-6

set dest=%@if[%# GT 0,>> %1,]

setdos /x+6

set repeat=0

on error (unset dest & goto PROBLEM)

:PROBLEM

iff %repeat GT 1 then

echo Repeated problems - quitting

quit

endiff

set repeat=%@inc[%repeat]

text %dest

+----------------+

| Logical Drives |

+----------------+

endtext

subst %dest

echo. %dest

if %_transient eq 1 .and. %# EQ 0 pause

endlocal