puttext

Nach oben zu conio.h - Index

Header-Datei

conio.h

Kategorie

Konsolen-Ein-/Ausgaberoutinen

Prototyp

int puttext(int left, int top, int right, int bottom, void *source);

Beschreibung

Kopiert Text aus dem Speicher in das Textmodusfenster.

puttext gibt den Inhalt des Speicherbereichs, auf den source zeigt, in das durch left, top, right und bottom definierte Rechteck auf dem Bildschirm aus.

Alle Koordinaten sind absolute Bildschirmkoordinaten und nicht fensterbezogen. Die obere linke Ecke hat die Koordinaten (1,1).

puttext fügt den Inhalt eines Speicherbereichs nacheinander von links nach rechts und von oben nach unten in das definierte Rechteck ein.

Jede Bildschirmposition wird im Speicher durch 2 Bytes dargestellt: Das erste Byte enthält das in der Zelle befindliche Zeichen, und das zweite Byte enthält das Grafikattribut der Zelle. Der Speicherbedarf für ein Rechteck mit einer Breite von w Spalten und einer Höhe von h Zielen ist wie folgt definiert:

Bytes = (h Zeilen) x (w Spalten) x 2

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

Anmerkung:  Diese Funktion sollte in Win32-GUI-Anwendungen nicht verwendet werden.

Rückgabewert

puttext gibt einen Wert ungleich Null zurück, wenn die Ausführung erfolgreich war. Im Fehlerfall (z. B. wenn die angegebenen Koordinaten außerhalb des Bereichs des aktuellen Bildschirmmodus liegen) gibt die Funktion 0 zurück.

Beispiel

 #include <conio.h>
 int main(void)
 {
    char buffer[512];
    /* Text auf der Konsole ausgeben */
    clrscr();
    gotoxy(20, 12);
    cprintf("This is a test.  Press any key to continue ...");
    getch();
    /* Bildschirminhalt erfassen */
    gettext(20, 12, 36, 21,buffer);
    clrscr();
    /* Ausgewählte Zeichen wieder auf dem Bildschirm ausgeben */
    gotoxy(20, 12);
    puttext(20, 12, 36, 21, buffer);
    getch();
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+