TextLanguage オブジェクト（ITextLanguage インターフェイス）

このオブジェクトは、テキストの認識言語を表します。一般に、テキスト言語は、基本言語のセット、または単一の単語の言語です。テキストの基本言語のコレクションには、BaseLanguages プロパティを通じてアクセスできます。また、このオブジェクトでは、内部名や文字セットのグループなど、さまざまなテキスト言語属性にアクセスするためのメソッドを利用できます。

TextLanguage オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドが使用されます。

Linux: SaveToFile、および LoadFromFile

Windows SaveToFile、LoadFromFile、SaveToMemory、および LoadFromMemory。

​

プロパティ

	, 読み取り専用	Engine オブジェクトを返します。
		テキスト言語の内部名を格納します。内部名は言語の識別に使用される場合があるため、一意であることが望まれます。 TextLanguage 型の新しいオブジェクトが作成されると、このプロパティには空文字列が格納されます。他のテキスト言語と区別できるように、一意の値を割り当てることができます。 既定では、このプロパティには空文字列が格納されます。
		テキスト言語に追加の文字セットを設定します。
	, 読み取り専用	この TextLanguage で認識に使用される文字セット全体を返します。これは、そのベース言語のすべての文字セットと追加の文字セットを組み合わせたものです。
	, 読み取り専用	現在のテキスト言語のベース言語コレクションへの参照を返します。このコレクションは常に存在しますが、既定では要素を含みません。
	, 読み取り専用	禁止辞書のコレクションへの参照を返します。
		現在のテキスト言語の対象となるテキストのカテゴリを指定します。 既定では、このプロパティには TC_Unknown 値が設定されています。これは、このテキスト言語をあらゆる種類のテキストの認識に使用できることを意味します。
		TextLanguage 型のオブジェクトに、任意のユーザー定義情報を関連付けることができます。

​

メソッド

名前	説明
CopyFrom	現在のオブジェクトのプロパティを、別のオブジェクトの同じプロパティの値で初期化します。
LoadFromFile	オブジェクトの内容をディスク上のファイルから復元します。
LoadFromMemory 注: Windows のみ。	オブジェクトの内容をグローバル メモリから復元します。
SaveToFile	オブジェクトの内容をディスク上のファイルに保存します。
SaveToMemory 注: Windows のみ。	オブジェクトの内容をグローバル メモリに保存します。

​

関連オブジェクト

オブジェクト図

​

出力パラメーター

このオブジェクトは、LanguageDatabase オブジェクトの CreateTextLanguage メソッドおよび CreateCompoundTextLanguage メソッドの出力パラメーターです。

​

サンプル

C# コード

FREngine.IEngine engine;
// 新しい TextLanguage オブジェクトを作成
FREngine.ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
FREngine.ITextLanguage textLanguage = languageDatabase.CreateTextLanguage();
// あらかじめ定義されている英語の言語設定から、すべての属性をコピー
FREngine.ITextLanguage englishLanguage = Engine.PredefinedLanguages.Find( "English" ).TextLanguage;
textLanguage.CopyFrom( englishLanguage );
textLanguage.InternalName = "SampleTextLanguage";
// 一部の属性を変更し、言語に辞書を関連付ける
...
// 認識にこの言語を使用
FREngine.IDocumentProcessingParams documentProcessingParams = Engine.CreateDocumentProcessingParams();
documentProcessingParams.PageProcessingParams.RecognizerParams.TextLanguage = textLanguage;
document.Process( documentProcessingParams );

このオブジェクトは、以下のコードサンプルで使用されています。

• Linux: CustomLanguage
• Windows: CommandLineInterface、およびデモツール: BatchProcessingRecognition, MultiProcessingRecognition, PDFExportProfiles

​

関連項目

言語の取り扱い

プロパティの取り扱い