EditOptions

그리드에서의 데이터 편집에 대한 설정 모델

Signature:

export interface EditOptions 

Remarks

그리드 에서 옵션으로 설정할 때는 필요한 정보만 넣으면 된다.

Example

grid.setEditOptions({editable: false});

Properties

Properties Desc

appendable

행 추가 가능 여부

Type - boolean

Remarks:

그리드 마지막행에서 방향키로 추가 가능

appendWhenExitLast

Tab 또는 Enter 키로 마지막 셀을 벗어날 때 행 추가 여부

Type - boolean

Remarks:

commitWhenExitLast 가 true 여야 한다.

appendWhenInsertKey

Insert 키로 마지막에 행을 추가할지의 여부

Type - boolean

buttonClickWhenSpace

Type - boolean

cancelWhenLastUndo

편집 취소 가능 여부

Type - boolean

checkable

행의 Checked 상태 변경 가능 여부

Type - boolean

Remarks:

true 시 CheckBar Cell 을 클릭하여 변경 가능

checkCellDiff

셀 편집 완료 시 실제 값이 변경 되었을 때 상태 변경 확인 여부

Type - boolean

Remarks:

true면 셀 편집 완료 요청 시 실제 변경 값이 하나라도 있어야 완료된다. 그렇지 않으면 무시된다. false 면 실제 값이 변경되었는 지와 상관없이 사용자 편집 행위가 있었다면 그 행은 변경된 상태가 된다.

checkDiff

행 편집 완료 시 실제 셀이 변경 되었을 때 상태 변경 확인 여부

Type - boolean

Remarks:

true 시 행 편집 완료 요청 시 실제 변경된 셀이 하나라도 있어야 완료된다. 그렇지 않으면 무시된다. false 시 실제 값이 변경되었는 지와 상관없이 사용자 편집 행위가 있었다면 그 행은 변경된 상태가 된다.

columnEditableFirst

column.editable과 editOptions.editable의 적용순서 변경

Type - boolean

Remarks:

true이면 column.editable이 설정된경우 editOptions.editable은 무시된다.

commitByCell

셀 단위 수정 후 commit 여부

Type - boolean

commitEditingMessage

편집중인 행을 삭제시 표시되는 메시지

Type - string

Remarks:

EditOptions.deletableWhenEdit가 false인 경우 표시된다.

commitLevel

행 편집을 완료할 수 있는 최상위 ValidationLvel

Type - ValidationLevel

commitWhenExitLast

Tab 이나 Enter 키로 셀을 벗어날 때 행을 commit 할지의 여부

Type - boolean

commitWhenLeave

focus가 그리드를 벗어날때 그리드를 commit 할지의 여부

Type - boolean

commitWhenNoEdit

셀이 편집되지 않아도 commit 할지의 여부

Type - boolean

confirmWhenDelete

삭제 여부를 묻는 대화 상자의 호출 여부

Type - boolean

Remarks:

true시 사용자 삭제나 deleteSelection() 실행할 때 삭제 여부를 묻는 대화 상자를 먼저 호출한다. GridView.deleteSelection(true)로 호출하면 대화 상자 표시 없이 바로 삭제한다.

crossWhenExitLast

Tab이 이나 Enter 키로 마지막 셀을 벗어날 때 다음 행으로 이동할지의 여부

Type - boolean

currentChangingFirst

commitEdit와 GridBase.onCurrentChanging의 실행 순서

Type - boolean

Remarks:

true이면 그리드의 commitEdit보다 onCurrentChanging 이벤트가 먼저 실행된다.

deletable

행 삭제 가능 여부

Type - boolean

Remarks:

true 시 사용자가 Ctrl+Del 키를 누르거나 deleteSelection() 을 호출해서 현재 선택된 행을 삭제할 수 있다. deleteSelection(true) 와 같이 호출하면 해당 옵션과 상관없이 삭제할 수 있다.

deletableWhenEdit

셀 편집 시 편집 취소 후 선택된 행 삭제 가능 여부

Type - boolean

deleteRowsMessage

삭제 대화 상자에 표시할 메세지

Type - string

displayEmptyEditRow

그리드의 행의 마지막에 항상 빈 행을 추가할지의 여부

Type - boolean

Remarks:

해당 빈 행에 데이터가 입력되고 행 commit()이 발생하면 다시 빈 행이 추가된다.

editable

그리드의 데이터 수정 가능 여부

Type - boolean

Remarks:

각 컬럼에서 지정한 readOnly 값 또한 false 여야 수정 가능하다.

editWhenClickFocused

선택된 셀을 클릭했을 시 편집기 표시 여부

Type - boolean

editWhenFocused

셀 focus 시 편집기 표시 여부

Type - boolean

enterToEdit

focus된 셀이 편집상태가 아닐때 Enter키 를 입력하면 편집상태로 변경한다.

Type - boolean

Remarks:

enterToNextRow가 true 인경우에는 편집상태로 변경하지 않고 다음 row로 이동한다.

enterToNextCell

Enter키를 입력하면 다음 셀로 이동한다.

Type - boolean

enterToNextRow

셀 편집 중 Enter 키를 입력하면 편집을 완료하고 다음 행으로 이동할지의 여부

Type - boolean

enterToTab

셀 편집 중 Enter 키를 입력하면 편집을 완료하고 다음 셀로 이동할지의 여부

Type - boolean

Remarks:

enterToNextRow == true 시 다음 행으로 이동

erasable

선택 영역에 포함된 셀 삭제 가능 여부

Type - boolean

exceptDataClickWhenButton

cellButton 또는 renderer item을 클릭했을때 GridBase.onCellClicked 발생여부

Type - boolean

Remarks:

true이면 onCellClicked이벤트가 발생하지 않는다.

exitGridWhenTab

tab 키를 눌렀을 때 그리드 벗어남 여부

Type - ExitGridWhenTab

extendedFocus

data 영역 외(Header, Footer 등) 셀로 focus 이동을 허용할지 여부

Type - boolean

Remarks:

true로 설정하면 키보드 또는 마우스를 통해 Header, Footer 등 data 영역 외의 셀로도 focus 이동이 가능하다.

firstCellWhenInsert

Type - boolean

focusMoveStep

왼쪽 또는 오른쪽 화살표를 입력했을때 focus가 셀또는 그룹단위로 이동하도록 한다.

Type - FocusMoveStep

Remarks:

group이면 최상위 그룹단위로 focus가 이동한다.

forceAppend

변경된 내용이 없어도 Appending 상태에서 항상 commit 할 건지의 여부

Type - boolean

forceInsert

변경된 내용이 없어도 Inserting 상태에서 항상 commit 할 건지의 여부

Type - boolean

hintOnError

편집 중에 에러가 있는 셀에 마우스가 위치할 때 에러 힌트 툴팁 표시 여부

Type - boolean

insertable

행 삽입 가능 여부

Type - boolean

Remarks:

true 시 Insert 키를 눌러 행 삽입 가능

invalidFormatMessage

mask 에서 지정한 형태가 아닐 때 표시할 오류 메시지

Type - string

maxLengthToNextCell

지정한 자리수 만큼 입력되면 다음 셀로 이동할지의 여부

Type - boolean

Remarks:

column.editor.maxLength에 지정한 자리수 만큼 입력되면 다음 셀로 이동된다. editFormat이 있는 경우 보여지는 글자를 기준으로 maxLength가 체크된다. (numberEditor, dateEditor) multiLine의 경우 \n과 같이 제어문자도 글자수에 포함된다. editOptions.skipReadOnly가 true 인 경우 readOnly인 셀은 건너뛴다.

movable

행 이동 가능 여부

Type - boolean

Remarks:

sorting된 상태인경우 이동할수 없다. 트리의 경우 동일 노드내에서만 이동가능

movableWhenFocusedOnly

포커스를 가진 셀 에서만 행 이동 여부

Type - boolean

Remarks:

movable 이 true 여야 한다.

readOnly

그리드 수준에서 데이터 셀의 값 수정 금지 여부

Type - boolean

Remarks:

각 컬럼에서 지정한 readOnly 값 또한 false 여야 수정 가능하다.

revertable

삭제 취소 가능 여부

Type - boolean

Remarks:

dataProvider.softDeleting == true 인 경우, 삭제 상태인 행들을 ctrl+shift+del 키 입력시 원래 상태로 되돌릴 수 있다.

scrollOnEditing

편집 중 일때 스크롤 시 처리

Type - ScrollOnEditing

showCommitError

commit 오류 발생 시 보여줄 것인지에 대한 여부

Type - boolean

showErrorIcon

오류 아이콘 표시 여부

Type - boolean

showInvalidFormatMessage

mask 에서 지정한 형태가 아닐 때 오류 메시지를 보여줄 것인지의 여부

Type - boolean

showOnlyValidationMessage

설정한 Validation Error의 메시지만 보여줄지 의 여부

Type - boolean

Remarks:

true인경우 Validation의 message만 보여주며 false 인경우 level과 message를 동시에 보여준다. 셀별로 message를 변경하려면 GridBase.onValidationFail을 참조

skipReadOnly

컬럼간 이동시 readOnly 셀을 건너뛰고 이동할지에 대한 여부.

Type - boolean

skipReadOnlyCell

한 컬럼에서 행 간 이동시 readOnly 셀을 건너뛰고 이동할지에 대한 여부.

Type - boolean

strictDiff

strict 하게 판단하여 셀 편집시 실제 값이 변경 되었는지 확인 여부 (자료형도 같아야함)

Type - boolean

Remarks:

true 면 셀 편집 완료 요청 시 실제 변경 값이 하나라도 있어야 완료된다. 그렇지 않으면 무시된다. false 면 실제 값이 변경되었는 지와 상관없이 사용자 편집 행위가 있었다면 그 행은 변경된 상태가 된다.

updatable

그리드의 데이터 수정 가능 여부

Type - boolean

Remarks:

true 면 그리드의 데이터들을 수정 할 수 있다. false 면 기존 데이터는 수정할 수 없고 commit() 되기 전 새로 추가된 행만 수정 가능하다.

useArrowKeys

방향키로 셀 이동 가능 여부

Type - boolean

useTabKey

Tab 키로 셀 이동 가능 여부

Type - boolean

validateOnEdited

셀 편집이 완료될 때 컬럼 Validation 실행 여부

Type - boolean

validateOnExit

Warning: This API is now obsolete.

셀에서 벗어날 때 컬럼 Validation 실행 여부

Type - boolean

verticalMoveStep

컬럼 그룹의 컬럼 셀을 위나 아래로 이동시 동작 방법

Type - VerticalMoveStep

Remarks:

'row' 또는 'cell'이다.