> ## 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.

# ドキュメント関連オブジェクトのバージョン 10 との互換性

> ABBYY FineReader Engine 12 と 10 の間におけるドキュメント関連オブジェクト API の互換性変更 — DocumentStructure と PageStructure を削除、FRPage を介した Layout ベースのアクセス。

このセクションでは、アプリケーションのソースコードの修正が必要になる可能性がある、ドキュメント関連オブジェクトに関するすべての変更点について説明します。

* ドキュメントの論理構造 (DocumentStructure、PageStructure、およびそれらのサブオブジェクト) へのアクセスを提供していた API は削除されました。削除されたオブジェクトを介してドキュメントのプロパティや内容を編集すると、エクスポート時に予期しない結果を招く可能性がありました。認識結果を検証または後処理する必要がある場合は、各 [FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) の [Layout](/ja/fine-reader/engine/api-reference/document-related-objects/frpage#layout) サブオブジェクトを通じてデータを操作し、作業が完了したら文書の合成を実行するいずれかのメソッドを呼び出してください。そうすると、ドキュメントの論理構造が再作成されてエクスポート時に使用されますが、FineReader Engine API を介して編集することはできなくなります。将来の ABBYY FineReader Engine のバージョンでは、ドキュメントの論理構造の一部に対して読み取り専用アクセスが提供される可能性があります。

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>オブジェクト/列挙型</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>プロパティ/メソッド/定数</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>変更内容</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>コメント</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td rowspan="5">
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument">
              FRDocument
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>AddImage</strong>
        </p>
      </td>

      <td>
        <p>名称変更</p>
      </td>

      <td>
        <p>
          このメソッドの新しい名前は{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagedocument-method">
              AddImageDocument
            </a>
          </strong>

          です。ディスク上の画像ファイルではなく <strong>ImageDocument</strong> を操作することを明確にするために名称が変更されました。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefrommemory-method">
              AddImageFileFromMemory
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>入力パラメーターの数が変更されました</p>
      </td>

      <td>
        <ul>
          <li>
            画像データを含むメモリバッファへのポインターは{" "}

            <strong>
              <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
                \_\_int64
              </a>
            </strong>

            として渡されます。この変更は64ビットオペレーティングシステムのサポートに対応するために行われました。
          </li>

          <li>
            変数 <em>fileFormat</em> は入力パラメーターとして使用されなくなりました。ファイル形式は <em>fileName</em>{" "}
            パラメーターを使用して判別されます。
          </li>

          <li>
            以下のファイルをメモリから開くことができます。

            <ul>
              <li>PDF,</li>
              <li>DjVu (Windows)</li>
              <li>WDP (Windows)</li>
            </ul>
          </li>
        </ul>

        <p>
          このため、このメソッドはパスワードで保護されたPDFファイルを開く際に必要な{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback">
              IImagePasswordCallback
            </a>
          </strong>

          {" "}

          インターフェイスへのポインターを受け取るようになりました。
        </p>

        <ul>
          <li>
            このメソッドは、複数ページのファイルのどのページを追加するかを指定する{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection">
                IntsCollection
              </a>
            </strong>

            {" "}

            オブジェクトも受け取ります。
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/analyze-method">
              Analyze
            </a>
          </strong>
        </p>

        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/analyzepages-method">
              AnalyzePages
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>入力パラメーターの数が変更されました</p>
      </td>

      <td>
        <p>
          これらのメソッドは、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams">
              PageProcessingParams
            </a>
          </strong>

          {" "}

          オブジェクトのサブオブジェクトのセットを入力パラメーターとして受け取ります。ページ解析に必要なパラメーターのみがこれらのメソッドに渡されます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>AnalyzeAndRecognize</strong>
        </p>

        <p>
          <strong>AnalyzeAndRecognizePages</strong>
        </p>
      </td>

      <td>
        <p>削除</p>
      </td>

      <td>
        <p>
          同じ機能は、<strong>FRDocument</strong> オブジェクトの{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/process-method">
              Process
            </a>
          </strong>

          {" "}

          メソッドおよび{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/processpages-method">
              ProcessPages
            </a>
          </strong>

          {" "}

          メソッドを使用し、<strong>DocumentProcessingParams</strong> の入力パラメーターである{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams#performsynthesis">
              PerformSynthesis
            </a>
          </strong>

          {" "}

          プロパティをFALSEに設定することで利用できます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/process-method">
              Process
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>入力パラメーターの数が変更されました</p>
      </td>

      <td>
        <p>
          このメソッドは、必要なすべてのパラメーターを1つの{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams">
              DocumentProcessingParams
            </a>
          </strong>

          {" "}

          オブジェクトで受け取ります。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/ifrdocumentevents">
              IFRDocumentEvents
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>OnRecognizerTip</strong>
        </p>
      </td>

      <td>
        <p>名称変更</p>
      </td>

      <td>
        <p>
          このメソッドの新しい名前は{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/ifrdocumentevents/onwarning-method">
              OnWarning
            </a>
          </strong>

          です。警告およびrecognizerのヒントをクライアントに通知するほか、アプリケーションが「応答していない」状態になるのを防ぐためにシステムメッセージを処理することもできます。
        </p>

        <p>
          また、警告が参照するドキュメント内のページのインデックスを指定する追加パラメーターも備えています。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>Artefact</strong>
        </p>

        <p>
          <strong>BackgroundLayer</strong>
        </p>

        <p>
          <strong>Caption</strong>
        </p>

        <p>
          <strong>Captions</strong>
        </p>

        <p>
          <strong>DocumentElement</strong>
        </p>

        <p>
          <strong>DocumentSection</strong>
        </p>

        <p>
          <strong>DocumentStream</strong>
        </p>

        <p>
          <strong>DocumentStructure</strong>
        </p>

        <p>
          <strong>Footnote</strong>
        </p>

        <p>
          <strong>Footnotes</strong>
        </p>

        <p>
          <strong>FootnoteSeries</strong>
        </p>

        <p>
          <strong>FootnoteSeriesArray</strong>
        </p>

        <p>
          <strong>GlobalStyleStorage</strong>
        </p>

        <p>
          <strong>Incut</strong>
        </p>

        <p>
          <strong>IncutGroup</strong>
        </p>

        <p>
          <strong>IncutGroups</strong>
        </p>

        <p>
          <strong>MainText</strong>
        </p>

        <p>
          <strong>PageBlackSeparator</strong>
        </p>

        <p>
          <strong>PageElement</strong>
        </p>

        <p>
          <strong>PageElements</strong>
        </p>

        <p>
          <strong>PageSection</strong>
        </p>

        <p>
          <strong>PageSections</strong>
        </p>

        <p>
          <strong>PageStream</strong>
        </p>

        <p>
          <strong>PageStructure</strong>
        </p>

        <p>
          <strong>RunningTitle</strong>
        </p>

        <p>
          <strong>RunningTitleSeries</strong>
        </p>

        <p>
          <strong>RunningTitleSeriesArray</strong>
        </p>

        <p>
          <strong>RunningTitleSeriesText</strong>
        </p>

        <p>
          <strong>StreamElementLocationParams</strong>
        </p>

        <p>
          <strong>TextBarcode</strong>
        </p>

        <p>
          <strong>TextPicture</strong>
        </p>

        <p>
          <strong>TextTable</strong>
        </p>

        <p>
          <strong>TextTableCell</strong>
        </p>
      </td>

      <td>
        <br />
      </td>

      <td>
        <p>削除済み</p>
      </td>

      <td>
        <p>
          これらのオブジェクトはドキュメントの論理構造とその各部分を表していました。ドキュメント構造の編集は、誤った使用によってエクスポート後のドキュメントの外観に影響を及ぼす可能性があるため、サポートされなくなりました。テキストの検証やその他の変更は、ドキュメント API (

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frdocument">
              FRDocument
            </a>
          </strong>

          ,{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>

          {" "}

          およびサブオブジェクト) を通じて実行できます。ABBYY FineReader Engine の将来のバージョンでは、ドキュメントの論理構造の一部に対して読み取り専用アクセスが提供される予定です。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>BorderFlags</strong>
        </p>

        <p>
          <strong>CaptionPositionEnum</strong>
        </p>

        <p>
          <strong>DocumentElementTypeEnum</strong>
        </p>

        <p>
          <strong>FootnoteNumberingTypeEnum</strong>
        </p>

        <p>
          <strong>FrameHorizontalReferenceEnum</strong>
        </p>

        <p>
          <strong>FrameVerticalReferenceEnum</strong>
        </p>

        <p>
          <strong>PageBlackSeparatorRoleEnum</strong>
        </p>

        <p>
          <strong>PageBlackSeparatorTypeEnum</strong>
        </p>

        <p>
          <strong>PageElementTypeEnum</strong>
        </p>

        <p>
          <strong>StreamElementAlignmentEnum</strong>
        </p>

        <p>
          <strong>StreamTypeEnum</strong>
        </p>

        <p>
          <strong>TableCellVertAlignmentEnum</strong>
        </p>

        <p>
          <strong>TextTableSeparatorTypeEnum</strong>
        </p>

        <p>
          <strong>TextWrappingEnum</strong>
        </p>
      </td>

      <td>
        <br />
      </td>

      <td>
        <p>削除済み</p>
      </td>

      <td>
        <p>
          これらの列挙型は、現在利用できなくなったドキュメント構造オブジェクトで使用されていました。
        </p>
      </td>
    </tr>

    <tr>
      <td rowspan="6">
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/analyze-method">
              Analyze
            </a>
          </strong>
        </p>

        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/analyzeregion-method">
              AnalyzeRegion
            </a>
          </strong>
        </p>

        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/analyzetable-method">
              AnalyzeTable
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>動作変更</p>
      </td>

      <td>
        <ul>
          <li>
            これらのメソッドは、{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams">
                PageProcessingParams
              </a>

              {" "}
            </strong>

            オブジェクトのサブオブジェクトのセットを入力パラメーターとして受け取ります。ページ解析に必要なパラメーターのみがこれらのメソッドに渡されます。
          </li>

          <li>
            <strong>Analyze</strong> メソッドは、ページの向き、反転、および幾何学的歪みの補正を行わなくなりました。画像の前処理は独立した処理ステージとなりました。向き、反転、幾何学的歪みを補正するには、<strong>FRPage</strong> オブジェクトの対応するメソッドを使用するか、{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/preprocess-method">
                IFRPage::Preprocess
              </a>
            </strong>

            {" "}

            メソッドを使用してこれらすべての操作をまとめて実行してください。
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>AnalyzeAndRecognize</strong>
        </p>
      </td>

      <td>
        <p>名称変更</p>
      </td>

      <td>
        <p>
          このメソッドの新しい名前は{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/preprocessanalyzerecognize-method">
              PreprocessAnalyzeRecognize
            </a>
          </strong>

          です。旧メソッドとの唯一の違いは、処理に必要なすべての設定を含む{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams">
              PageProcessingParams
            </a>
          </strong>

          {" "}

          型の入力パラメーターを 1 つだけ受け取るようになった点です。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>CorrectResolution</strong>
        </p>
      </td>

      <td>
        <p>削除済み</p>
      </td>

      <td>
        <p>
          {" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/detectresolution-method">
              IFRPage::DetectResolution
            </a>
          </strong>

          {" "}

          および{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/changeresolution-method">
              IImageDocument::ChangeResolution
            </a>
          </strong>

          {" "}

          メソッドを代わりに使用してください。これにより、ユーザーは

          <strong>
            {" "}

            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/detectresolution-method">
              DetectResolution
            </a>
          </strong>

          {" "}

          メソッドで提案された解像度を画像に適用する前に確認できます。提案された補正が非常に小さく、適用する意味がない場合もあります。
        </p>

        <p>
          ただし、前処理中に <strong>CorrectResolution</strong>{" "}
          プロパティを{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams">
              PagePreprocessingParams
            </a>
          </strong>

          に設定することで、解像度を自動的に補正することも引き続き可能です。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>RemoveGeometricalDistortions</strong>
        </p>
      </td>

      <td>
        <p>削除済み</p>
      </td>

      <td>
        <p>
          代わりに <strong>IImageDocument::RemoveGeometricalDistortions</strong>{" "}
          メソッドを使用してください。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/flush-method">
              Flush
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>入力パラメーターの数が変更されました</p>
      </td>

      <td>
        <p>
          このメソッドは、データをディスクに保存するかどうかを指定するブール型の入力パラメーターを受け取ります。データが変更されていない場合、保存が不要なときにメソッドの処理が大幅に速くなるため、これは有用です。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>FlushExt</strong>
        </p>
      </td>

      <td>
        <p>削除済み</p>
      </td>

      <td>
        <p>
          {" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/flush-method">
              Flush
            </a>
          </strong>

          {" "}

          メソッドは <strong>FlushExt</strong> メソッドと同じシグネチャを持ちます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/ifrpageevents">
              IFRPageEvents
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>OnRecognizerTip</strong>
        </p>
      </td>

      <td>
        <p>名前変更済み</p>
      </td>

      <td>
        <p>
          メソッドの新しい名前は{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/ifrpageevents/onwarning-method">
              OnWarning
            </a>
          </strong>

          です。このメソッドは、警告および認識エンジンのヒントをクライアントに通知するとともに、アプリケーションが「応答していない」状態になるのを防ぐためにシステムメッセージを処理することもできます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpages">
              FRPages
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Find</strong>
        </p>

        <p>
          <strong>Remove</strong>
        </p>
      </td>

      <td>
        <p>名前変更済み</p>
      </td>

      <td>
        <p>
          メソッドの新しい名前は{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpages/indexof-method">
              IndexOf
            </a>
          </strong>

          、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteat-method">
              DeleteAt
            </a>
          </strong>

          です。すべてのコレクションのメソッド名は、統一性を確保するために変更されました。
        </p>
      </td>
    </tr>

    <tr>
      <td rowspan="2">
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/documentinformationdictionary">
              DocumentInformationDictionary
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Add</strong>
        </p>

        <p>
          <strong>CreateDocumentInformationDictionaryItem</strong>
        </p>

        <p>
          <strong>Insert</strong>
        </p>
      </td>

      <td>
        <p>名前変更済み</p>
      </td>

      <td>
        <p>
          代わりに{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/addnew-method">
              AddNew
            </a>
          </strong>

          {" "}

          メソッドを使用してください。すべてのコレクションのメソッド名は、統一性を確保するために変更されました。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>CopyFrom</strong>
        </p>
      </td>

      <td>
        <p>削除済み</p>
      </td>

      <td>
        <p>
          このメソッドはサポートされなくなりました。別のコレクションから要素の値をコピーするには、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/addnew-method">
              AddNew
            </a>
          </strong>

          {" "}

          メソッドを使用してコレクションに新しい要素を追加し、同じ値を指定してください。
        </p>
      </td>
    </tr>

    <tr>
      <td rowspan="2">
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/document-related-objects/authorslist">
              AuthorsList
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Add</strong>
        </p>

        <p>
          <strong>CreateAuthorInfo</strong>
        </p>
      </td>

      <td>
        <p>名前変更済み</p>
      </td>

      <td>
        <p>
          代わりに{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/addnew-method">
              AddNew
            </a>
          </strong>

          {" "}

          メソッドを使用してください。すべてのコレクションのメソッド名は、統一性を確保するために変更されました。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>Remove</strong>
        </p>

        <p>
          <strong>RemoveAll</strong>
        </p>
      </td>

      <td>
        <p>名前変更済み</p>
      </td>

      <td>
        <p>
          メソッドの新しい名前は{" "}

          <strong>
            <a href="/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteat-method">
              DeleteAt
            </a>
          </strong>

          、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteall-method">
              DeleteAll
            </a>
          </strong>

          です。すべてのコレクションのメソッド名は、統一性を確保するために変更されました。
        </p>
      </td>
    </tr>
  </tbody>
</table>
