그리드에 로우를 추가하면서 text 추가, 리페인트, 스크롤 새로고침 등의 옵션을 설정할 수 있는 API이다. 마지막 파라미터 bSetInitValue 는 옵션 파라미터로 값을 주지 않을 경우 기본값은 true이다.
| Parameters | Type | Description |
|---|---|---|
| nSubRow | short | 입력할 서브로우 인덱스 |
| nCol | short | 입력할 컬럼의 인덱스 |
| strText | STRING | 입력할 데이타 |
| bRepaint | BOOL | 리페인트 여부(true, false) |
| bRefreshScroll | BOOL | 스크롤 새로고침 여부(true, false) |
| bSetInitValue | BOOL | [옵션] 초기값 채움 여부(기본값 true) |
| Type | Description |
|---|---|
| long | 추가된 row 인덱스 |
* 가장 마지막 로우 다음에 추가된다. * 특정 컬럼에 원하는 TEXT를 입력하여 추가할 수 있으며 리페인트를 할 수 있다. 또한 그리드 높이보다 로우가 많이 추가되면 스크롤이 생기는데 * 스크롤 새로고침을 true, false로 결정할 수 있다.
모든 칼럼에 초기값을 설정하려면, nSubRow, nCol 파라미터 값을 -1로 지정한다.
bRepaint 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.
만약 많은 수의 행에 대해서 루핑 돌면서 호출하는 경우라면, bRepaint 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
function btn_on_mouseup()
{
// 인덱스 2의 컬럼에 "1"이라는 텍스트를 입력하여 row 추가
// 마지막 초기값채움 파라미터는 옵션으로 값을 줄수도 안줄수도 있음
// 리페인트 사용 true, 스크롤 새로고침 사용 false, 초기값채움 true
grd.additemex(0, 2, "1", true, false);
// 리페인트 사용 true, 스크롤 새로고침 사용 true, 초기값채움 false
grd.additemex(0, 2, "1", true, true, false);
}