API referenceText

pdfBeginContinueText

Start a "typewriter" text-continuation cursor at a starting

CategoryText 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

C
int32_t __stdcall pdfBeginContinueText(PPDF IPDF, double PosX, double PosY);
Delphi
function pdfBeginContinueText(const IPDF: PPDF; PosX, PosY: Double): Integer; stdcall; external 'LumasPdf.dll';

Parameters

ParameterTypeDescription
IPDFPPDFInstance handle.
PosX, PosYDoubleStarting cursor position for the first line.

Return value1 on a valid handle (this call has no failure path beyond an invalid handle, which returns 0).

RemarkspdfSetLeading'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 alsopdfEndContinueText

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
public static extern int pdfBeginContinueText(IntPtr IPDF, double PosX, double PosY);
Area
Text
Category

Core

Exported names

pdfBeginContinueText

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.