GetAvailableLanguage Method (GdPictureOCR)

In This Topic

Returns a name of the specific known language dictionary available in the currently defined resource folder according to the index you have specified. You can use the GetAvailableLanguageCount method to determine the number of all available language dictionaries. The index is simply an integer value within the interval from 0 to GetAvailableLanguageCount-1.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function GetAvailableLanguage( _
   ByVal LanguageIdx As Integer _
) As OCRLanguage

public OCRLanguage GetAvailableLanguage( 
   int LanguageIdx
)

public function GetAvailableLanguage( 
    LanguageIdx: Integer
): OCRLanguage;

public function GetAvailableLanguage( 
   LanguageIdx : int
) : OCRLanguage;

public: OCRLanguage GetAvailableLanguage( 
   int LanguageIdx
)

public:
OCRLanguage GetAvailableLanguage( 
   int LanguageIdx
)

Parameters

LanguageIdx: The language dictionary index. It must be an integer value between 0 and GetAvailableLanguageCount-1.

Return Value

A member of the OCRLanguage enumeration. A specified language dictionary.

Please always use the GetStat method to determine if this method has been successful.

Remarks

Please ensure that you have correctly set up your prefered resource folder for OCR dictionaries.

It is recommend to use the GetStat method to identify the specific reason for the method's failure, if any.

Example

How to find out if the required language dictionary is available in the current resource folder.

VB.NET
C#

Dim caption As String = "Example: GetAvailableLanguage"
Using gdpictureOCR As GdPictureOCR = New GdPictureOCR()
    'Specify your resource folder for OCR dictionaries.
    gdpictureOCR.ResourcesFolder = "\GdPicture.Net 14\redist\OCR"
    Dim count As Integer = gdpictureOCR.GetAvailableLanguageCount()
    If gdpictureOCR.GetStat() = GdPictureStatus.OK Then
        If count > 0 Then
            Dim lang As OCRLanguage = 0
            Dim found As Boolean = False
            For idx As Integer = 0 To count - 1
                lang = gdpictureOCR.GetAvailableLanguage(idx)
                If gdpictureOCR.GetStat() = GdPictureStatus.OK Then
                    found = (lang = OCRLanguage.English)
                    If found Then Exit For
                Else
                    MessageBox.Show("The GetAvailableLanguage() method has failed with the status: " + gdpictureOCR.GetStat().ToString(), caption)
                    Exit For
                End If
            Next
            If gdpictureOCR.GetStat() = GdPictureStatus.OK Then MessageBox.Show("The number of available languages: " + count.ToString() + vbCrLf + "English: " + found.ToString(), caption)
        Else
            MessageBox.Show("No languages are available in this resource folder: " + gdpictureOCR.ResourcesFolder, caption)
        End If
    Else
        MessageBox.Show("The GetAvailableLanguageCount() method has failed with the status: " + gdpictureOCR.GetStat().ToString(), caption)
    End If
End Using

string caption = "Example: GetAvailableLanguage";
using (GdPictureOCR gdpictureOCR = new GdPictureOCR())
{
    //Specify your resource folder for OCR dictionaries.
    gdpictureOCR.ResourcesFolder = "\\GdPicture.Net 14\\redist\\OCR";
 
    int count = gdpictureOCR.GetAvailableLanguageCount();
    if (gdpictureOCR.GetStat() == GdPictureStatus.OK)
    {
        if (count > 0)
        {
            OCRLanguage lang = 0;
            Boolean found = false;
            for (int idx = 0; idx < count; idx++)
            {
                lang = gdpictureOCR.GetAvailableLanguage(idx);
                if (gdpictureOCR.GetStat() == GdPictureStatus.OK)
                {
                    found = (lang == OCRLanguage.English);
                    if (found) break;
                }
                else
                {
                    MessageBox.Show("The GetAvailableLanguage() method has failed with the status: " + gdpictureOCR.GetStat().ToString(), caption);
                    break;
                }
            }
            if (gdpictureOCR.GetStat() == GdPictureStatus.OK)
                MessageBox.Show("The number of available languages: " + count.ToString() + "\nEnglish: " + found.ToString(), caption);
        }
        else
            MessageBox.Show("No languages are available in this resource folder: " + gdpictureOCR.ResourcesFolder, caption);
    }
    else
        MessageBox.Show("The GetAvailableLanguageCount() method has failed with the status: " + gdpictureOCR.GetStat().ToString(), caption);
}

Reference

GdPictureOCR Class
GdPictureOCR Members
GetAvailableLanguageCount Method
GetAvailableLanguages Method
AddLanguage Method
ResourcesFolder Property