跳轉到主要內容
此方法會在用戶端實作。當按鍵動作在 Image Viewer、Zoom Viewer、Text Editor、Text Validator 或 Document Viewer 中轉換成字元時，ABBYY FineReader Engine 會呼叫此方法。 此方法會將字元碼、重複次數，以及按鍵動作的其他相關資訊傳送給客戶端。也可以透過此方法取消作業。

​
語法

​
C++

HRESULT OnChar(
  int           Character,
  int           Count,
  int           Flags,
  VARIANT_BOOL* Cancel
);

​
C#

void OnChar(
  int      Character,
  int      Count,
  int      Flags,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnChar( _
  Character As Integer, _
  Count As Integer, _
  Flags As Integer, _
  ByRef Cancel As Boolean _
)

​
參數

Character [in] 包含按鍵的字元碼值。 Count [in] 包含 重複次數，也就是使用者按住按鍵時，按鍵動作 重複的次數。 Flags [in] 包含掃描碼、按鍵轉換碼、先前的按鍵狀態及內容碼，如下表所示：
ValueDescription
0-7指定掃描碼。其值取決於原始設備製造商 (OEM)。
8指定該按鍵是否為擴充按鍵，例如增強型 101 鍵或 102 鍵鍵盤右側的 ALT 與 CTRL 鍵。若為擴充按鍵，值為 1；否則為 0。
9-12供 Windows 內部使用。
13指定內容碼。若按下該按鍵時同時按住 ALT 鍵，值為 1；否則值為 0。
14指定先前的按鍵狀態。若在訊息送出前該按鍵處於按下狀態，值為 1；若處於未按下狀態，則為 0。
15指定轉換狀態。若該按鍵正在釋放，值為 1；若該按鍵正在按下，則為 0。
Cancel [out] 您可以將此變數設為 TRUE，表示應終止此程序。

​
回傳值

[僅限 C++] 如果此方法回傳的值不是 S_OK，表示用戶端發生錯誤；在此情況下，將不考慮 Cancel 參數的值。

​
備註

此方法的客戶端實作必須確保，凡是在方法內部拋出的所有例外都會被攔截並處理，且不會有任何例外傳播到方法之外。例外若傳播到方法之外，可能會導致不可預期的結果 (例如程式終止) 。

​
另請參閱

IInputEvents