set_AltConfidenceString

The set_AltConfidenceString method sets the confidence level of each character in the referenced field.

Description

Important: .NET only. For VBScript, use the AltConfidenceString property instead.

The confidence level of each character is a digit from 0 (lowest confidence) to 9 (highest confidence). For example, if the confidence level for a four-character field is 9999, each of the 4 characters has a confidence level of 9.

<F id="Vendor">
   <V n="TYPE">Vendor</V>
   <V n="Position">0,0,0,0</V>
   <V n="STATUS">1</V>
   <C cn="6,8,10" cr=0,0,0,0">83,49,53</C>
   <C cn="6,8,10" cr=0,0,0,0">116,50,54</C>
   <C cn="6,8,10" cr=0,0,0,0">105,51,55</C>
   <C cn="6,8,10" cr=0,0,0,0">110,52,56</C>
</F>

In the sample XML file, the primary confidence level is 6. The first alternative confidence level is 8, and the second alternative confidence level is 10. The value that is stored is always the value set + 1.

Syntax

C#

void set_AltConfidenceString(int nIndex, string pVal)

Applies to

Field objects only

Arguments

nIndex: 0 specifies the primary value. Where the field contains multiple recognition, voting, or multipass data entry values, 1 specifies the first alternative, 2 specifies the second alternative, and son on. (See the following example).
pVal: A string that contains containing the confidence level of each character (for example, "9999"). The digits that are stored in the page XML file are always one greater than the digits you specify in pVal (See the following example).

Comments

To set or get the primary confidence level, you can also use the ConfidenceString property.
To set or get the confidence level on individual characters, use set_CharConfidence or get_CharConfidence.

Example