コレクションの操作

• 一時コレクション (既存のオブジェクトへの参照のコレクション)
• 子オブジェクトのコレクション
• 子オブジェクトの読み取り専用コレクション

• 各種類のコレクションの操作方法
• 利用可能なすべてのコレクションの一覧を確認する方法
• Windows 版 FRE の .NET でコレクションを操作する方法

​

一時コレクション

1. Engine オブジェクトの対応する作成メソッドを使用してコレクションを作成します。たとえば、IntsCollection オブジェクトの場合は CreateIntsCollection メソッドを使用します。これらのコレクションは、一部のメソッドの戻り値となることもあります。
2. Add メソッドを使用して、既存のオブジェクトをコレクションに追加します。コレクションは、読み取り専用の Count プロパティ、読み書き可能な Element プロパティ、および Item メソッドを使って反復処理できます。1 つ目はコレクションに実際に含まれている要素数を取得し、2 つ目と 3 つ目は指定したインデックスの要素にアクセスするためのものです。Element プロパティを使用すると、C# では [] 演算子を使ってコレクションの要素にアクセスできます。
3. 必要に応じて、コレクションの他のメソッド InsertAt、DeleteAt、DeleteAll を使用してコレクションを変更します。
4. そのコレクションを、パラメーターとして必要とするメソッドに渡します。

 
for( int i = 0; i < Document.Pages.Count; i++ )
{
 if( Document.Pages[i].PageStructureOutOfDate )
 {
  pageIndices.Add( i );
 }
}
// 作成したページ インデックスのコレクションを処理メソッドに渡す
if( pageIndices.Count > 0 || Document.DocumentStructureOutOfDate )
{
 Document.SynthesizePages( pageIndices, null );
}

​

子オブジェクトのコレクション

1. 親オブジェクトのプロパティを介してコレクションを取得します。たとえば、認識言語の基本言語のコレクションにアクセスするには、BaseLanguage オブジェクトの DictionaryDescriptions プロパティを使用します。
2. 読み取り専用の Count および Element プロパティと、Item メソッドを使用してコレクションを反復処理します。1つ目はコレクションに実際に含まれている要素数を取得し、2つ目と3つ目は指定した インデックス の要素を取得します。Element プロパティを使用すると、C# で \[\] 演算子を使ってコレクションの要素にアクセスできます。
3. 必要に応じて、AddNew メソッドを使用して新しい要素をコレクションに追加します。コレクションごとに AddNew メソッドの構文は多少異なる場合がありますが、これらのメソッドはすべて同じ処理を行います。つまり、新しいコレクション要素を作成してコレクションに追加します。要素は DeleteAt、DeleteAll メソッドを使用して削除できます。

FREngine.IEngine Engine = null;
FREngine.IBaseLanguage baseLanguage = null;
// Engineを初期化し、テキスト言語の基本言語を取得する
...
// 基本言語のdictionary descriptionのコレクションを取得し、すべての項目を削除する
IDictionaryDescriptions dictionaryDescriptions = baseLanguage.DictionaryDescriptions;
dictionaryDescriptions.DeleteAll();
// ユーザーdictionary descriptionを作成し、コレクションに追加する
IDictionaryDescription dictionaryDescription = dictionaryDescriptions.AddNew( DictionaryTypeEnum.DT_UserDictionary );

​

読み取り専用のコレクション

1. 親オブジェクトのプロパティからコレクションを取得します。たとえば、テキストの段落のコレクションにアクセスするには、Text オブジェクトの Paragraphs プロパティを使用します。
2. 読み取り専用の Count プロパティと Element プロパティ、および Item メソッドを使用してコレクションを反復処理します。1 つ目はコレクションに実際に含まれている要素数を取得し、2 つ目と 3 つ目は指定した インデックス の要素を取得します。Element プロパティを使用すると、C# では [] 演算子を使ってコレクションの要素にアクセスできます。

FREngine.IEngine Engine = null;
FREngine.IBlock block = null;
// Engine を初期化し、ドキュメントを認識して、レイアウトのテキストブロックを取得する
...
FREngine.ITextBlock textBlock = block.GetAsTextBlock();
// ブロックのテキスト内の段落を反復処理する
int paragraphsCount = textBlock.Text.Paragraphs.Count;
for (int iPar = 0; iPar < paragraphsCount; iPar++)
{
 FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
 string text = par.Text;
}

​

利用可能なコレクションの一覧

​

.NET でコレクションを扱う

FREngine.IFRDocument document;
// この document にはいくつかのページが含まれているものとします
...
foreach( FREngine.IFRPage page in document.Pages ) {
 // page に対して何らかの処理を行います
}