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

# Objet XLExportParams (interface IXLExportParams)

> Objet XLExportParams (interface IXLExportParams) dans l’API ABBYY FineReader Engine — permet de configurer l’export du texte reconnu aux formats XLS et XLSX ; objet persistant pouvant être enregistré dans un fichier ou en mémoire.

Cet objet permet d’ajuster les paramètres d’exportation du texte reconnu au format XLS/XLSX. Un pointeur vers cet objet est transmis aux méthodes d’exportation en tant que paramètre d’entrée et influe donc sur les résultats de l’exportation. Toutes les propriétés d’un objet nouvellement créé de ce type sont définies sur des valeurs par défaut appropriées. Pour plus d’informations sur la valeur par défaut de telle ou telle propriété, voir la description de la propriété correspondante.

L’objet XLExportParams est un objet persistant. Cela signifie que l’état actuel de l’objet peut être écrit dans un stockage persistant. Par la suite, l’objet peut être recréé en relisant son état depuis ce stockage persistant. Les méthodes suivantes assurent la persistance de l’objet :

Linux : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) et [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) et [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

<div id="properties">
  ## Propriétés
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Nom</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

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

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

          ,{" "}

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

      <td>
        <p>
          Retourne l'objet <strong>Engine</strong>.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Paramètres de format</em>
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Cette propriété détermine comment le texte reconnu sera exporté au
          format XLS. Elle peut être définie sur MS Excel 5, MS Excel 8, ou les deux. Sa valeur
          est ignorée lors de l'exportation au format XLSX.
        </p>

        <p>Cette propriété vaut XLFF\_DoubleStream par défaut.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Cette propriété permet de définir le mode de conservation de la
          mise en page des tableaux du document d'origine lors de l'exportation au format XLSX. Si vous modifiez
          la valeur de cette propriété en une constante non définie par défaut, les propriétés{" "}
          <strong>TablesOnly</strong>, <strong>RemoveFormatting</strong>,{" "}
          <strong>OnePagePerWorksheet</strong>,{" "}
          <strong>WriteRunningTitles</strong> sont ignorées.
        </p>

        <p>
          Si vous exportez au format XLS, seule la valeur par défaut de cette
          propriété est autorisée.
        </p>

        <p>La valeur par défaut de cette propriété est XLLRM\_Default.</p>
      </td>
    </tr>

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

          <strong>TablesOnly</strong>
        </p>
      </td>

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

      <td>
        <p>
          Lorsque cette propriété est TRUE, seul le texte reconnu issu des blocs de tableau est
          exporté au format XLS/XLSX.
        </p>

        <p>
          Cette propriété est ignorée si la propriété <strong>LayoutRetentionMode</strong>{" "}
          est égale à XLLRM\_ExactDocument ou XLLRM\_ExactLines.
        </p>

        <p>Sa valeur par défaut est FALSE.</p>
      </td>
    </tr>

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

          <strong>RemoveFormatting</strong>
        </p>
      </td>

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

      <td>
        <p>
          Lorsque cette propriété est définie sur TRUE, ABBYY FineReader Engine supprime
          la mise en forme du texte exporté au format XLS/XLSX.
        </p>

        <p>
          Cette propriété est ignorée si la propriété <strong>LayoutRetentionMode</strong>{" "}
          est égale à XLLRM\_ExactDocument ou XLLRM\_ExactLines.
        </p>

        <p>Cette propriété est FALSE par défaut.</p>
      </td>
    </tr>

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

          <strong>OnePagePerWorksheet</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si chaque page du document doit être exportée dans une feuille de calcul
          distincte du fichier XLSX.
        </p>

        <p>
          Cette propriété est ignorée si la propriété <strong>LayoutRetentionMode</strong>{" "}
          est égale à XLLRM\_ExactDocument ou XLLRM\_ExactLines.
        </p>

        <p>Cette propriété est FALSE par défaut.</p>
      </td>
    </tr>

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

          <strong>ConvertStringsToNumbers</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si les valeurs numériques du texte reconnu sont exportées au
          format XLS/XLSX en tant que nombres plutôt que comme chaînes de caractères.
        </p>

        <p>Cette propriété est TRUE par défaut.</p>
      </td>
    </tr>

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

          <strong>WriteRunningTitles</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si les titres courants doivent être enregistrés dans le fichier
          XLS/XLSX de sortie.
        </p>

        <p>
          Cette propriété est ignorée si la propriété <strong>LayoutRetentionMode</strong>{" "}
          est égale à XLLRM\_ExactDocument ou XLLRM\_ExactLines.
        </p>

        <p>Cette propriété est TRUE par défaut.</p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/documentcontentinfowritingparams">
              DocumentContentInfoWritingParams
            </a>
          </strong>

          ,{" "}

          <a href="/fr/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="/fr/fine-reader/engine/api-reference/document-related-objects/documentcontentinfo">
              DocumentContentInfo
            </a>

            {" "}
          </strong>

          subobject of the{" "}

          <strong>
            <a href="/fr/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="/fr/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="/fr/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="/fr/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="/fr/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="/fr/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="/fr/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="/fr/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="/fr/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>
          Cette propriété ne peut être définie sur TRUE que si la propriété{" "}
          <strong>LayoutRetentionMode</strong> est égale à
          XLLRM\_Default. Si la propriété <strong>LayoutRetentionMode</strong>{" "}
          est définie sur XLLRM\_ExactDocument ou XLLRM\_ExactLines,
          les images sont automatiquement écrites dans le fichier de sortie.
        </p>

        <p>La valeur par défaut est FALSE.</p>
        <Warning>L'incorporation d'images n'est pas prise en charge pour le format XLS.</Warning>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/pictureexportparams">
              PictureExportParams
            </a>
          </strong>

          ,{" "}

          <a href="/fr/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">
  ## Méthodes
</div>

| Nom                                                                                                                                                              | Description                                                                                                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [CopyFrom](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                                         | Initialise les propriétés de l’objet actuel avec les valeurs des propriétés correspondantes d’un autre objet. |
| [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                                       | Restaure le contenu de l’objet à partir d’un fichier sur disque.                                              |
| [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Remarque :** *Windows uniquement.* | Restaure le contenu de l’objet à partir de la mémoire globale.                                                |
| [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                           | Enregistre le contenu de l’objet dans un fichier sur disque.                                                  |
| [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Remarque :** *Windows uniquement.*     | Enregistre le contenu de l’objet dans la mémoire globale.                                                     |

<div id="related-objects">
  ## Objets connexes
</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" />[](/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/xlexportparams#metadatawritingparams)[](/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/xlexportparams#pictureexportparams)[](/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/pictureexportparams)[](/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/documentcontentinfowritingparams)

[Diagramme d’objets](/fr/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Paramètre de sortie
</div>

Cet objet est le paramètre de sortie de la méthode [CreateXLExportParams](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) de l’objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface).

<div id="input-parameter">
  ## Paramètre d’entrée
</div>

Cet objet est passé en paramètre d’entrée aux méthodes suivantes :

* méthodes [Export](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument/export-method), [ExportPages](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument/exportpages-method), [ExportToMemory](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument/exporttomemory-method) de l’objet [FRDocument](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument)

* méthode [Export](/fr/fine-reader/engine/api-reference/document-related-objects/frpage/export-method) de l’objet [FRPage](/fr/fine-reader/engine/api-reference/document-related-objects/frpage)

* méthode [RecognizeImageFile](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method) de l’objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface)

* méthode [OnExportPages](/fr/fine-reader/engine/visual-components-reference/idocumentviewerevents/onexportpages-method) de l’interface [IDocumentViewerEvents](/fr/fine-reader/engine/visual-components-reference/idocumentviewerevents) de Windows Visual Components

* méthode [OnSendToPages](/fr/fine-reader/engine/visual-components-reference/idocumentviewerevents/onsendtopages-method) de l’interface [IDocumentViewerEvents](/fr/fine-reader/engine/visual-components-reference/idocumentviewerevents) de Windows Visual Components

<div id="samples">
  ## Exemples
</div>

Cet objet est utilisé dans les exemples de code suivants pour Linux et Windows : [CommandLineInterface](/fr/fine-reader/engine/guided-tour/samples#commandlineinterface)

<div id="see-also">
  ## Voir aussi
</div>

[Réglage des paramètres d’exportation](/fr/fine-reader/engine/guided-tour/advanced-techniques/tuning-export-parameters)

[Utilisation des profils](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)

[Utilisation des propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)