멀티라인 그리드 특정 아이템에 배경색을 설정하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| nRow | long | 로우 인덱스 |
| nSubRow | short | 서브 로우 인덱스 |
| nColumn | short | 컬럼 인덱스 |
| clrBack | COLOR | 배경색 |
| bRefresh | BOOL | [옵션] 그리드 리프레쉬 여부(true/false), 기본값 true |
| Type | Description |
|---|---|
| BOOL | 정상 적용 여부(true, false) |
만약 특정 아이템의 색상을 변경한 후 어느 시점에 해당 아이템의 색상을 원래대로 즉 컬럼의 색상을 따라가도록 하려면 파라미터 clrBack 값에 -1을 주면 된다.
+ 주의사항 + item의 속성과 column 속성은 차이가 있다. 우리가 흔히 사용하는 그리드열 속성 등록창은 컬럼에 속성을 지정하는 것이다. 0번째 컬럼에 속성을 지정하더라도 0번째 컬럼에 속해 있는 아이템에 일일이 속성이 지정된 것이 아니라 아이템을 싸고 있는 컬럼이라는 대표 속성에 지정한 것이다. 그러므로 item에 어떤 속성을 가져올때는 그 item에 속성을 따로 지정했는가부터 확인해야 한다. 설정하지 않은 경우 -1이 리턴된다.
bRefresh 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.
만약 많은 수의 아이템에 대해서 루핑 돌면서 호출하는 경우라면, 해당 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
function btn_on_mouseup()
{
var clrBack = mgrdTest.getitembackcolor(0,0,0);
//0번째 컬럼 배경색이 따로 설정되어 있다면
if(clrBack != -1) {
mgrdTest.setitembackcolor(0,0,1,clrBack);
//해당 색을 1번째 컬럼 배경색으로 지정한다.
}
}