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

# ITextEditorEvents インターフェイスの OnActivePageChanging メソッド

> Windows 上の ABBYY FineReader Engine Visual Components における ITextEditorEvents インターフェイスの OnActivePageChanging メソッド — このメソッドはクライアント側で実装されます。

このメソッドはクライアント側で実装されます。[Text Editor](/ja/fine-reader/engine/visual-components-reference/texteditor) でアクティブ ページが切り替わる前に、ABBYY FineReader Engine によって呼び出されます。この処理は、Text Editor または同期されている任意のコンポーネントのグラフィカル ユーザー インターフェイスからページが変更された場合に実行されます。Text Editor の API を介してアクティブ ページが変更された場合、またはアクティブ ページが削除された場合、この処理は実行されません。

このメソッドは、新たにアクティブになるページへの参照をクライアントに渡します。このメソッドを使用すると、この操作をキャンセルできます。

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

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

```cpp theme={null}
HRESULT OnActivePageChanging(
  IFRPage*      Page,
  VARIANT_BOOL* Cancel
);
```

### C\#

```csharp theme={null}
void OnActivePageChanging(
  IFRPage   Page,
  out bool Cancel
);
```

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

```vb theme={null}
Sub OnActivePageChanging( _
  Page As IFRPage, _
  ByRef Cancel As Boolean _
)
```

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

Page

\[in] 新しいアクティブページを含む [FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) オブジェクトを参照します。このパラメーターには NULL を指定することもできます。これは、ドキュメント内にアクティブページが存在しないことを意味します (たとえば、すべてのページが削除されている場合) 。

Cancel

\[out] プロセスを終了する必要があることを示すには、この変数を TRUE に設定します。この場合、アクティブページは変更されません。

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

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

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

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

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

[ITextEditorEvents](/ja/fine-reader/engine/visual-components-reference/itexteditorevents)