API referencePDF/A & Conformance

pdfAddContinueText

Write one more line of text at the "continue text" cursor

C
int32_t __stdcall pdfAddContinueTextA(PPDF IPDF, const char* AText);
int32_t __stdcall pdfAddContinueTextW(PPDF IPDF, const wchar_t* AText);
Delphi
function pdfAddContinueTextA(const IPDF: PPDF; const AText: PAnsiChar): Integer; stdcall;
function pdfAddContinueTextW(const IPDF: PPDF; const AText: PWideChar): Integer; stdcall;

Purpose. Write one more line of text at the "continue text" cursor established by pdfBeginContinueText (Core Text Output) — a simple manual text-flow helper: each call writes AText at the current cursor position, then advances the cursor down by one line (1.2 × the current font size, a standard single-line-spacing leading multiple).

Description. Requires an active continue-text session (FContActive, set by pdfBeginContinueText) — a no-op returning 0 otherwise. The line-advance happens even if AText is empty — calling this with an empty string is therefore a valid way to insert a blank line.

Parameters.

ParameterDescription
IPDFDocument handle.
ATextThe line of text to write (may be empty, to skip a blank line).

Return value. 1 if a continue-text session is active (regardless of whether AText was empty); 0 if no session is active.

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
public static extern int pdfAddContinueTextA(IntPtr IPDF, [MarshalAs(UnmanagedType.LPStr)] string AText);
public static extern int pdfAddContinueTextW(IntPtr IPDF, [MarshalAs(UnmanagedType.LPWStr)] string AText);
Area
PDF/A & Conformance
Category

Content Creation

Exported names

pdfAddContinueTextA pdfAddContinueTextW

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.