그리드 » Api
setstatuserrowtext
Description
그리드 통계 정보중 사용자 정의로 설정된 특정 아이템의 데이터를 설정하는 API이며, 데이터를 설정할 수 있는 통계 정보는 아래의 기준을 따른다.
- 그리드 통계행의 operation 속성이 6(사용자 정의)인 경우
- 그리드 통계행의 operation 속성이 5(칼럼별 정의)이고, 컬럼의 statisticsrow_type 속성이 5(사용자 정의)인 경우
통계행의 로우 인덱스는 통계행의 순서대로 Zero-Base로 지정된다.
그리드 통계행은 그리드의 속성중에 statistics_row 속성을 통해서 정의하며, 통계 방식은 statistics_row 속성창에서 operation 속성에 의해서 결정된다.
operation 속성이 6(사용자 정의)인 경우, 통계행은 틀만 표시되고, 자동으로 통계가 계산되지 않으며, setstatuserrowtext 함수를 통해서 직접 값을 지정해야 한다.
operation 속성이 5(칼럼별 정의)인 경우, 통계행의 칼럼의 데이터부 속성에 statisticsrow_type 속성이 5(사용자 정의)인 경우에는, 통계가 자동으로 계산되지 않으며, setstatuserrowtext 함수를 통해서 직접 값을 지정해야 한다.
Parameters
Parameters |
Type |
Description |
nRow |
short |
통계행 로우 인덱스 (Zero-Base) |
nCol |
short |
통계행 컬럼 인덱스 (Zero-Base) |
strStatText |
STRING |
특정 통계행에 셋팅할 데이터 |
Return Value
Type |
Description |
BOOL |
정상 적용 여부(true, false) (Remark 참조) |
Remark
사용자 정의 통계 정보는 clearallstatuserrow, clearstatuserrow 함수를 통해서 통계 정보를 삭제할 수 있다.
* Return 값
아래의 경우에 false가 리턴된다.
- 통계 정보 설정하고자하는 아이템의 통계행의 통계 방식이 사용자 정의가 아닌 경우
- 통계 정보를 설정하고자하는 아이템의 통계행의 통계 방식이 칼럼별 정의이고, 컬럼의 통계 타입이 사용자 정의인 컬럼이 아닌 경우
nRow/nCol 파라미터에 통계행에 없는 로우/컬럼 인덱스 입력시 false 반환
Example
// 그리드의 이름 : grdNoraml
// 테스트 버튼 이름 : btnSetStatUserRowText
function btnSetStatUserRowText_on_mouseup()
{
// 통계행의 0번째 로우, 1번째 칼럼에 값을 설정
// 아래의 경우에만 정상적으로 함수가 수행된다.
// - 0번재 로우가 사용자 정의 통계행인 경우
// - 0번재 로우가 컬럼별 지정 통계행이고,
// 1번째 칼럼의 통계 타입이 사용자 정의인 경우
var bRet = grdNoraml.setstatuserrowtext(0, 0, "홀수행 합계");
if(bRet == false) {
screen.alert("setstatuserrowtext Fail.");
}
}
See Also
clearallstatuserrow
clearstatuserrow
Viewer Ver.
9.1.1.1
Update Date
20220504