SetCairoFileNameA

Miscellaneous functions

Description

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

Sets the path and file name of the Cairo DLL. The SelectRenderer function can be used to select the Cairo renderer rather than the default GDI+ renderer.

The Cairo DLL is usually dependent on other DLLs. If these are not all stored in the same directory as the application, or a system directory, the Windows API function SetDllDirectory should be used to add the correct path before calling any rendering functions.

Rendering using Cairo is currently experimental.

Syntax

Delphi

Function DLSetCairoFileNameA(InstanceID: Integer; FileName: PAnsiChar): Integer;

DLL

int DLSetCairoFileNameA(int InstanceID, const char * FileName);

Parameters

FileNameThe path and file name of the Cairo DLL.

Return values

0The specified DLL was not a valid Cairo DLL
1The specified Cairo DLL was valid