그리드 특정 컬럼의 배경색을 설정하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| nColumn | short | 컬럼 인덱스 |
| clrBack | COLOR | 컬럼 배경색 |
| bClearItemProp | BOOL | [옵션] 아이템별 속성 정보 삭제 여부(기본값 false) |
| nApplyType | short | [옵션] Divide Color 적용 유형 (기본값 0) |
| bRefresh | BOOL | [옵션] 그리드 리프레쉬 여부(기본값 true) |
| Type | Description |
|---|---|
| BOOL | 정상 처리 여부 |
setcolumnbackcolor 함수와 다른 점은, 지정된 색상이 cell_dividecolor 속성보다 우선한다는 점이다.
만약 아이템의 색상을 원래대로, 즉 컬럼의 색상을 따라가도록 하려면 파라미터 clrBack 값에 -1을 주면 된다.
item별 backcolor 속성은 유지된다. item별 backcolor을 지우기 위해서는 setcolumnitembackcolorex 함수를 사용한다.
nApplyType 값이 0인 경우, divide_color에 우선하여 색상이 적용되고, 1인 경우, divide_color가 우선한다.
bRefresh 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.
만약 많은 수의 칼럼에 대해서 루핑 돌면서 호출하는 경우라면, 해당 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
function btnsetColcolor_on_mouseup()
{
// 배경색을 RGB 값으로 파란색을 설정함
var backColor = factory.rgb(0, 0, 255);
// 그리드 1번째 컬럼 배경색 지정
grdList.setcolumnitembackcolorex(1, backColor, true);
}