THPDFPage.ExtTextOut Method
Precise text output with a per-glyph displacement array, using the same Dx semantics as the Windows GDI ExtTextOut function:
Declaration
procedure ExtTextOut(X, Y: Single; angle: Extended; Text: PWORD; TextLength: Integer; const Dx: array of Single); overload;
Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
X | Starting X coordinate of the text, in user-space units |
Y | Starting Y coordinate of the text, in user-space units |
angle | Text rotation angle, in degrees (0 = horizontal) |
Text | Text to output; the PWORD overload also takes TextLength, the WideString overload is the convenience entry point, and the AnsiString overload converts via multibyte first |
TextLength | Number of characters to output from the buffer pointed to by Text |
Dx | Distance from each character's origin to the next one, in page units. Characters land exactly where these values put them: the current character spacing, word spacing and horizontal scaling shift them no further. There is one entry per UTF-16 code unit; a character outside the Basic Multilingual Plane takes two entries and advances by their sum |
Return value
This member returns no value
Usage notes
- Use this API in the page drawing workflow before the affected page, resource, field or catalogue object is finalised
- Keep object names, field names, resource names and returned handles stable until the document is finalised
- Page-level changes affect subsequent operators on the same page; save and restore graphics state when a temporary setting should not leak