AddFormFieldChoiceSubA
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 AddFormFieldChoiceSub and string arguments are interpreted using the current SetAnsiMode code page
Similar to the AddFormFieldSub function but allows a choice field item's export value and display value to be set.
The function returns a temporary form field Index which can be used with the
SetFormFieldBounds, SetFormFieldCheckStyle and other functions.
Syntax
Delphi
Function DLAddFormFieldChoiceSubA(InstanceID, Index: Integer; SubName, DisplayName: PAnsiChar): Integer;
DLL
int DLAddFormFieldChoiceSubA(int InstanceID, int Index, const char * SubName, const char * DisplayName);
Parameters
| Index | The index of the form field to work with. The first form field has an index of 1. The form field must be a choice field. |
|---|---|
| SubName | The export value of the new sub-field. The value of the form field could be set to this name using the SetFormFieldValue function. The display name of the new sub-field. |
| DisplayName |
Return values
| 0 | The sub-field was not added. The specified form field may not have been a choice form field. |
|---|---|
| Non-zero | A temporary field Index |