POLYTEXTW structure (wingdi.h)
The POLYTEXT structure describes how the PolyTextOut function should draw a string of text.
Syntax
typedef struct tagPOLYTEXTW {
int x;
int y;
UINT n;
LPCWSTR lpstr;
UINT uiFlags;
RECT rcl;
int *pdx;
} POLYTEXTW, *PPOLYTEXTW, *NPPOLYTEXTW, *LPPOLYTEXTW;
Members
x
The horizontal reference point for the string. The string is aligned to this point using the current text-alignment mode.
y
The vertical reference point for the string. The string is aligned to this point using the current text-alignment mode.
n
The length of the string pointed to by lpstr.
lpstr
Pointer to a string of text to be drawn by the PolyTextOut function. This string need not be null-terminated, since n specifies the length of the string.
uiFlags
Specifies whether the string is to be opaque or clipped and whether the string is accompanied by an array of character-width values. This member can be one or more of the following values.
| Value | Meaning |
|---|---|
| ETO_OPAQUE | The rectangle for each string is to be opaqued with the current background color. |
| ETO_CLIPPED | Each string is to be clipped to its specified rectangle. |
rcl
A rectangle structure that contains the dimensions of the opaquing or clipping rectangle. This member is ignored if neither of the ETO_OPAQUE nor the ETO_CLIPPED value is specified for the uiFlags member.
pdx
Pointer to an array containing the width value for each character in the string.
Remarks
Note
The wingdi.h header defines POLYTEXT as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | wingdi.h (include Windows.h) |