PolyTextOut
The PolyTextOut
function draws several strings using the font and text colors currently
selected in the specified device context.
BOOL PolyTextOut(
|
HDC hdc, |
// handle of device
context |
|
CONST POLYTEXT *pptxt, |
// address of array
of structures that identify strings |
|
int cStrings |
// number of
structures in array |
|
); |
|
Parameters
hdc
Identifies
the device context.
pptxt
Points to an
array of POLYTEXT
structures describing the strings to be drawn. The array contains one structure
for each string to be drawn.
cStrings
Specifies the
number of POLYTEXT structures in the pptxt array.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
Each POLYTEXT
structure contains the coordinates of a reference point that Windows uses to
align the corresponding string of text. An application can specify how the
reference point is used by calling the SetTextAlign function. An application
can determine the current text-alignment setting for the specified device
context by calling the GetTextAlign function.
To draw a
single string of text, the application should call the ExtTextOut
function.
See Also