IInputEvents インターフェイスの OnKeyUp メソッド

このメソッドはクライアント側で実装されます。Image Viewer、Zoom Viewer、Text Editor、Text Validator、または Document Viewer でキーが放されたときに、ABBYY FineReader Engine によって呼び出されます。

このメソッドは、キー コード、リピート回数、および使用された修飾キーをクライアントに渡します。このメソッドを使用すると、操作をキャンセルできます。

​

構文

​

C++

HRESULT OnKeyUp(
  int           KeyCode,
  int           Count,
  int           Flags,
  VARIANT_BOOL* Cancel
);

​

C#

void OnKeyUp(
  int      KeyCode,
  int      Count,
  int      Flags,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnKeyUp( _
  KeyCode As Integer, _
  Count As Integer, _
  Flags As Integer, _
  ByRef Cancel As Boolean _
)

​

パラメーター

KeyCode

[in] 解放されるキーのキーコードを指定します。

Count

[in] リピート回数、つまりユーザーがキーを押したままにしている間にキーストロークが繰り返される回数を格納します。

Flags

[in] 次の一覧に示すように、スキャンコード、キー遷移コード、直前のキー状態、およびコンテキストコードを格納します。

Value	Description
0-7	スキャンコードを指定します。この値は OEM (Original Equipment Manufacturer) によって異なります。
8	キーが拡張キーかどうかを指定します。たとえば、拡張 101/102 キーボードの右側の ALT キーや CTRL キーなどです。拡張キーの場合は 1、それ以外の場合は 0 です。
9-12	Windows によって内部的に使用されます。
13	コンテキストコードを指定します。キーが押されたときに ALT キーも押されたままである場合は 1、それ以外の場合は 0 です。
14	直前のキー状態を指定します。メッセージが送信される前にキーが押下状態であれば 1、離されていれば 0 です。
15	遷移状態を指定します。キーが解放されるときは 1、押されるときは 0 です。

Cancel

[out] この変数を TRUE に設定すると、処理を終了する必要があることを示せます。この場合、対応する関数は E_ABORT を返します。

​

戻り値

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

​

注記

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

​

関連項目

IInputEvents