트리그리드 » Api

setitemtextex

Description

트리 그리드 특정 아이템에 텍스트를 입력 후 트리 그리드를 새로고침또는 컬럼병합등 옵션처리를 할 수 있는 API입니다.

Parameters

Parameters Type Description
nRow long 로우 인덱스
nCol long 컬럼 인덱스
strText STRING 텍스트
bRefresh BOOL 그리드 리프레쉬 여부(true, false)
bConsiderColumnMerge BOOL [옵션] 컬럼병합을 할지 여부(true, false)
bFireChangeEvent BOOL [옵션] on_itemvaluechanged 이벤트 발생 여부(기본값: true)
bEventAsync BOOL [옵션] on_itemvaluechanged 이벤트를 Async로 처리 할지 여부
bRefreshStatData BOOL [옵션] 통계행 데이터 업데이트 여부 (기본값: true)

Return Value

Type Description
BOOL 정상적용여부(true, false)

Remark

bRefresh 파라미터가 false인 경우, setitemtextex API를 통해서 소계/통계 데이터는 업데이트되지 않는다.

bRefresh 파라미터가 true인 경우, setitemtextex API를 통해서 소계 데이터는 업데이트되지 않는다. 소계행을 사용하는 경우, setitemtextex API를 호출시 bRefresh 파라미터를 false로 지정하여 값을 모두 설정한 이후에, refresh API를 호출해야 한다.

파라미터 bConsiderColumnMerge 는 옵션 파라미터로 값을 주지 않으면 Default는 true이고 해당 컬럼이 컬럼병합 속성이 있는 경우 Text를 반영하는 즉시 해당 컬럼의 컬럼병합을 적용할지 여부입니다.

bRefresh 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.

만약 많은 수의 아이템에 대해서 루핑 돌면서 호출하는 경우라면, 해당 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.

strText 파라미터 값에 소수점 값에 대한 지수 표현은 소수점 6자리까지만 허용되며, 7자리 이상의 지수 표현은 지원하지 않는다.

소수점 7자리 이상의 값에 대해서는 문자열 형식으로 값을 설정하거나, toFixed 함수를 호출한 값의 리턴값으로 strText 파라미터 값을 설정하여 호출해야 한다.

Example

function btn_on_mouseup() { // 컬럼 병합을 한번만 하기위해서 setitemtextex를 사용 // 속도면에서 훨씬 유리합니다. for(var nRow = 0;nRow < grd.getrowcount();nRow++) { grd.setitemtextex(nRow, 0, "test", false, false); } grd.refresh(); }

See Also

setitemtext
getitemtext
setitemtextbyname

Viewer Ver.

9.1.1.1

Update Date

20230503