Access Alternate Character Results

Use the CharacterResult.NumberResults property to determine how many results are available for this CharacterResult. The first result is considered to be the primary result, and other results are alternates. The value of NumberResults is equal to the count of alternative results plus one primary result.

The primary result is the result for which MICR Xpress has the highest confidence; alternate results are sorted with descending confidence. Use the CharacterResult.Text and CharacterResult.Confidence methods to access the primary and alternate results.

A value of 0 for the index argument to these methods will give the primary result text/confidence and a value greater than 0 for the index will give alternate results’ text/confidence.

C# Example	Copy Code
... CharacterResult myCharacterResult = myTextLineResult.Character( i ); // Iterate through the list of alternate results. We start at alternate result // index 1 because the first alternate index is the primary result that // is accessed through the CharacterResult.Text and // CharacterResult.Confidence properties. for (int altResultIndex = 1; altResultIndex < myCharacterResult.NumberResults; altResultIndex++) { String alternateResultText = myCharacterResult.AlternateText( altResultIndex ); int alternateResultConfidence = myCharacterResult.AlternateConfidence( altResultIndex ); // do something with the alternate results } ...

C# Example

Copy Code

...
CharacterResult myCharacterResult = myTextLineResult.Character( i );
// Iterate through the list of alternate results. We start at alternate result
// index 1 because the first alternate index is the primary result that
// is accessed through the CharacterResult.Text and
// CharacterResult.Confidence properties.
for (int altResultIndex = 1; altResultIndex < myCharacterResult.NumberResults; altResultIndex++)
{
  String alternateResultText = myCharacterResult.AlternateText( altResultIndex );
  int alternateResultConfidence = myCharacterResult.AlternateConfidence( altResultIndex );
  // do something with the alternate results
}
...