RealGrid2 API
Interface
EditOptions

EditOptions

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

Signature:

export interface EditOptions 

Remarks

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

Example

grid.setEditOptions({editable: false});

Properties

PropertyTypeDescription
appendableboolean행 추가 가능 여부
appendWhenExitLastbooleanTab 또는 Enter 키로 마지막 셀을 벗어날 때 행 추가 여부
appendWhenInsertKeybooleanInsert 키로 마지막에 행을 추가할지의 여부
buttonClickWhenSpaceboolean(ALPHA)
cancelWhenLastUndoboolean편집 취소 가능 여부
checkableboolean행의 Checked 상태 변경 가능 여부
checkCellDiffboolean셀 편집 완료 시 실제 값이 변경 되었을 때 상태 변경 확인 여부
checkDiffboolean행 편집 완료 시 실제 셀이 변경 되었을 때 상태 변경 확인 여부
columnEditableFirstbooleancolumn.editable과 editOptions.editable의 적용순서 변경
commitByCellboolean셀 단위 수정 후 commit 여부
commitEditingMessagestring편집중인 행을 삭제시 표시되는 메시지
commitLevelValidationLevel행 편집을 완료할 수 있는 최상위 ValidationLvel
commitWhenExitLastbooleanTab 이나 Enter 키로 셀을 벗어날 때 행을 commit 할지의 여부
commitWhenLeavebooleanfocus가 그리드를 벗어날때 그리드를 commit 할지의 여부
commitWhenNoEditboolean셀이 편집되지 않아도 commit 할지의 여부
confirmWhenDeleteboolean삭제 여부를 묻는 대화 상자의 호출 여부
crossWhenExitLastbooleanTab이 이나 Enter 키로 마지막 셀을 벗어날 때 다음 행으로 이동할지의 여부
currentChangingFirstbooleancommitEdit와 GridBase.onCurrentChanging의 실행 순서
deletableboolean행 삭제 가능 여부
deletableWhenEditboolean셀 편집 시 편집 취소 후 선택된 행 삭제 가능 여부
deleteRowsMessagestring삭제 대화 상자에 표시할 메세지
displayEmptyEditRowboolean그리드의 행의 마지막에 항상 빈 행을 추가할지의 여부
editableboolean그리드의 데이터 수정 가능 여부
editWhenClickFocusedboolean선택된 셀을 클릭했을 시 편집기 표시 여부
editWhenFocusedboolean셀 focus 시 편집기 표시 여부
enterToEditbooleanfocus된 셀이 편집상태가 아닐때 Enter키 를 입력하면 편집상태로 변경한다.
enterToNextRowboolean셀 편집 중 Enter 키를 입력하면 편집을 완료하고 다음 행으로 이동할지의 여부
enterToTabboolean셀 편집 중 Enter 키를 입력하면 편집을 완료하고 다음 셀로 이동할지의 여부
erasableboolean선택 영역에 포함된 셀 삭제 가능 여부
exceptDataClickWhenButtonbooleancellButton 또는 renderer item을 클릭했을때 GridBase.onCellClicked 발생여부
exitGridWhenTabExitGridWhenTabtab 키를 눌렀을 때 그리드 벗어남 여부
firstCellWhenInsertboolean(ALPHA)
focusMoveStepFocusMoveStep왼쪽 또는 오른쪽 화살표를 입력했을때 focus가 셀또는 그룹단위로 이동하도록 한다.
forceAppendboolean변경된 내용이 없어도 Appending 상태에서 항상 commit 할 건지의 여부
forceInsertboolean변경된 내용이 없어도 Inserting 상태에서 항상 commit 할 건지의 여부
hintOnErrorboolean편집 중에 에러가 있는 셀에 마우스가 위치할 때 에러 힌트 툴팁 표시 여부
insertableboolean행 삽입 가능 여부
invalidFormatMessagestringmask 에서 지정한 형태가 아닐 때 표시할 오류 메시지
maxLengthToNextCellboolean지정한 자리수 만큼 입력되면 다음 셀로 이동할지의 여부
movableboolean행 이동 가능 여부
readOnlyboolean그리드 수준에서 데이터 셀의 값 수정 금지 여부
revertableboolean삭제 취소 가능 여부
scrollOnEditingScrollOnEditing편집 중 일때 스크롤 시 처리
showCommitErrorbooleancommit 오류 발생 시 보여줄 것인지에 대한 여부
showInvalidFormatMessagebooleanmask 에서 지정한 형태가 아닐 때 오류 메시지를 보여줄 것인지의 여부
showOnlyValidationMessageboolean설정한 Validation Error의 메시지만 보여줄지 의 여부
skipReadOnlyboolean컬럼간 이동시 readOnly 셀을 건너뛰고 이동할지에 대한 여부.
skipReadOnlyCellboolean한 컬럼에서 행 간 이동시 readOnly 셀을 건너뛰고 이동할지에 대한 여부.
strictDiffbooleanstrict 하게 판단하여 셀 편집시 실제 값이 변경 되었는지 확인 여부 (자료형도 같아야함)
updatableboolean그리드의 데이터 수정 가능 여부
useArrowKeysboolean방향키로 셀 이동 가능 여부
useTabKeybooleanTab 키로 셀 이동 가능 여부
validateOnEditedboolean셀 편집이 완료될 때 컬럼 Validation 실행 여부
validateOnExitboolean셀에서 벗어날 때 컬럼 Validation 실행 여부
verticalMoveStepVerticalMoveStep컬럼 그룹의 컬럼 셀을 위나 아래로 이동시 동작 방법

Properties Desc

appendable

행 추가 가능 여부

Remarks:

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


appendWhenExitLast

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

Remarks:

commitWhenExitLast 가 true 여야 한다.


appendWhenInsertKey

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


buttonClickWhenSpace


cancelWhenLastUndo

편집 취소 가능 여부


checkable

행의 Checked 상태 변경 가능 여부

Remarks:

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


checkCellDiff

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

Remarks:

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


checkDiff

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

Remarks:

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


columnEditableFirst

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

Remarks:

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


commitByCell

셀 단위 수정 후 commit 여부


commitEditingMessage

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

Remarks:

EditOptions.deletableWhenEditfalse인 경우 표시된다.


commitLevel

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


commitWhenExitLast

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


commitWhenLeave

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


commitWhenNoEdit

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


confirmWhenDelete

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

Remarks:

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


crossWhenExitLast

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


currentChangingFirst

commitEdit와 GridBase.onCurrentChanging의 실행 순서

Remarks:

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


deletable

행 삭제 가능 여부

Remarks:

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


deletableWhenEdit

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


deleteRowsMessage

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


displayEmptyEditRow

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

Remarks:

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


editable

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

Remarks:

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


editWhenClickFocused

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


editWhenFocused

셀 focus 시 편집기 표시 여부


enterToEdit

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

Remarks:

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


enterToNextRow

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


enterToTab

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

Remarks:

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


erasable

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


exceptDataClickWhenButton

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

Remarks:

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


exitGridWhenTab

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


firstCellWhenInsert


focusMoveStep

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

Remarks:

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


forceAppend

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


forceInsert

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


hintOnError

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


insertable

행 삽입 가능 여부

Remarks:

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


invalidFormatMessage

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


maxLengthToNextCell

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

Remarks:

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


movable

행 이동 가능 여부

Remarks:

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


readOnly

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

Remarks:

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


revertable

삭제 취소 가능 여부

Remarks:

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


scrollOnEditing

편집 중 일때 스크롤 시 처리


showCommitError

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


showInvalidFormatMessage

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


showOnlyValidationMessage

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

Remarks:

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


skipReadOnly

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


skipReadOnlyCell

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


strictDiff

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

Remarks:

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


updatable

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

Remarks:

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


useArrowKeys

방향키로 셀 이동 가능 여부


useTabKey

Tab 키로 셀 이동 가능 여부


validateOnEdited

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


validateOnExit

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


verticalMoveStep

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

Remarks:

'row' 또는 'cell'이다.