IInputEvents 인터페이스의 OnChar 메서드

이 메서드는 클라이언트 측에서 구현됩니다. 이미지 뷰어, 확대 뷰어, 텍스트 편집기, 텍스트 검증기 또는 문서 뷰어에서 키 입력이 문자로 해석되면 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] 다음 목록과 같이 스캔 코드, 키 전이 코드, 이전 키 상태 및 컨텍스트 코드를 포함합니다.

값	설명
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