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

# IProcessingEvents インターフェイスの OnWarning メソッド

> ABBYY FineReader Engine API の IProcessingEvents インターフェイスにある OnWarning メソッド — 処理中に発生したヒントや警告を通知するために Engine.InjectTextLayer から呼び出されるクライアント側のメソッド。

このメソッドはクライアント側で実装されます。ABBYY FineReader Engine によって、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [InjectTextLayer](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method) メソッドから呼び出されます。処理中に発生したヒントや警告がクライアントに通知されます。また、長時間の処理中にアプリケーションが応答していないように見えるのを防ぐため、システムメッセージを処理することもできます。

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

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

```cpp theme={null}
HRESULT OnWarning(
  int           PageIndex,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);
```

### C\#

```csharp theme={null}
void OnWarning(
  int      PageIndex,
  string   Warning,
  ref bool Cancel
);
```

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

```vb theme={null}
Sub OnWarning( _
  PageIndex As Integer, _
  Warning As String, _
  ByRef Cancel As Boolean _
)
```

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

PageIndex

\[in] このパラメーターには、ヒントまたは警告の対象となるページのインデックスが格納されます。メッセージは特定の 1 ページだけでなく、ドキュメント全体を対象とすることもできます。この場合、パラメーターの値は -1 です。

Warning

\[in] ヒントまたは警告が格納されます。

Cancel

\[in, out] この変数を TRUE に設定すると、処理を中止する必要があることを示せます。この場合、ヒントを通知する処理関数は E\_ABORT を返します。

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

\[C++ のみ] このメソッドが S\_OK 以外の値を返した場合は、クライアント側でエラーが発生したことを示します。この場合、Cancel パラメーターの値は考慮されません。

<div id="remarks">
  ## 備考
</div>

このメソッドのクライアント実装では、メソッド内でスローされるすべての例外を確実にキャッチして処理し、例外がメソッドの外に伝播しないようにする必要があります。例外がメソッドの外に伝播すると、予期しない結果 (プログラムの終了など) を招くおそれがあります。

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

[IProcessingEvents](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/iprocessingevents)

[IEngine::InjectTextLayer](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method)