> ## 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 オブジェクトの AddImageFileWithPasswordCallback メソッド

> ABBYY FineReader Engine API における FRDocument オブジェクトの AddImageFileWithPasswordCallback メソッド — IImagePasswordCallback を使用して画像ファイルを開き、そのページをDocumentに追加します。IConnectionPoint イベントを発行します。

このメソッドは、[IImagePasswordCallback](/ja/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback) インターフェイスを使用して画像ファイルを開き、開いたファイルに対応するページをDocumentに追加します。

このメソッドは、[FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument) オブジェクトの IConnectionPointContainer インターフェイスに接続されているリスナーに対して、イベントを通知する場合があります。

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

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

```cpp theme={null}
HRESULT AddImageFileWithPasswordCallback(
  BSTR                    ImageFileName, 
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  IIntsCollection*        PageIndices   
);
```

### C\#

```csharp theme={null}
void AddImageFileWithPasswordCallback(
  string                 ImageFileName, 
  IImagePasswordCallback Callback,
  IPrepareImageMode       PrepareMode,
  IIntsCollection         PageIndices   
);
```

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

```vb theme={null}
Sub AddImageFileWithPasswordCallback( _
  ImageFileName As String, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [PageIndices As IIntsCollection = Nothing] _
)
```

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

ImageFileName

\[in] この変数には、開く画像ファイルのフルパスが格納されます。

Callback

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

PrepareMode

\[in] このパラメータは [PrepareImageMode](/ja/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) オブジェクトを参照し、画像を開く際の前処理方法を指定します。

PageIndices

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

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

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

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

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

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

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

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

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

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