gettext

Nach oben zu conio.h - Index

Header-Datei

conio.h

Kategorie

Konsolen-Ein-/Ausgaberoutinen

Prototyp

int gettext(int left, int top, int right, int bottom, void *destin);

Beschreibung

Kopiert Text aus einem Textmodusfenster in den Speicher.

gettext speichert den Textinhalt des rechteckigen Bildschirmbereichs, der durch left, top, right und bottom definiert ist, und speichert diesen in dem Speicherbereich, auf den destin zeigt.

Alle Koordinaten sind absolute Bildschirmkoordinaten und nicht fensterbezogen. Die obere linke Ecke hat die Koordinaten (1,1). gettext liest den Inhalt des Rechtecks sequenziell von links nach rechts und von oben nach unten in den Speicher 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

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

Rückgabewert

gettext gibt 1 zurück, wenn die Operation erfolgreich war.

Wenn ein Fehler auftritt, ist der Rückgabewert 0 (z. B. wenn die Ausführung scheitert, weil die angegebenen Koordinaten außerhalb des Bereichs des aktuellen Bildschirmmodus liegen).

Beispiel

 #include <conio.h>
 
 char buffer[4096];
 int main(void)
 {
    int i;
    clrscr();
    for (i = 0; i <= 20; i++)
       cprintf("Line #%d\r\n", i);
    gettext(1, 1, 80, 25, buffer);
    gotoxy(1, 25);
    cprintf("Press any key to clear screen...");
    getch();
    clrscr();
    gotoxy(1, 25);
    cprintf("Press any key to restore screen...");
    getch();
    puttext(1, 1, 80, 25, buffer);
    gotoxy(1, 25);
    cprintf("Press any key to quit...");
    getch();
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+