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

# FRDocument オブジェクトの AddImageFileFromStream メソッド

> ABBYY FineReader Engine API の FRDocument オブジェクトの AddImageFileFromStream メソッド — ユーザーが実装した入力ストリームから画像ファイルを開き、そのページをドキュメントに追加します。Windows では OutprocLoader と併用できます。

このメソッドは、ユーザーが実装した入力ストリームから画像ファイルを開き、開いたファイルに対応するページをドキュメントに追加します。

Windows では、このメソッドは [AddImageFileFromMemory](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefrommemory-method) メソッドと異なり、Engine オブジェクトが [OutprocLoader](/ja/fine-reader/engine/api-reference/engine-loaders/outprocloader) オブジェクトを使用して作成されている場合に使用できます。

<div id="syntax">
  ## 構文
</div>

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

```cpp theme={null}
HRESULT AddImageFileFromStream(
  IReadStream*            Stream,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  IIntsCollection*        PageIndices,
  BSTR                    FileName
);
```

### C\#

```csharp theme={null}
void AddImageFileFromStream(
  IReadStream             Stream,
  IImagePasswordCallback  Callback,
  IPrepareImageMode       PrepareMode,
  IIntsCollection         PageIndices,
  string                  FileName
);
```

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

```vb theme={null}
Sub AddImageFileFromStream( _
  Stream As IReadStream, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [PageIndices As IIntsCollection = Nothing], _
  [FileName As String = "0"] _
)
```

<div id="parameters">
  ## パラメーター
</div>

Stream

\[in] ドキュメントに追加する画像ファイルを含む、型 [IReadStream](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/ireadstream) のユーザー実装オブジェクトのインターフェイスを指します。

Callback

\[in] PDF 形式の画像にアクセスする際に必要になる可能性があるパスワード要求を処理するために使用される、型 [ImagePasswordCallback](/ja/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback) のユーザー実装オブジェクトのインターフェイスを指す変数です。このパラメーターは省略可能で、0 を指定できます。その場合、パスワードで保護されたファイルは処理できません。

PrepareMode

\[in] オープン時に画像をどのように前処理するかを指定する [PrepareImageMode](/ja/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) オブジェクトを指します。このパラメーターは省略可能で、0 を指定できます。その場合は既定のパラメーターが使用されます。[プロファイル](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) が読み込まれている場合は、そのプロファイルで設定されたパラメーターが使用されます。

PageIndices

\[in] ドキュメントに追加するページのインデックスを指定する [IntsCollection](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection) オブジェクトを指すパラメーターです。重複したインデックスは指定できない点に注意してください。同じページを複数回追加するには、このメソッドを複数回呼び出してください。<br />このパラメーターは省略可能で、0 を指定できます。その場合、開いたファイル内のすべてのページがドキュメントに追加されます。

FileName

\[in] 画像ファイルの名前を指定します。この情報は、ファイル形式が明示的に指定されていない場合にその判別に使用され、またエラーメッセージでも使用されます。このパラメーターは省略可能で、0 を指定できます。

Windows および Linux: Office 形式を開くには、拡張子を含むドキュメント名を渡します。

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

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

<div id="remarks">
  ## 注記
</div>

* SVG 形式のファイルは、ストリームから開くことはできません。
* このメソッドで PDF Portfolio ファイルを開くと、その表紙は常に出力ファイルに含まれます。
* このメソッドは、[FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument) オブジェクトの IConnectionPointContainer インターフェイスに接続されているリスナーに対して、イベントを通知することがあります。
* Linux および Windows の場合:
  * ライセンスに [Office Formats Opening](/ja/fine-reader/engine/licensing/modules#officeformatsopening) モジュールが含まれている場合、このメソッドを使用して[サポートされている形式](/ja/fine-reader/engine/specifications/supported-digital-document-input-formats)のデジタル文書を開くこともできます。
  * [IEngine::MultiProcessingParams](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/properties#multiprocessingparams) プロパティの値によっては、ABBYY FineReader Engine は複数ページの文書を開く処理を CPU コアに分散できます。
* Linux の場合: Engine オブジェクト が別プロセス サーバーとして読み込まれていると、このメソッドは動作しません。
* Windows の場合: このメソッドでは、WIC 互換ファイルを開くことはできません。

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

[FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument)