RAD Studio
ContentsIndex
PreviousUpNext
puttext

Header File 

conio.h  

Category 

Console I/O Routines 

Prototype 

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

Description 

Copies text from memory to the text mode screen. 

puttext writes the contents of the memory area pointed to by source out to the onscreen rectangle defined by left, top, right, and bottom. 

All coordinates are absolute screen coordinates, not window-relative. The upper left corner is (1,1). 

puttext places the contents of a memory area into the defined rectangle sequentially from left to right and top to bottom. 

Each position onscreen takes 2 bytes of memory: The first byte is the character in the cell, and the second is the cell’s video attribute. The space required for a rectangle w columns wide by h rows high is defined as 

bytes = (h rows) x (w columns) x 2 

puttext is a text mode function performing direct video output. 

Note:This function should not be used in Win32 GUI applications. 

Return Value 

puttext returns a nonzero value if the operation succeeds; it returns 0 if it fails (for example, if you gave coordinates outside the range of the current screen mode). 

Example  

#include <conio.h>
int main(void)
{
   char buffer[512];
   /* put some text to the console */
   clrscr();
   gotoxy(20, 12);
   cprintf("This is a test.  Press any key to continue ...");
   getch();
   /* grab screen contents */
   gettext(20, 12, 36, 21,buffer);
   clrscr();
   /* put selected characters back to the screen */
   gotoxy(20, 12);
   puttext(20, 12, 36, 21, buffer);
   getch();
   return 0;
}

Portability

POSIX 
Win32 
ANSI C 
ANSI C++ 
 
 
 
Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!