그리드 특정 아이템에 텍스트를 입력하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| nRow | long | 로우 인덱스 |
| strColName | STRING | 컬럼 이름 |
| strText | LPCTSTR | 텍스트 |
| bRefresh | BOOL | [옵션] 새로고침 여부 (기본값: true) |
| Type | Description |
|---|---|
| BOOL | 정상 처리 여부 |
bRefresh 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.
만약 많은 수의 아이템에 대해서 루핑 돌면서 호출하는 경우라면, 해당 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
setitemtextbyname API를 통해서 소계 데이터는 업데이트되지 않기 때문에, 소계행을 사용하는 경우, setitemtextex API를 사용해야 한다.
setitemtextex API를 호출시 bRefresh 파라미터 및 bRefreshStatData 파라미터 값을 false로 지정하여 값을 모두 설정한 이후에, refresh API를 호출해야 소계 정보가 업데이트 되어 표시된다.
strText 파라미터 값에 소수점 값에 대한 지수 표현은 소수점 6자리까지만 허용되며, 7자리 이상의 지수 표현은 지원하지 않는다.
소수점 7자리 이상의 값에 대해서는 문자열 형식으로 값을 설정하거나, toFixed 함수를 호출한 값의 리턴값으로 strText 파라미터 값을 설정하여 호출해야 한다.
function btn_on_mouseup()
{
// 값은 set하고 즉시 Refresh하지 않는 경우.
grd.setitemtextbyname(0, "column_01", "test", false);
grd.setitemtextbyname(0, "column_02", "test", false);
grd.refresh();
// 값은 set하고 즉시 repaint하는 경우.
grd.setitemtextbyname(0, "column_01", "test", true);
}