Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

PolyTextOut function

The PolyTextOut function draws several strings using the font and text colors currently selected in the specified device context.

Syntax


BOOL PolyTextOut(
  _In_  HDC hdc,
  _In_  const POLYTEXT *pptxt,
  _In_  int cStrings
);

Parameters

hdc [in]

A handle to the device context.

pptxt [in]

A pointer to an array of POLYTEXT structures describing the strings to be drawn. The array contains one structure for each string to be drawn.

cStrings [in]

The number of POLYTEXT structures in the pptxt array.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

Unicode and ANSI names

PolyTextOutW (Unicode) and PolyTextOutA (ANSI)

See also

Fonts and Text Overview
Font and Text Functions
ExtTextOut
GetTextAlign
POLYTEXT
SetTextAlign

 

 

Community Additions

Show:
© 2014 Microsoft