insertcolumn

그리드에 컬럼을 특정 위치에 추가하는 API이다.

그리드 칼럼을 추가한 이후에, 추가된 칼럼에 대해서 setcolumn~으로 시작되는 함수를 이용하여 칼럼의 속성을 지정할 수 있다.

칼럼의 맨 마지막에 칼럼을 추가하기 위해서는 addcolumn 함수를 사용한다.

Parameters	Type	Description
nColumn	short	추가될 위치의 컬럼 인덱스 (Zero-Base)
bRefresh	BOOL	[옵션] 그리드 리프레쉬 여부(true/false), 기본값 true

Type	Description
BOOL	칼럼 추가 정상 처리 여부

// 그리드의 이름이 grdNormal이고 
// 화면의 테스트 버튼(이름: btnTestInsertColumn)을 클릭하면
// 그리드에 칼럼을 특정 위치 추가하고, 칼럼 정보를 설정한다.

// 칼럼 Insert 테스트 버튼 클릭 이벤트 처리
function btnTestInsertColumn_on_mouseup(objInst)
{
    var nColumnWidth = 100;
    var strHeaderText = "추가된 칼럼";
    var bEditable = true;
    var nDataType = 2; // 한글
    var nColumnIndex = 2;

    // 두번째 칼럼 위치에 새로운 칼럼을 추가하고, 추가된 칼럼 속성을 설정
    nColumnIndex = insertColumn(grdNormal, nColumnIndex, strHeaderText, nColumnWidth, bEditable, nDataType);
    if(nColumnIndex == false) {
        screen.alert("칼럼 추가 실패");
    }
	
    return;
}

/**
 * 칼럼을 특정 위치에 추가하고 추가된 칼럼에 대한 속성을 지정한다.
 * @param objGrid 그리드 오브젝트
 * @param strHeaderText 추가된 칼럼의 헤더 문자열
 * @param nColumnWidth 추가된 칼럼의 넓이 (단위: pixel)
 * @param bEditable 추가된 칼럼의 편집 가능 여부
 * @param nDataType 데이터 타입 (0 : 숫자, 1 : 영문, 2 : 한글)
 * @return 
 *    true : 정상
 *    false : 오류
 */
function insertColumn(objGrid, nColumnIndex, strHeaderText, nColumnWidth, bEditable, nDataType)
{
    // Validate Column Index
    var nColumnCount = objGrid.getcolumncount();
    if(nColumnIndex > nColumnCount) {
        return false;
    }

    var bRet = objGrid.insertcolumn(nColumnIndex);
    if(bRet == false) {
        return false;
    }

    // 칼럼 너비 설정
    objGrid.setcolumnwidth(nColumnIndex, nColumnWidth);

    // 칼럼 편집 여부 속성 설정
    objGrid.setcolumneditable(nColumnIndex, bEditable);

    // 칼럼 헤더 텍스트 설정
    objGrid.setheadertext(0, nColumnIndex, strHeaderText);
		
    // 칼럼의 데이터 타입 변경
    objGrid.setcolumndatatype(nColumnIndex, nDataType);

    return true;
}

그리드 » Api

insertcolumn

Description

Parameters

Return Value

Remark

Example

See Also

Viewer Ver.

Update Date