ActiveAreaEnable

Description
액티브 영역을 새로 만들고 사용자의 입력이 가능하도록 한다. 그리고 응용프로그램의 액티브 영역 리스트에 추가한다.

Syntax
S16 ActiveAreaEnable(P_U32 areaId, U32 code, U32 mode, S16 xSrc, S16 ySrc, S16 xDest, S16 yDest)

Parameters
areaId시스템에서 리턴되는 액티브 영역 아이디
code액티브 영역의 종류
ICON_AREA 아이콘을 위한 영역
INPUT_AREA 펜 입력을 위한 영역
mode이 인자는 code가 INPUT_AREA인 경우에만 유효
STROKE_MODE 매 스트로크마다 한 번의 인터럽트
CONTINUOUS_MODE 모여진 점들에 한 번의 인터럽트
CONFINED_MODE STROKE_MODE와 유사하지만 펜 입력이 액티브 영역에 국한된다.
xSrc액티브 영역의 시작점의 X좌표 값
ySrc액티브 영역의 시작점의 Y좌표 값
xDest액티브 영역의 끝점의 X좌표 값
yDest액티브 영역의 끝점의 Y좌표 값

Returns
value설명
CVOS_OK성공적인 수행
CVOS_ERR_AREA_ID잘못된 액티브 영역 포인터
CVOS_ERR_AREA_CODE잘못된 액티브 영역의 종류
CVOS_ERR_COORDINATE잘못된 액티브 영역의 좌표 값
CVOS_ERR_NO_MEMORY메모리가 충분치 않음

Comments
일반적으로 액티브 영역은 화면의 사각형 영역으로 정의된다. 액티브 영역이 눌려졌을 때 소프트웨어 인터럽트 메시지가 액티브 영역을 만든 응용 프로그램에 보내지게 된다. 액티브 영역은 반드시 터치 패널의 영역 안에서 정의되어야 한다. 사용자의 입력이 발생했을 경우 시스템에서는 액티브 영역의 아이디와 함께 이벤트를 발생시켜 액티브 영역을 만든 응용 프로그램에 넘겨주게 되며 이 때 발생되는 이 벤트는 다음과 같다.

AREATOUCHDOWNEVENT액티브 영역을 펜으로 눌렀을 때
AREATOUCHUPEVENT액티브 영역에서 펜을 뗐을 때
AREATOUCHOUTEVENT 액티브 영역바깥으로 펜이 나갔을 때
AREATOUCHINEVENT액티브 영역 안으로 펜이 들어왔을 때

See Also
ActiveAreaDisable, ActiveAreaSuspend, ActiveAreaRead