SetFormFieldColorSep

Form fields, Colour

Description

Sets the colour of the text in the specified form field. Similar to the SetFormFieldBorderColor function, but a tint of a separation colour added with the AddSeparationColor function is used. The PDF specification does not support separation colour 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 TPDFlib.SetFormFieldColorSep(Index: Integer; Const ColorName: WideString; Tint: Double): Integer;

ActiveX

Function PDFlib::SetFormFieldColorSep(Index As Long, ColorName As String, Tint As Double) As Long

DLL

int DLSetFormFieldColorSep(int InstanceID, int Index, wchar_t * ColorName, double Tint);

Parameters

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

Return values

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