개요
TouchEventInfo 오브젝트의 touchinputinfos 또는 changetouchinputinfos 속성에 저장되는 터치입력 정보를 갖는 오브젝트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
- 멀티터치를 지원하는 윈도우7 이상 또는 모바일 환경에서 이벤트가 발생합니다. - TouchEventInfo 오브젝트의 touchinputinfos 속성에 동시에 입력된 터치 수만큼의 TouchInputInfo 오브젝트가 배열형태로 저장됩니다.
속성
canvasx
이벤트 발생 시 컴포넌트 영역을 기준으로 마우스 또는 터치 위치의 x 좌표값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
TouchInputInfo.canvasx
참고
- 마우스 또는 터치 위치의 컴포넌트 좌측 상단을 기준으로 x 좌표를 계산합니다.
canvasy
이벤트 발생 시 컴포넌트 영역을 기준으로 마우스 또는 터치 위치의 y 좌표값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
TouchInputInfo.canvasy
참고
- 마우스 또는 터치 위치의 컴포넌트 좌측 상단을 기준으로 y 좌표를 계산합니다.
clientx
이벤트 발생 시 컴포넌트의 클라이언트 영역을 기준으로 마우스 또는 터치 위치의 x 좌표값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
TouchInputInfo.clientx
참고
- Border, Padding, ScrollBar, StatusBar 등이 표시되는 부분을 제외한 영역이 컴포넌트의 클라이언트 영역입니다. - 마우스 또는 터치 위치의 컴포넌트 클라이언트영역 좌측 상단을 기준으로 x 좌표를 계산합니다.
clienty
이벤트 발생 시 컴포넌트의 클라이언트 영역을 기준으로 마우스 또는 터치 위치의 y 좌표값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
TouchInputInfo.clienty
참고
- Border, Padding, ScrollBar, StatusBar 등이 표시되는 부분을 제외한 영역이 컴포넌트의 클라이언트 영역입니다. - 마우스 또는 터치 위치의 컴포넌트 클라이언트영역 좌측 상단을 기준으로 y 좌표를 계산합니다.
isfirst
멀티터치 되었을 때 현재 좌표정보가 첫번째 입력인지 여부를 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
var vFirst = e.touchinputinfos[0].isfirst ; | ||
"true" | 현재 좌표정보가 첫번째 입력일 때 갖는 값입니다. | |
|---|---|---|
"false" | 현재 좌표정보가 첫번째 입력이 아닐 때 갖는 값입니다. | |
screenx
이벤트 발생 시 모니터 영역을 기준으로 마우스 또는 터치 위치의 x 좌표값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
TouchInputInfo.screenx
참고
- 마우스 또는 터치 위치의 모니터 좌측 상단을 기준으로 x 좌표를 계산합니다.
screeny
이벤트 발생 시 모니터 영역을 기준으로 마우스 또는 터치 위치의 y 좌표값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
TouchInputInfo.screeny
참고
- 마우스 또는 터치 위치의 모니터 좌측 상단을 기준으로 y 좌표를 계산합니다. ◆ Mobile WRE 제약 - Mobile WRE 실행 시 웹브라우저의 주소창 영역에 대한 정보가 운영체제, 브라우저 버전에 따라 다르게 처리될 수 있습니다. 때문에 스크린 좌표값 처리 시 웹브라우저의 주소창 영역은 제외하고 실제 화면이 표시되는 영역을 기준으로 처리합니다.
time
이벤트가 발생한 시간을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
참고
- time 속성값은 기기에서 받은 값을 OS 가 넥사크로로 전달해 줍니다. 따라서 기기에 의해 현재시각과 전혀 다른 값이 나올 수 있습니다.
touchid
멀티터치 되었을 때 각 좌표정보를 구분하기 위한 고유 ID 값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
참고
- touchid 속성은 OS 가 부여하는 숫자값을 갖습니다. 0 이상의 값을 갖지만 반드시 0 부터 시작하지는 않습니다. - 여러 입력이 동시에 발생했을 때, 각각의 입력이 종료(터치를 뗄 때)될 때 까지 해당 ID 값이 유지됩니다.
type
터치의 입력상태를 구분하는 값을 갖는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☑ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
"0" | 터치가 시작(Touch Down) 되었을 때 갖는 값입니다. | |
|---|---|---|
"1" | 터치 후 이동중(Touch Move) 일 때 갖는 값입니다. | |
"2" | 터치가 종료(Touch Up) 되었을 때 갖는 값입니다. | |
참고
- Windows 는 기본적으로 Touch Down 후 이동하지 않고 누르고 있으면, 이를 마우스 오른쪽 버튼 입력으로 변환하여 입력해주는 기능을 지원합니다. 이 기능이 켜져 있으면 Touch Down 을 수행한 즉시 ontouch 이벤트가 발생하지 않을 수 있으며, Windows에서 입력이 일반터치인지, 마우스 오른쪽 버튼 입력인지 판단하는 동안 (Windows7에서 터치 지점 주변으로 동그라미가 그려짐) Touch Up 이 되면, Touch Down -> Touch Move -> Touch Up 이 한꺼번에 발생할 수 있습니다.