new DynamicComboBoxEditor()
DataGrid에서 가변적인 콤보박스를 통해 편집을 할 수 있도록 하는 Editor 클래스입니다.
콤보박스로 편집하고자 하는 DataGridColumn의 itemEditor 속성을 "DynamicComboBoxEditor"로 설정하여 사용합니다.
콤보박스에 표시되는 내역은 DataGridColumn의 itemRendererDataProvider나 itemRendererDataProviderField를 통해 설정하며,
데이터가 코드로 저장되고 콤보박스에는 코드명으로 표시해야 하는 경우에는 itemRendererDataField에 코드명, itemRendererLabelField에 라벨명을 지정해 줍니다.
사용자가 편집한 결과는 selectedDataField를 통해 가져오므로 DataGridColumn의 editorDataField를 "selectedDataField"로 설정해 줘야 합니다.
ComboBoxEditor가 dataProvider에 설정된 내역을 모두 표시하는 것과 달리, DynamicComboBoxEditor는 dataProvider에 설정된 데이터중 "visible" 속성이 false로 된 데이터는
콤보박스에 표시하지 않기 때문에, 콤보박스가 표시될 때 데이터의 "visible" 속성을 조정하여 선택가능한 내역을 조건에 따라 바꿀 수 있는 기능을 제공할 수 있게 됩니다.
Members
-
dataProviderobject
-
콤보박스에 표시할 데이터.
데이터에서 "visible" 속성이 없거나 true인 객체만 콤보박스에 표시됩니다.- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getDataProvider(), setDataProvider(value)
-
labelFieldstring
-
설정된 dataProvider에서 라벨속성의 필드명.
- Default Value:
- "label"
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getLabelField(), setLabelField(value)
-
readonlyselectedDataFieldobject
-
사용자가 선택한 내역의 data field의 값.
- See:
-
- 자바스크립트에서 사용할 때는 getter함수를 사용합니다. - getSelectedDataField()
-
selectedIndexnumber
-
콤보박스에서 선택된 내역의 인덱스 번호.
기본값은 -1이지만 dataProvider가 설정될 경우에는 0으로 설정됩니다.- Default Value:
- -1
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedIndex(), setSelectedIndex(value)
-
selectedItemobject
-
dataProvider에 설정된 데이터에서 선택된 객체.
- Default Value:
- null
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedItem(), setSelectedItem(value)
-
visibleboolean
-
가시성 여부.
- Default Value:
- true
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getVisible(), setVisible(value)
Methods
-
blur()
-
포커스를 없앱니다.
-
focus()
-
포커스를 줍니다.
-
itemToLabel(item){string}
-
전달된 item에서 labelField속성에 따라 라벨을 추출하여 반환합니다.
Name Type Description itemobject 데이터 객체
Returns:
Type Description string 추출된 라벨 문자열
Events
-
change
-
사용자가 콤보박스에서 선택하였을 때 발생합니다.
Type:
- Event
Properties:
Name Type Description htmlEventEvent 발생한 html 이벤트