pdfBeginContinueText
Start a "typewriter" text-continuation cursor at a starting
| Category | Text output |
|---|
Purpose — Start a "typewriter" text-continuation cursor at a starting position, for a sequence of line-by-line writes without recomputing Y positions yourself.
Description — Arms an internal cursor (FContActive, FContX/Y) at (PosX, PosY). Each subsequent call to pdfAddContinueTextA/W (V12 chapter — not itself a V06 API, but this mechanism is meaningless without it) draws one line at the current cursor position via pdfWriteText's underlying writer, then advances the cursor down by FCurrentFontSize * 1.2 — a fixed 1.2 line-height factor, not whatever leading you set via pdfSetLeading. Call pdfEndContinueText when done.
Declarations
int32_t __stdcall pdfBeginContinueText(PPDF IPDF, double PosX, double PosY);
function pdfBeginContinueText(const IPDF: PPDF; PosX, PosY: Double): Integer; stdcall; external 'LumasPdf.dll';
Parameters
| Parameter | Type | Description |
|---|---|---|
IPDF | PPDF | Instance handle. |
PosX, PosY | Double | Starting cursor position for the first line. |
Return value — 1 on a valid handle (this call has no failure path beyond an invalid handle, which returns 0).
Remarks — pdfSetLeading's value is not consulted by this mechanism — the 1.2 factor is hardcoded. If you need custom leading between lines, compute Y positions yourself and call pdfWriteText/Ex per line instead of this API.
See also — pdfEndContinueText
C# (P/Invoke)
public static extern int pdfBeginContinueText(IntPtr IPDF, double PosX, double PosY);
Core
pdfBeginContinueText
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.