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

# Méthode WriteToFile de l’objet Image

> Méthode WriteToFile de l’objet Image dans l’API ABBYY FineReader Engine — enregistre une copie du plan d’image actif dans un fichier image au format spécifié ; non applicable aux PDF ne contenant qu’une image (utilisez les méthodes Export dans ce cas).

Cette méthode enregistre une copie du plan d’image actif dans un fichier image au format spécifié.

<Warning>
  Vous ne pouvez pas utiliser cette méthode pour enregistrer un fichier PDF ne contenant qu’une image. Pour ce faire, utilisez l’une des méthodes d’exportation, par exemple la 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) correspondant, avec [IPDFExportParams::TextExportMode](/fr/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams#textexportmode) défini sur PEM\_ImageOnly.
</Warning>

<div id="syntax">
  ## Syntaxe
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT WriteToFile(
  BSTR                FileName,
  ImageFileFormatEnum Format,
  IImageModification* Modification,
  IUnknown*           ExtendedParams
);
```

### C\#

```csharp theme={null}
void WriteToFile(
  string              FileName,
  ImageFileFormatEnum Format,
  IImageModification   Modification,
  object              ExtendedParams
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub WriteToFile( _
  FileName As String, _
  Format As ImageFileFormatEnum, _
  [Modification As IImageModification = Nothing], _
  [ExtendedParams As Object = Nothing] _
)
```

<div id="parameters">
  ## Paramètres
</div>

FileName

\[in] Ce paramètre contient le chemin complet du fichier image dans lequel l’image doit être enregistrée. Exemples : C:\MyPictures\MyPic.bmp. Si un fichier existe déjà à cet emplacement, il est écrasé sans demande de confirmation.

Format

\[in] Variable de type [ImageFileFormatEnum](/fr/fine-reader/engine/api-reference/enumerations/imagefileformatenum) qui spécifie le format du fichier de sortie. Tous les formats définis par cette énumération ne sont pas pris en charge en écriture.

Modification

\[in] Ce paramètre de type [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification) définit les modifications appliquées à l’image avant son écriture dans le fichier. Ce paramètre est facultatif et peut être égal à 0, auquel cas aucune modification n’est appliquée à l’image.

ExtendedParams

\[in] Cette variable peut référencer un objet [JpegExtendedParams](/fr/fine-reader/engine/api-reference/image-related-objects/jpegextendedparams), [PngExtendedParams](/fr/fine-reader/engine/api-reference/image-related-objects/pngextendedparams) ou [TiffExtendedParams](/fr/fine-reader/engine/api-reference/image-related-objects/tiffextendedparams), qui définit respectivement les paramètres d’enregistrement de l’image aux formats JPEG, PNG ou TIFF. Ce paramètre est facultatif et peut être égal à 0. Dans ce cas, l’image est enregistrée avec une compression JPEG 2000 sans perte dans le cas du format JPEG, sans transparence dans le cas du format PNG, ou avec la qualité par défaut dans le cas du format TIFF.

<Warning>
  Sous Linux, si vous utilisez ABBYY FineReader Engine chargé hors processus, vous devez passer NULL pour ce paramètre.
</Warning>

<div id="return-values">
  ## Valeurs de retour
</div>

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les [valeurs de retour standard des fonctions ABBYY FineReader Engine](/fr/fine-reader/engine/api-reference/return-codes).

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

[Travailler avec des images](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

[ImageFileFormatEnum](/fr/fine-reader/engine/api-reference/enumerations/imagefileformatenum)

[ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification)