Draw text within an area
int PgDrawTextArea( char const *ptr, int len, PhRect_t const *rect, int flags ); int PgDrawTextAreaCx( void *dc, char const *ptr, int len, PhRect_t const *rect, int flags );
These functions draw text within an area, using the font specified by a previous call to PgSetFont*(). This area is clipped to the dimensions of the rectangle specified by the PhRect_t structure pointed to by rect.
The len parameter specifies the number of bytes required to store the string. For pure ASCII strings (characters 0 to 127), this is the number of characters. For multibyte strings, len may be larger than the number of characters. For double-byte strings, len is twice the number of characters.
By default, the text is left-aligned (Pg_TEXT_LEFT), and the text is drawn with its baseline centered inside the drawing area.
The flags can be a combination of:
PgDrawTextArea() works on the current draw context, while you can specify the draw context dc for PgDrawTextAreaCx().
PgDrawTextArea() doesn't work in any context that involves the render library, such as printing or Phindows. If your application needs to use the render library, you should:
PgDrawMultiTextArea*(), PgDrawString*(), PgDrawText*(), PgFlush*(), PgSetFillColor*(), PgSetFillDither*(), PgSetFillTransPat*(), PgSetFont*(), PgSetTextColor*(), PgSetTextDither*(), PgSetTextTransPat*(), PgSetTextXORColor*(), PgSetUnderline(), PhRect_t
“Text” in the Raw Drawing and Animation chapter of the Photon Programmer's Guide