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

# Image オブジェクトの WriteToFile メソッド

> ABBYY FineReader Engine API の Image オブジェクトの WriteToFile メソッド。現在のイメージ プレーンのコピーを、指定した形式の画像ファイルに保存します。画像のみの PDF には使用できません（その場合は Export メソッドを使用します）。

このメソッドは、現在のイメージ プレーンのコピーを、指定した形式の画像ファイルとして保存します。

<Warning>
  このメソッドでは、画像のみの PDF ファイルを保存できません。これを行うには、エクスポート メソッドのいずれかを使用します。たとえば、対応する [FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) オブジェクトの [Export](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/export-method) メソッドで、[IPDFExportParams::TextExportMode](/ja/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams#textexportmode) を PEM\_ImageOnly に設定します。
</Warning>

<div id="syntax">
  ## 構文
</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">
  ## パラメーター
</div>

FileName

\[in] 画像の保存先となる画像ファイルのフルパスを指定するパラメーターです。例: C:\MyPictures\MyPic.bmp。このパスにすでにファイルが存在する場合は、確認なしで上書きされます。

Format

\[in] 出力ファイルの形式を指定する [ImageFileFormatEnum](/ja/fine-reader/engine/api-reference/enumerations/imagefileformatenum) 型の変数です。この列挙型で定義されている形式のすべてが書き込みに対応しているわけではありません。

Modification

\[in] [ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) 型のパラメーターで、画像をファイルに書き込む前に適用する変更を定義します。このパラメーターは省略可能で、0 を指定できます。この場合、画像には何も変更は適用されません。

ExtendedParams

\[in] この変数は、画像をそれぞれ JPEG、PNG、または TIFF 形式で保存するためのパラメーターを定義する [JpegExtendedParams](/ja/fine-reader/engine/api-reference/image-related-objects/jpegextendedparams)、[PngExtendedParams](/ja/fine-reader/engine/api-reference/image-related-objects/pngextendedparams)、または [TiffExtendedParams](/ja/fine-reader/engine/api-reference/image-related-objects/tiffextendedparams) オブジェクトを参照できます。このパラメーターは省略可能で、0 を指定できます。この場合、JPEG ではロスレス JPEG 2000 圧縮、PNG では透過なし、TIFF では既定の品質で画像が保存されます。

<Warning>
  Linux で ABBYY FineReader Engine をアウトオブプロセスで読み込んで使用している場合、このパラメーターには NULL を渡す必要があります。
</Warning>

<div id="return-values">
  ## 戻り値
</div>

このメソッド固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準戻り値](/ja/fine-reader/engine/api-reference/return-codes)が返されます。

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

[画像の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

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

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