> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Text オブジェクト（IText インターフェイス）

> ABBYY FineReader Engine API の Text オブジェクト（IText インターフェイス）— 認識されたテキストを段落のコレクションとして表します。位置は (paragraph; symbol) の座標の組で定義され、IsInverted と TextOrientation を公開します。

このオブジェクトは、認識されたテキストを表します。認識されたテキストは段落のコレクションで、このコレクションには Paragraphs プロパティを通じてアクセスできます。さらに、このオブジェクトでは、さまざまなテキスト属性にアクセスするためのプロパティと、垂直分割や水平分割、範囲の削除などの操作を行うためのメソッドが提供されます。Text オブジェクトは、単独で存在する場合もあれば、レイアウトの単位 (テキストブロック、表のセルなど) を表す他のオブジェクトのサブオブジェクトとして存在する場合もあります。テキスト内の位置は、「座標の組」 (paragraph;symbol) で定義されます。また、いわゆる「特殊な位置」もあり、この場合は paragraph=\<段落数>、symbol=0 です。

<Note>
  このオブジェクトは、テキストを含む認識済みブロックを介して利用できます。また、文書またはページ全体の認識済みテキストには、特別な「プレーンテキスト」形式で [PlainText](/ja/fine-reader/engine/api-reference/text-related-objects/plaintext) オブジェクトを介してアクセスすることもできます。
</Note>

<div id="properties">
  ## プロパティ
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>名前</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>型</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>Application</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          <strong>Engine</strong> オブジェクトを返します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IsInverted</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          テキスト全体の色が反転しているかどうかを指定します。認識されたテキストが反転属性を持つブロックまたは表のセルに属している場合、この属性は TRUE に設定されます。黒い背景に白いフォントでテキストを表示するために、ユーザーインターフェイスで利用できます。
        </p>

        <Note>
          このプロパティを編集できるのは、Text オブジェクトが{" "}

          <a href="/ja/fine-reader/engine/api-reference/layout-related-objects/textblock#text">
            ITextBlock::Text
          </a>

          {" "}

          プロパティ経由で取得された場合のみです。それ以外の場合、このプロパティは読み取り専用となります。
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="paragraphs" />

          <strong>Paragraphs</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/text-related-objects/paragraphs">
              Paragraphs
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          <strong>Text</strong> オブジェクトの段落コレクションへのアクセスを提供します。空のものも含め、すべての <strong>Text</strong> オブジェクトは <strong>Paragraphs </strong>型の有効なサブオブジェクトを持ちます。このオブジェクトは{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/text-related-objects/paragraph">
              Paragraph
            </a>
          </strong>

          {" "}

          オブジェクトのコレクションであり、要素を含まない場合もあります。<strong>Paragraph </strong>オブジェクトは認識されたテキスト内の段落を表し、このオブジェクトを通じて認識されたテキストの内容を取得できます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="textorientation" />

          <strong>TextOrientation</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/text-related-objects/textorientation">
              TextOrientation
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          テキストの向きを格納します。認識されたテキストのエクスポート時に、ABBYY FineReader Engine が内部的に使用します。
        </p>

        <p>
          このプロパティは認識後にのみ有効ですが、認識済みのテキストの向きを変更することはできません。認識前にページの向きを指定する場合は、<strong>ImageProcessingParams</strong> オブジェクトの{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams#rotationtype">
              RotationType
            </a>
          </strong>

          {" "}

          プロパティを使用してください。特定のテキストブロックのテキストの向きを指定するには、認識前に{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/layout-related-objects/textblock#textorientation">
              ITextBlock::TextOrientation
            </a>
          </strong>

          {" "}

          プロパティを設定してください。
        </p>

        <p>
          このプロパティの値を設定する必要があるのは、エクスポートファイルに追加のテキストを挿入する場合のみです。テキストを追加した後、このプロパティでその向きを指定し、ドキュメントをエクスポートする前に合成を実行するメソッドを呼び出してください。
        </p>

        <p>注意：</p>

        <ul>
          <li>
            このプロパティは定数オブジェクトを返します。テキストの向きを変更するには、まず{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods">
                IEngine::CreateTextOrientation
              </a>
            </strong>

            {" "}

            メソッドを使用して中間の <strong>TextOrientation</strong> オブジェクトを取得し、必要なパラメーターを変更した後、取得したオブジェクトをプロパティに割り当ててください。
          </li>

          <li>
            このプロパティを編集できるのは、<strong>Text</strong> オブジェクトが{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/layout-related-objects/textblock#text">
                ITextBlock::Text
              </a>
            </strong>

            {" "}

            プロパティ経由で取得された場合のみです。それ以外の場合、このプロパティは読み取り専用となります。
          </li>

          <li>
            <strong>
              <a href="/ja/fine-reader/engine/api-reference/text-related-objects/textorientation#rotationtype">
                RotationType
              </a>
            </strong>

            {" "}

            プロパティが RT\_UnknownRotation、または{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/text-related-objects/textorientation#readingtype">
                ReadingType
              </a>
            </strong>

            {" "}

            プロパティが TRT\_Unknown である <strong>TextOrientation</strong> オブジェクトは、このプロパティに割り当てることができません。
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                 | 説明                     |
| ------------------------------------------------------------------------------------------------------------------ | ---------------------- |
| [AppendEmptyParagraph](/ja/fine-reader/engine/api-reference/text-related-objects/text/appendemptyparagraph-method) | 現在のテキストの末尾に空の段落を追加します。 |
| [GetRange](/ja/fine-reader/engine/api-reference/text-related-objects/text/getrange-method)                         | テキスト範囲のコピーを返します。       |
| [Remove](/ja/fine-reader/engine/api-reference/text-related-objects/text/remove-method)                             | 現在のテキストから範囲を削除します。     |
| [RemoveAll](/ja/fine-reader/engine/api-reference/text-related-objects/text/removeall-method)                       | 現在のテキストからすべての段落を削除します。 |

<div id="related-objects">
  ## 関連オブジェクト
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/text.gif?s=d5cc47e13de30be27cc4bc41076d5491" alt="Text" width="314" height="160" data-path="images/fine-reader/engine/text.gif" />[](/ja/fine-reader/engine/api-reference/layout-related-objects/textblock#text)[](/ja/fine-reader/engine/api-reference/text-related-objects/paragraph)[](/ja/fine-reader/engine/api-reference/text-related-objects/paragraphs)[](/ja/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/ja/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#editabletext)[](/ja/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/ja/fine-reader/engine/api-reference/layout-related-objects/textblock)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

<div id="input-parameter">
  ## 入力パラメーター
</div>

このオブジェクトは、[Paragraph](/ja/fine-reader/engine/api-reference/text-related-objects/paragraph)オブジェクトの[InsertText](/ja/fine-reader/engine/api-reference/text-related-objects/paragraph/inserttext-method)メソッドの入力パラメーターです。

<div id="samples">
  ## サンプル
</div>

<Accordion title="C# コード">
  ```csharp theme={null}
  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;
   // テキストに対して何らかの処理を実行します
  }
  ```
</Accordion>

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

* Linux: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/ja/fine-reader/engine/guided-tour/samples#recognizedtextprocessing)、およびデモツール: [Engine Predefined Processing Profiles](/ja/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

<div id="see-also">
  ## 関連項目
</div>

[Text の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-text)

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)