그리드 » Event

on_prekeydown

Description

사용자가 입력한 키보드 이벤트에 대해서 표시 및 처리하기 전에 호출되는 이벤트이다.

Parameters

Parameters Type Description
objInst INSTANCE 컴포넌트 인스턴스
keycode short 키 코드
bctrldown BOOL CTRL 키 누름 상태 여부
bshiftdown BOOL SHIFT 키 누름 상태 여부
baltdown BOOL ALT 키 누름 상태 여부
bnumpadkey BOOL 숫자 패드에서 발생한 키 여부
bediting BOOL 아이템 편집 상태 여부
nRow long 그리드 행 인덱스 (Zero-Based)
nColumn short 그리드 열 인덱스 (Zero-Based)

Return Value

Type Description
short 입력된 키에 대한 기본 동작 방식 지정

Remark

on_keydown 이벤트 발생전에 발생하며, 리턴값을 이용하여 입력된 키에 대한 기본 동작 수행 여부를 지정할 수 있다.

리턴값이 0인 경우, 키에 대한 기본 동작이 수행된다.

리턴값이 1인 경우, 키에 대한 기본 동작을 수행하지 않는다.

Example

/**
 * 키보드 이벤트 처리 전 이벤트
 * 키보드 이벤트에 대한 처리를 수행하기 전에 발생한다.
 *
 * @param {Object} objInst 이벤트가 발생한 컴포넌트 인스턴스
 * @param {number} keycode 키코드
 * @param {boolean} bctrldown CTRL 키 누름 상태 여부
 * @param {boolean} bshiftdown SHIFT 키 누름 상태 여부
 * @param {boolean} baltdown  ALT 키 누름 상태 여부
 * @param {boolean} bnumpadkey 숫자 패드에서 발생한 키 여부
 * @param {boolean} bediting 아이템 편집 상태 여부
 * @param {number} nRow 그리드 행 인덱스 (Zero-Based)
 * @param {number} nColumn 그리드 열 인덱스 (Zero-Based)
 *
 * @returns {number} 키에 대한 처리 방식
 * 	0 - 키에 대한 기본 동작이 수행됨
 * 	1 - 키에 대한 기본 동작을 수행하지 않음
 */
function grd_on_prekeydown(objInst, keycode, bctrldown, bshiftdown, baltdown, bnumpadkey, bediting, nRow. nColumn)
{
	var i, arrData, strData;
	
	// Control+C 키 이벤트
	if (event.ctrlKey && event.keyCode == 67) { 
		arrData = [];
		for (i = 0; i < grd.getrowcount(); i++) {
			arrData.push(grd.getitemtext(i, 0));
		}	
			
		strData = arrData.join(",");
		factory.setclipboarddata(strData);

        // Control+C 키 기본 동작을 수행하지 않음
		return 1;
	}
	
	// 키에 대한 기본 동작 수행
	return 0;
}

See Also

on_keydown

Viewer Ver.

9.1.1.1

Update Date

20230612