movetext

Nach oben zu conio.h - Index

Header-Datei

conio.h

Kategorie

Konsolen-Ein-/Ausgaberoutinen

Prototyp

int movetext(int left, int top, int right, int bottom, int destleft, int desttop);

Beschreibung

Kopiert auf dem Bildschirm angezeigten Text von einem Rechteck in ein anderes Rechteck.

movetext kopiert den Inhalt eines durch left, top, right und bottom definierten Rechtecks auf dem Bildschirm in ein anderes Rechteck der gleichen Größe. Die obere linke Ecke des neuen Rechtecks befindet sich an der Position (destleft, desttop).

Alle Koordinaten sind absolute Bildschirmkoordinaten. Sich überlappende Rechtecke werden korrekt verschoben.

movetext ist eine Textmodusfunktion, die Ausgaben direkt auf dem Bildschirm anzeigt.

Anmerkung:  Verwenden Sie diese Funktion auf keinen Fall in Win32-GUI-Anwendungen.

Rückgabewert

Bei erfolgreicher Ausführung gibt movetext einen Wert ungleich Null (0) zurück.

Wenn ein Fehler auftritt, gibt movetext 0 zurück (z. B. wenn die Ausführung scheitert, weil die angegebenen Koordinaten außerhalb des Bereichs des aktuellen Bildschirmmodus liegen).

Beispiel

 #include <conio.h>
 #include <string.h>
 int main(void)
 {
     char *str = "This is a test string";
     clrscr();
     cputs(str);
     getch();
     movetext(1, 1, strlen(str), 2, 10, 10);
     getch();
     return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+