SetFormFieldColorSepA

Form fields, Color

Description

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

Sets the color of the text in the specified form field. Similar to the SetFormFieldBorderColor function, but a tint of a separation color added with the AddSeparationColor function is used. The PDF specification does not support separation color spaces for form fields, so the results may not always work, especially if the form field is later edited in Acrobat. This feature has been added for situations where the form field will be flattened.

Syntax

Delphi

Function DLSetFormFieldColorSepA(InstanceID, Index: Integer; ColorName: PAnsiChar; Tint: Double): Integer;

DLL

int DLSetFormFieldColorSepA(int InstanceID, int Index, const char * ColorName, double Tint);

Parameters

IndexThe index of the form field
ColorNameThe name of the separation color that was used with the [f:AddSeparationColor] function
TintThe amount of color to use. 0 indicates no color (white), 1 indicates maximum color.

Return values

0The form field could not be found, or the separation color name could not be found
1The text color of the specified form field was set successfully