AddFormFieldSubA

Form fields

Description

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

Adds a sub-field to the specified radio-button or choice form field.

The function returns a temporary form field Index which can be used with the

SetFormFieldBounds, SetFormFieldCheckStyle and other functions.

To set a choice item's export value and display value use the AddFormFieldChoiceSub function.

Syntax

Delphi

Function DLAddFormFieldSubA(InstanceID, Index: Integer; SubName: PAnsiChar): Integer;

DLL

int DLAddFormFieldSubA(int InstanceID, int Index, const char * SubName);

Parameters

IndexThe index of the form field to work with. The first form field has an index of 1. The name of the new sub-field. The value of the form field could be set to this name using the SetFormFieldValue function.
SubName

Return values

0The sub-field was not added. The specified form field may not have been a radio-button or choice form field.
Non-zeroA temporary field Index