メインコンテンツへスキップ
このオブジェクトでは、認識されたテキスト内の1つの段落を操作するためのメソッドとプロパティを利用できます。 ABBYY FineReader Engine オブジェクトモデルにおいて、段落は基本的なテキスト単位です。ユーザーはこのオブジェクトを通じて、次の情報を取得できます。
  • 認識されたテキスト (この目的には Text プロパティを使用します)
  • さまざまな段落パラメーター (ExtendedParams、ListParams、ParagraphStyle プロパティ)
  • 段落内の行および単語のコレクション (Lines プロパティと Words プロパティ)
  • 個々の文字のパラメーター (GetCharParams、SetCharParams、GetDropCapCharParams メソッド)
  • ブックマーク (Bookmark プロパティおよび UserBookmark プロパティ)
  • 段落の境界の座標 (Left、Top、Right、Bottom プロパティ) は、バーコードの段落では使用できません。
  • ABBYY FineReader Engine のブックマークは、内部用 (技術用) のエンティティ、またはキーワード (プレフィックス) を使用して名前がエンコードされたカスタムエンティティです。これらのキーワードや語彙は、使用するテクノロジーのバージョンによって異なる場合があります。

​
プロパティ

,read-only

Engine オブジェクトを返します。

, read-only

Unicode 文字列形式で段落の認識されたテキストへのアクセスを提供します。認識されたテキストはこのプロパティを通じて取得します。この文字列には、以下の特殊文字が含まれる場合があります。

  • 0x2028 — 改行記号
  • L’\n’ — 段落区切り記号
  • 0xFFFC — オブジェクト置換文字 (テキスト内に埋め込まれた画像を示す)
  • 0x0009 — タブ。
  • 0x005E — サーカムフレックス アクセント (^) 。ABBYY FineReader Engine が認識できない文字の代替として使用されます。
  • 0x00AC — ソフト ハイフン
段落の書字方向が右から左 (ヘブライ語など) の場合、段落のテキストは段落内の文字を読む順序で格納した文字列になります。たとえば、ヘブライ語テキスト Hebrew は、文字列 ”Hebrew_backtofront” として返されます。

認識されたテキストは元のテキストとわずかに異なる場合があります。一部の入力記号は特殊文字に置き換えられることがあります。たとえば、「…」記号はタブに置き換えられる場合があります。そのため、認識されたテキスト内の記号の数が元のテキストと異なることがあります。置き換えられた記号のない入力単語にアクセスするには、.

,read-only

段落の単語コレクションへのアクセスを提供します。

Text プロパティとは異なり、段落の書字方向が右から左 (ヘブライ語など) の場合でも、段落内の単語は左から右の順序で文字を格納した文字列として返されます。たとえば、ヘブライ語の単語 Hebrew は、文字列 ”Hebrew” として返されます。

,read-only

段落の行コレクションへのアクセスを提供します。このプロパティは定数オブジェクトを返します。

, read-only

段落内のブックマーク数を返します。

, read-only

段落のブックマーク内部コレクション内のインデックスを使用して、任意の種類 (技術用またはユーザー定義) のブックマークへのアクセスを提供します。このプロパティを通じてアクセスされるブックマークの名前にはプレフィックスが含まれます。

,read-only

Hyperlink オブジェクトへの参照を返します。このオブジェクトは その位置のハイパーリンクを示します。ハイパーリンクが存在しない場合、このプロパティは 0 に設定されます。

,read-only

段落内のすべてのタブ ストップへのアクセスを提供します。

、読み取り専用

段落のブックマークの内部コレクション内のインデックスを使用して、ユーザーブックマークへのアクセスを提供します。このプロパティを介してアクセスされるブックマークの名前にはプレフィックスが含まれません。

、読み取り専用

段落内のユーザーブックマークの数を返します。

, read-only

このプロパティには、段落内の文字数が格納されます。この値は、Text プロパティを通じて取得される文字列の文字数と同じです。

段落末尾の段落区切り記号は Text プロパティに含まれ、Length プロパティのカウントにも含まれます。

ParagraphParams オブジェクトによって公開される Paragraph オブジェクトのパラメーターへのアクセスを提供します。

,read-only

段落が属するリストのパラメーターへのアクセスを提供します。段落がリストに含まれていない場合、 IListParams::List プロパティは NULL を返します。

段落スタイルのパラメーターへのアクセスを提供します。これらのパラメーターは、文書の合成後にのみアクセス可能になります。

このプロパティは定数オブジェクトを返します。

段落のドロップキャピタルの文字数へのアクセスを提供します。段落の先頭 DropCapCharsCount 個の文字がドロップキャピタルとみなされます。このプロパティは段落の編集時に更新されないため、段落の長さより大きくなる場合があります。

, read-only

その位置の文字が属する列の番号を格納します。

, read-only

画像上における段落の下端の座標を格納します。

このプロパティはバーコードの段落には使用できません。

、読み取り専用

画像上における段落の左端の座標を格納します。

このプロパティは、バーコードの段落には使用できません。

、読み取り専用

画像上における段落の右端の座標を格納します。

このプロパティは、バーコードの段落には使用できません。

、読み取り専用

画像上における段落の上端の座標を格納します。

このプロパティは、バーコードの段落には使用できません。

​
メソッド

NameDescription
DeleteBookmark段落から、指定した種類のブックマーク (技術またはユーザー) を削除します。
GetBookmarkRange名前を基に、ブックマークを構成する文字列の先頭文字のインデックスと長さを検出します。
GetCharParams1 文字のパラメーターにアクセスします。
GetDropCapCharParams段落のドロップ キャピタル文字のパラメーターにアクセスします。
GetHyperlinkRangeハイパーリンク内の 1 文字を解析し、ハイパーリンクを構成する文字列の先頭文字のインデックスと長さを検出します。
GetWordRecognitionVariants段落のテキスト内の現在位置にある単語の認識候補のコレクションを返します。
Insert段落のテキストに文字列を挿入します。
InsertParagraphBreak段落を 2 つの部分に分割します。
InsertTab選択したテキスト位置にタブ ストップを挿入します。
InsertText指定したテキストを段落のテキストに挿入します。
NextGroup検索開始文字と選択したパラメーターが異なる、段落内の次の文字を検索します。このメソッドを使用すると、段落内の太字または斜体のすべての単語や、認識が不確かなすべての文字などを検索できます。
Range段落のテキストから部分文字列を返します。
Remove段落のテキストから指定した範囲を削除します。
SetBookmark段落内の文字列にユーザー ブックマークを設定します。
SetCharParams一連の文字に対してパラメーターを設定します。
SetHyperlink段落内の文字列にハイパーリンクを設定します。
Paragraph オブジェクト図

​
出力パラメーター

このオブジェクトは、次のメソッドの出力パラメーターです。

​
入力パラメーター

このオブジェクトは、Paragraphs オブジェクトの IndexOf メソッドに渡される入力パラメーターです。

​
サンプル

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// テキスト ブロック内の段落を走査し、疑わしい文字の数を計算します
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;
 FREngine.ICharParams charParams = engine.CreateCharParams();
 for (int iChar = 0; iChar < text.Length; iChar++)
 {
  par.GetCharParams(iChar, charParams);
  if (charParams.IsSuspicious)
  {
   suspiciousCharsCount++;
  }
 }
}
このオブジェクトは、次のコード サンプルで使用されています：

​
関連項目

Paragraphs Text の操作 プロパティの操作