SetFormFieldColorSepA
Form fields, Colour
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 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 DLSetFormFieldColorSepA(InstanceID, Index: Integer; ColorName: PAnsiChar; Tint: Double): Integer;
DLL
int DLSetFormFieldColorSepA(int InstanceID, int Index, const char * ColorName, double Tint);
Parameters
| Index | The index of the form field |
|---|---|
| ColorName | The name of the separation colour that was used with the [f:AddSeparationColor] function |
| Tint | The amount of colour to use. 0 indicates no colour (white), 1 indicates maximum colour. |
Return values
| 0 | The form field could not be found, or the separation colour name could not be found |
|---|---|
| 1 | The text colour of the specified form field was set successfully |