BeginTilingPatternA

Vector graphics, Page layout

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to BeginTilingPattern and string arguments are interpreted using the current SetAnsiMode code page

Starts a temporary tiling-pattern drawing surface with the requested pattern name, width, and height

While the build is active, normal drawing calls write to the temporary page selected by this function

Finish the build with EndTilingPattern to register the pattern, or call CancelTilingPattern to discard the temporary drawing surface

Syntax

Delphi

Function DLBeginTilingPatternA(InstanceID: Integer; PatternName: PAnsiChar; Width, Height: Double): Integer;

DLL

int DLBeginTilingPatternA(int InstanceID, const char * PatternName, double Width, double Height);

Parameters

PatternName	Name used later by `SetFillTilingPattern`, `SetLineTilingPattern`, or `SetTextTilingPattern`
Width	The pattern cell width in PDF units
Height	The pattern cell height in PDF units

Return values

0	The name or dimensions were invalid, a reusable-surface build was already active, the name already exists, or the temporary drawing surface could not be created
1	The tiling-pattern drawing surface was created and selected

Remarks

Do not select another page or document until the build is ended or canceled; drawing commands should target the temporary page selected by BeginTilingPattern

The registered pattern can be reused across pages through SetFillTilingPattern, SetLineTilingPattern, and SetTextTilingPattern