RealGrid2 API
Interface
DataField

DataField

데이터 필드 모델 객체

Signature:

export interface DataField 

Remarks

DataProvider 의 필드관련 method 에서 사용된다.

Example

// model
let fields = ds.getFields();
ds.setFields(fields);

Events

PropertyTypeDescription
valueCallbackFieldValueCallbackcalculated 필드일 경우 수식을 지정하여 계산 될 콜백

Properties

PropertyTypeDescription
amTextstring오전 표시 텍스트
baseFieldstring기준 필드
baseYearnumber년도 값이 100보다 작을 경우 기준 년도
booleanFormatstringBoolean 형식의 값일 때 서식
calculatedbooleancalculated 필드인지 여부
dataTypeValueType자료형
datetimeFormatstring날짜 형식의 값일 때 서식
defaultValueany필드의 기본 데이터 값
fieldNamestring필드명
headerstring그룹 헤더 타이틀
indexnumber필드의 인덱스
lengthnumber데이터 길이
maximumnumber최대 범위의 한계값
minimumnumber최소 범위의 한계값
nullValueany데이터가 null 일 때 대체될 데이터
orgFieldNamestring지정 당시의 필드명
pmTextstring오후 표시 텍스트
requiredboolean(ALPHA) 데이터 필수 여부
setany[]필드셋
subTypeValueType기본 자료형을 제한된 범위로 사용하기 위한 지시자
subTypeEnabledboolean자료형을 제한 된 범위로 사용하기 위한 지시자 사용 가능 여부
updatableboolean필드값 수정 가능 여부
valueExpressionstringcalculated 필드일 경우 사용될 수식

Events Desc

valueCallback

calculated 필드일 경우 수식을 지정하여 계산 될 콜백

Type - FieldValueCallback

Remarks:

수식에서 다른 calculated 필드의 참조는 허용하지 않는다.

Example:

dataField.valueCallback = function (provider, dataRow, fieldName, fieldNames, values) {
    let quantity = values[fieldNames.indexOf("Quantity")];
    let unitprice = values[fieldNames.indexOf("UnitPrice")];
    if (isNaN(quantity) || isNaN(unitprice))
        return undefined;
    else
        return quantity >= 1000 ? Math.round(quantity * unitprice * 0.95) : quantity * unitprice;
}

Properties Desc

amText

오전 표시 텍스트

Type - string


baseField

기준 필드

Type - string

Remarks:

읽어올 때는 대문자로 출력된다.

속성으로 접근하여 설정하면 대문자로 저장된다.

검증 시 사용된다.


baseYear

년도 값이 100보다 작을 경우 기준 년도

Type - number


booleanFormat

Boolean 형식의 값일 때 서식

Type - string

Remarks:

이 값이 지정되면 boolean 필드의 값을 출력할 때 변환 형식으로 사용된다.

DataOutputOptions.booleanFormat 에 설정된 값을 우선한다.

콜론(:) 또는 세미콜론(;)으로 구분하여 왼쪽은 false일 때, 오른쪽은 true일 때

예) 'Nub: Yub'


calculated

calculated 필드인지 여부

Type - boolean

Remarks:

valueExpression 이나 valueCallback 이 설정되어 있으면 calculated 이다.


dataType

자료형

Type - ValueType

Remarks:

ValueType 참고


datetimeFormat

날짜 형식의 값일 때 서식

Type - string

Remarks:

이 값이 지정되면 datetime 필드의 값을 출력할 때 변환 형식으로 사용된다.

DataOutputOptions.datetimeFormat 에 설정된 값을 우선한다.

예) 'yyyy-M-dd'


defaultValue

필드의 기본 데이터 값

Type - any

Remarks:

기본값을 지정하면 GridView.beginInsertRow(), GridView.beginAppendRow() 함수 호출시 지정된 기본값이 입력된 상태로 새로운 행이 추가된다.


fieldName

필드명

Type - string

Remarks:

읽어올 때에는 대문자로 출력된다.

속성으로 접근 하여 설정하면, orgFieldName 이 그대로 설정되고 해당 속성은 내부적으로 처리하기 위해 대문자로 바뀌어 설정된다.


header

그룹 헤더 타이틀

Type - string

Remarks:

Row Grouping 시 그룹 헤더의 타이틀에 기준필드의 헤더 값을 표시할 수 있다.


index

필드의 인덱스

Type - number


length

데이터 길이

Type - number


maximum

최대 범위의 한계값

Type - number

Remarks:

숫자 또는 날짜형 자료형일 때 사용 가능하다.


minimum

최소 범위의 한계값

Type - number

Remarks:

숫자 또는 날짜형 자료형일 때 사용 가능하다.


nullValue

데이터가 null 일 때 대체될 데이터

Type - any


orgFieldName

지정 당시의 필드명

Type - string


pmText

오후 표시 텍스트

Type - string


required

데이터 필수 여부

Type - boolean


set

필드셋

Type - any[]

Remarks:

배열에 포함된 값이 아니면 undefined로 저장되게 한다.

Boolean 자료형을 제외한 나머지 자료형에서 사용가능하다.


subType

기본 자료형을 제한된 범위로 사용하기 위한 지시자

Type - ValueType

Remarks:

ValueType 참고


subTypeEnabled

자료형을 제한 된 범위로 사용하기 위한 지시자 사용 가능 여부

Type - boolean


updatable

필드값 수정 가능 여부

Type - boolean


valueExpression

calculated 필드일 경우 사용될 수식

Type - string

Remarks:

values['필드명'], values[필드인덱스]로 참조한다.

수식에서 다른 calculated 필드의 참조는 허용하지 않는다.

Example:

dataField.valueExpression = "values['Quantity'] * values['UnitPrice']";