2.13 Text Functions

Text functions retrieve text information, alter text alignment, alter text justification, and write text on a device or display surface. GDI uses the current font for text output. Following are the GDI text functions:

Function Description

ExtTextOut Writes a character string, within a rectangular region, using the currently selected font. The rectangular region can be opaque (filled with the current background color). It can also be a clipping region.
GetTextAlign Returns a mask of the text alignment flags.
GetTextCharacterExtra Retrieves the current setting for the amount of intercharacter spacing.
GetTextExtent Uses the current font to compute the width and height of text.
GetTextExtentPoint Retrieves dimensions of string.
SetTextAlign Positions a string of text on a display or device.
SetTextCharacterExtra Sets the amount of intercharacter spacing.
SetTextJustification Justifies a text line.
TextOut Writes a character string using the current font.

The USER API also includes the following text functions:

Function Description

DrawText Draws formatted text into a rectangle.
GetTabbedTextExtent Computes the width and height of a line of text containing tab characters.
GrayString Draws gray text by writing the text in a memory bitmap and graying the bitmap. Then it copies the bitmap to the display.
TabbedTextOut Writes a character string with expanded tabs, using the current font.

For more information about these USER functions, see Chapter 1, “Window Management.”