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

# XLExportParams オブジェクト（IXLExportParams インターフェイス）

> ABBYY FineReader Engine API の XLExportParams オブジェクト（IXLExportParams インターフェイス）— 認識されたテキストの XLS および XLSX 形式へのエクスポートを調整する、ファイル/メモリに保存可能な永続オブジェクト。

このオブジェクトは、認識されたテキストを XLS/XLSX 形式でエクスポートする際のパラメーターを調整する機能を提供します。このオブジェクトへのポインターは入力パラメーターとしてエクスポート メソッドに渡されるため、エクスポート結果に影響します。この型の新しく作成されたオブジェクトでは、すべてのプロパティに適切なデフォルト値が設定されています。各プロパティのデフォルト値の詳細については、対応するプロパティの説明を参照してください。

XLExportParams オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、そのオブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドを使用します。

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<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">
            読み取り専用
          </a>
        </p>
      </td>

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

    <tr>
      <td colspan="3">
        <p>
          <em>フォーマット設定</em>
        </p>
      </td>
    </tr>

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

          <strong>XLFileFormat</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/xlfileformatenum">
              XLFileFormatEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティは、認識されたテキストを XLS 形式にエクスポートする方法を決定します。MS Excel 5、MS Excel 8、またはその両方に設定できます。XLSX 形式へのエクスポート時には、このプロパティの値は無視されます。
        </p>

        <p>このプロパティのデフォルト値は XLFF\_DoubleStream です。</p>
      </td>
    </tr>

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

          <strong>LayoutRetentionMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/xlsxlayoutretentionmodeenum">
              XLSXLayoutRetentionModeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティでは、XLSX 形式へのエクスポート時に元のドキュメントのテーブルレイアウトを保持するモードを設定できます。このプロパティの値をデフォルト以外の定数に変更した場合、{" "}
          <strong>TablesOnly</strong>、<strong>RemoveFormatting</strong>、{" "}
          <strong>OnePagePerWorksheet</strong>、{" "}
          <strong>WriteRunningTitles</strong> プロパティは無視されます。
        </p>

        <p>
          XLS 形式にエクスポートする場合、このプロパティにはデフォルト値のみ使用できます。
        </p>

        <p>このプロパティのデフォルト値は XLLRM\_Default です。</p>
      </td>
    </tr>

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

          <strong>TablesOnly</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 の場合、テーブルブロックから認識されたテキストのみが XLS/XLSX 形式にエクスポートされます。
        </p>

        <p>
          <strong>LayoutRetentionMode</strong>{" "}
          プロパティが XLLRM\_ExactDocument または XLLRM\_ExactLines の場合、このプロパティは無視されます。
        </p>

        <p>デフォルト値は FALSE です。</p>
      </td>
    </tr>

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

          <strong>RemoveFormatting</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 に設定すると、ABBYY FineReader Engine は XLS/XLSX 形式にエクスポートされるテキストの書式を削除します。
        </p>

        <p>
          <strong>LayoutRetentionMode</strong>{" "}
          プロパティが XLLRM\_ExactDocument または XLLRM\_ExactLines の場合、このプロパティは無視されます。
        </p>

        <p>このプロパティのデフォルト値は FALSE です。</p>
      </td>
    </tr>

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

          <strong>OnePagePerWorksheet</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>
          ドキュメントの各ページを XLSX ファイルの個別のワークシートにエクスポートするかどうかを指定します。
        </p>

        <p>
          <strong>LayoutRetentionMode</strong>{" "}
          プロパティが XLLRM\_ExactDocument または XLLRM\_ExactLines の場合、このプロパティは無視されます。
        </p>

        <p>このプロパティのデフォルト値は FALSE です。</p>
      </td>
    </tr>

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

          <strong>ConvertStringsToNumbers</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>
          認識されたテキスト内の数値を、文字列ではなく数値として XLS/XLSX 形式にエクスポートするかどうかを指定します。
        </p>

        <p>このプロパティのデフォルト値は TRUE です。</p>
      </td>
    </tr>

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

          <strong>WriteRunningTitles</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>
          柱 (ランニングタイトル) を出力 XLS/XLSX ファイルに保存するかどうかを指定します。
        </p>

        <p>
          <strong>LayoutRetentionMode</strong>{" "}
          プロパティが XLLRM\_ExactDocument または XLLRM\_ExactLines の場合、このプロパティは無視されます。
        </p>

        <p>このプロパティのデフォルト値は TRUE です。</p>
      </td>
    </tr>

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

          <strong>MetaDataWritingParams</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/documentcontentinfowritingparams">
              DocumentContentInfoWritingParams
            </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>
          Specifies if the author, subject, title, and keywords of the document
          should be written into the output file. These parameters of the
          document are defined in the{" "}

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

            {" "}
          </strong>

          subobject of the{" "}

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

          {" "}

          object.
        </p>
      </td>
    </tr>

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

          <strong>CreateRtlSheets</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>
          Specifies whether to use right-to-left worksheet direction in exported
          documents.
        </p>

        <p>This property is FALSE by default.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Color settings</em>
        </p>
      </td>
    </tr>

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

          <strong>KeepTextColor</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>
          Specifies if original colors of text are retained during export of the
          recognized text to XLSX format.
        </p>

        <Note>
          The text color can be retained during export only if the{" "}

          <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage#detecttextcolor">
            ISynthesisParamsForPage::DetectTextColor
          </a>

          {" "}

          property was set to TSPV\_Yes or TSPV\_Auto during page
          synthesis.
        </Note>

        <p>This property is FALSE by default.</p>
      </td>
    </tr>

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

          <strong>BackgroundColorMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/backgroundcolormodeenum">
              BackgroundColorModeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Specifies the mode of background color saving when exporting to XLSX
          format. Only table cells background color can be saved. The background
          color of the text outside tables is not saved regardless of the value
          of this property.
        </p>

        <Note>
          The background color can be retained during export only if the{" "}

          <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage#detectbackgroundcolor">
            ISynthesisParamsForPage::DetectBackgroundColor
          </a>

          {" "}

          property was set to TSPV\_Yes or TSPV\_Auto during page
          synthesis.
        </Note>

        <p>This property is BCM\_DontSave by default.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Page size and orientation</em>
        </p>
      </td>
    </tr>

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

          <strong>PageOrientation</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/pageorientationenum">
              PageOrientationEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Specifies page orientation during export in XLSX format. The value of
          this property is ignored, if the <strong>PaperSize</strong> property
          is XLPS\_NotSpecified.
        </p>

        <p>By default, the property is set to POM\_Auto.</p>

        <Warning>
          The POM\_MostFrequent constant is not available for this property.
        </Warning>
      </td>
    </tr>

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

          <strong>PaperSize</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/xlsxpapersizeenum">
              XLSXPaperSizeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Specifies one of the standard paper sizes for XLSX file. If this
          property is XLPS\_NotSpecified, the value of the{" "}
          <strong>PageOrientation</strong> property is ignored.
        </p>

        <p>By default, the value of this property is XLPS\_NotSpecified.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Picture embedding</em>
        </p>
      </td>
    </tr>

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

          <strong>WritePictures</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>
          Specifies whether pictures must be written in files in XLSX format.
        </p>

        <p>
          このプロパティを TRUE に設定できるのは、<strong>LayoutRetentionMode</strong> プロパティが XLLRM\_Default の場合のみです。<strong>LayoutRetentionMode</strong> プロパティが XLLRM\_ExactDocument または XLLRM\_ExactLines に設定されている場合、画像は自動的に出力ファイルへ書き込まれます。
        </p>

        <p>The default value is FALSE.</p>
        <Warning>Picture embedding is not supported for XLS format.</Warning>
      </td>
    </tr>

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

          <strong>PictureExportParams</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/pictureexportparams">
              PictureExportParams
            </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>
          Specifies the image format and JPEG quality which should be used for
          embedded pictures in the output file.
        </p>

        <Warning>Picture embedding is not supported for XLS format.</Warning>
      </td>
    </tr>
  </tbody>
</table>

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

| 名前                                                                                                                                               | 説明                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                         | 現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。 |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                       | ディスク上のファイルからオブジェクトの内容を復元します。                  |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **注:** *Windows のみ。* | グローバル メモリからオブジェクトの内容を復元します。                   |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                           | オブジェクトの内容をディスク上のファイルに保存します。                   |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **注:** *Windows のみ。*     | オブジェクトの内容をグローバル メモリに保存します。                    |

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

<img src="https://mintcdn.com/abbyy/B_SRGbkkbQ9YH40E/images/fine-reader/engine/xlexportparams.gif?s=e3940588d2f0bf6bebe00fe7ebd786d1" alt="XLExportParams" width="171" height="89" data-path="images/fine-reader/engine/xlexportparams.gif" />[](/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/xlexportparams#metadatawritingparams)[](/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/xlexportparams#pictureexportparams)[](/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/pictureexportparams)[](/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/documentcontentinfowritingparams)

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

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

このオブジェクトは、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [CreateXLExportParams](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドの出力パラメーターです。

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

このオブジェクトは、次のメソッドに入力パラメーターとして渡されます。

* [FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument) オブジェクトの [Export](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/export-method)、[ExportPages](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/exportpages-method)、[ExportToMemory](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/exporttomemory-method) メソッド

* [FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) オブジェクトの [Export](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/export-method) メソッド

* [Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [RecognizeImageFile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method) メソッド

* Windows Visual Components 用の [IDocumentViewerEvents](/ja/fine-reader/engine/visual-components-reference/idocumentviewerevents) インターフェイスの [OnExportPages](/ja/fine-reader/engine/visual-components-reference/idocumentviewerevents/onexportpages-method) メソッド

* Windows Visual Components 用の [IDocumentViewerEvents](/ja/fine-reader/engine/visual-components-reference/idocumentviewerevents) インターフェイスの [OnSendToPages](/ja/fine-reader/engine/visual-components-reference/idocumentviewerevents/onsendtopages-method) メソッド

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

このオブジェクトは、Linux および Windows 向けの以下のコードサンプルで使用されています: [CommandLineInterface](/ja/fine-reader/engine/guided-tour/samples#commandlineinterface)

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

[エクスポート パラメーターの調整](/ja/fine-reader/engine/guided-tour/advanced-techniques/tuning-export-parameters)

[プロファイルの使用](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)

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