개요

Grid 컴포넌트에서 Drag 액션과 관련하여 발생하는 이벤트에 전달되는 EventInfo 오브젝트입니다.

지원 환경

속성

altkey

이벤트 발생 시 Alt 키가 눌렸는지 여부를 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.altkey

문법 설정

var bAlt = e.altkey;

button

이벤트를 발생시킨 버튼 또는 터치에 대한 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.button

문법 설정

var strButton = e.button;

canvasx

이벤트 발생 시 컴포넌트 영역을 기준으로 마우스 또는 터치 위치의 x 좌표값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.canvasx

참고

- 마우스 또는 터치 위치의 컴포넌트 좌측 상단을 기준으로 x 좌표를 계산합니다.

canvasy

이벤트 발생 시 컴포넌트 영역을 기준으로 마우스 또는 터치 위치의 y 좌표값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.canvasy

참고

- 마우스 또는 터치 위치의 컴포넌트 좌측 상단을 기준으로 y 좌표를 계산합니다.

cell

이벤트가 발생한 Cell 이 밴드에서 위치한 인덱스값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.cell

문법 설정

var nCell = e.cell;

참고

- Head,Body,Summary 밴드는 각 밴드별로 Cell 목록을 가집니다.

- Cell 인덱스는 왼쪽에서 오른쪽으로 위에서 아래로 지정됩니다.

clientx

이벤트 발생 시 컴포넌트의 클라이언트 영역을 기준으로 마우스 또는 터치 위치의 x 좌표값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.clientx

참고

- Border, Padding, ScrollBar, StatusBar 등이 표시되는 부분을 제외한 영역이 컴포넌트의 클라이언트 영역입니다.

- 마우스 또는 터치 위치의 컴포넌트 클라이언트영역 좌측 상단을 기준으로 x 좌표를 계산합니다.

clienty

이벤트 발생 시 컴포넌트의 클라이언트 영역을 기준으로 마우스 또는 터치 위치의 y 좌표값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.clienty

참고

- Border, Padding, ScrollBar, StatusBar 등이 표시되는 부분을 제외한 영역이 컴포넌트의 클라이언트 영역입니다.

- 마우스 또는 터치 위치의 컴포넌트 클라이언트영역 좌측 상단을 기준으로 y 좌표를 계산합니다.

col

이벤트가 발생한 Cell 의 Column 인덱스값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.col

문법 설정

var nCol = e.col;

참고

- Column 인덱스값은 왼쪽에서 오른쪽으로 지정됩니다.

ctrlkey

이벤트 발생시 Ctrl 키가 눌렸는지 여부를 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.ctrlkey

문법 설정

var bCtrl = e.ctrlkey;

datatype

Drag 액션이 발생한 위치에 대한 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.datatype

문법 설정

var strDataType = e.datatype;

참고

- 어플리케이션 외부에서 텍스트를 Drag 한 경우는 Drag 관련 이벤트가 발생하지 않습니다.

활용 예제

• 선택한 파일 업로드하기

eventid

이벤트의 ID를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.eventid

문법 설정

var strEventid = e.eventid;

참고

- 이벤트에 핸들러로 등록된 함수의 이름이 아닌 발생한 이벤트명을 갖습니다.

filelist

어플리케이션 외부에서 파일을 Drag 했을 때 파일의 정보를 배열형태로 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.filelist

문법 설정

var objFile0 = e.filelist[0];

참고

◆ web runtime environment 제약

- ondrop 이벤트 외 ondrag, ondragenter, ondragleave, ondragmove 이벤트에서 filelist 속성값이 정확하지 않을 수 있습니다.

활용 예제

• 선택한 파일 업로드하기

fromobject

이벤트 발생의 원인이 되는 컴포넌트를 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.fromobject

문법 설정

var objComp = e.fromobject;

참고

- onlbuttondown 과 같이 상위로 전파되는 이벤트에서 fromobject 속성은 이벤트가 최초로 발생한 컴포넌트를 갖습니다.

fromreferenceobject

이벤트 발생의 원인이 되는 컴포넌트 또는 서브컨트롤을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.fromreferenceobject

문법 설정

var objComp = e.fromreferenceobject;

참고

- Calendar 와 같이 서브컨트롤이 있는 컴포넌트에서 서브컨트롤에 의해 이벤트가 발생한 경우 fromreferenceobject 속성은 서브컨트롤을 갖습니다.
  Button 과 같이 서브컨트롤이 없는 컴포넌트는 해당 컴포넌트를 갖습니다.

- onlbuttondown과 같이 상위로 전파되는 이벤트에서 fromreferenceobject 속성은 이벤트가 최초로 발생한 컴포넌트 또는 서브컨트롤을 갖습니다.

metakey

이벤트 발생 시 command(또는 windows) 키가 눌렸는지 여부를 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.metakey

문법 설정

var bMeta = e.metakey;

참고

- mac 키보드에서 command 키, 윈도우 키보드에서 Windows 키 입력 여부를 반환합니다.
- Firefox 브라우저는 Windows 운영체제에서 키 입력 상태를 반환하지 않습니다.

row

이벤트가 발생한 Cell 의 Row 인덱스값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.row

문법 설정

var nRow = e.row;

참고

- Grid 에 바인딩된 DataSet 의 rowposition 속성값과 같은 값을 갖습니다.

- Head 밴드에서 이벤트가 발생하면 "-1" 값을 갖습니다.

- Summary 밴드에서 이벤트가 발생하면 "-2" 값을 갖습니다.

- Grid 가 트리형태일 때 화면에 표시되는 위치와 DataSet 의 rowposition 값이 달라집니다.
  화면에 표시되는 위치의 Row 인덱스값이 필요할 때는 Grid 의 getTreeRow() 메소드를 사용하여야 합니다.

this.Grid00_ondrag = function(obj:nexacro.Grid, e:nexacro.GridEditEventInfo)
{
    trace(obj.getTreeRow(e.row));
}

screenx

이벤트 발생 시 모니터 영역을 기준으로 마우스 또는 터치 위치의 x 좌표값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.screenx

참고

- 마우스 또는 터치 위치의 모니터 좌측 상단을 기준으로 x 좌표를 계산합니다.

screeny

이벤트 발생 시 모니터 영역을 기준으로 마우스 또는 터치 위치의 y 좌표값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.screeny

참고

- 마우스 또는 터치 위치의 모니터 좌측 상단을 기준으로 y 좌표를 계산합니다.

◆ Mobile WRE 제약

- Mobile WRE 실행 시 웹브라우저의 주소창 영역에 대한 정보가 운영체제, 브라우저 버전에 따라 다르게 처리될 수 있습니다.
  때문에 스크린 좌표값 처리 시 웹브라우저의 주소창 영역은 제외하고 실제 화면이 표시되는 영역을 기준으로 처리합니다.

shiftkey

이벤트 발생시 Shift 키가 눌렸는지 여부를 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.shiftkey

문법 설정

var bshiftkey = e.shiftkey;

sourceobject

Drag 액션이 처음 발생한 컴포넌트를 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.sourceobject

참고

- ondrag 이벤트에서 리턴값을 "true" 로 반환한 컴포넌트를 갖습니다.

sourcereferenceobject

Drag 액션이 처음 발생한 컴포넌트 또는 서브컨트롤을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.sourcereferenceobject

참고

- ondrag 이벤트에서 리턴값을 "true" 로 반환한 컴포넌트 또는 서브컨트롤을 갖습니다.

- Calendar 와 같이 서브컨트롤이 있는 컴포넌트에서 서브컨트롤에 의해 이벤트가 발생한 경우 sourcereferenceobject 속성은 서브컨트롤을 갖습니다.
  Button 과 같이 서브컨트롤이 없는 컴포넌트는 해당 컴포넌트를 갖습니다.

subrow

이벤트가 발생한 Cell 의 subrow 인덱스값을 갖는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.subrow

문법 설정

var nSubrow = e.subrow;

참고

- 병합된 Cell 일 경우 병합된 Cell 중 첫번째 Cell 의 subrow 값을 갖습니다.

userdata

Drag 관련 이벤트에서 사용자가 값을 설정하여 사용할 수 있는 속성입니다.

지원 환경

속성 타입

문법

GridDragEventInfo.userdata[= varUserData]

문법 설정

e.userdata = "userData";

참고

- ondrag 이벤트에서 userdata 속성값을 설정하면, 다른 Drag 관련 이벤트 발생 시 설정된 속성값이 유지되어 전달됩니다.

- Drag 가 유지되는 동안만 속성값이 유지되며, Drop 되어 Drag 액션이 종료되면 속성값도 지워집니다.