Paragraph オブジェクト（IParagraph インターフェイス）

ABBYY FineReader Engine API の Paragraph オブジェクト（IParagraph インターフェイス）— Text、段落パラメーター（ExtendedParams、ListParams、ParagraphStyle）、Lines および Words コレクション、文字ごとのパラメーター、ブックマーク/ハイパーリンクを公開する基本的な認識テキスト単位。

このオブジェクトでは、認識されたテキスト内の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 — ソフト ハイフン 段落の書字方向が右から左 (ヘブライ語など) の場合、段落のテキストは段落内の文字を読む順序で格納した文字列になります。たとえば、ヘブライ語テキスト は、文字列 ” ” として返されます。 認識されたテキストは元のテキストとわずかに異なる場合があります。一部の入力記号は特殊文字に置き換えられることがあります。たとえば、「…」記号はタブに置き換えられる場合があります。そのため、認識されたテキスト内の記号の数が元のテキストと異なることがあります。置き換えられた記号のない入力単語にアクセスするには、 .
	, read-only	段落の単語コレクションへのアクセスを提供します。 Text プロパティとは異なり、段落の書字方向が右から左 (ヘブライ語など) の場合でも、段落内の単語は左から右の順序で文字を格納した文字列として返されます。たとえば、ヘブライ語の単語 は、文字列 ” ” として返されます。
	, 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	画像上における段落の下端の座標を格納します。 このプロパティはバーコードの段落には使用できません。
	、読み取り専用	画像上における段落の左端の座標を格納します。 このプロパティは、バーコードの段落には使用できません。
	、読み取り専用	画像上における段落の右端の座標を格納します。 このプロパティは、バーコードの段落には使用できません。
	、読み取り専用	画像上における段落の上端の座標を格納します。 このプロパティは、バーコードの段落には使用できません。

​

メソッド

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

​

関連オブジェクト

オブジェクト図

​

出力パラメーター

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

• Paragraphs オブジェクトの Item メソッド

​

入力パラメーター

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

​

サンプル

C# コード

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++;
  }
 }
}

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

• Linux: CustomLanguage
• Windows: CustomLanguage, RecognizedTextProcessing、デモ ツール: Engine Predefined Processing Profiles

​

関連項目

Paragraphs

Text の操作

プロパティの操作