Class: DataGridSelectorColumn

<rMateGrid>
     <NumberFormatter id="numfmt" useThousandsSeparator="true"/>
     <DataGrid id="dg1" horizontalScrollPolicy="auto" verticalAlign="middle" selectionMode="multipleRows" textAlign="center">
         <columns>
             <DataGridSelectorColumn id="selector" textAlign="center" backgroundColor="#EDEDF0"/>
             <DataGridColumn dataField="From" width="80"/>
             <DataGridColumn dataField="Subject" width="150"/>
             <DataGridColumn dataField="ReceiveDate" headerText="Receive"/>
             <DataGridColumn dataField="SendDate" headerText="Send"/>
             <DataGridColumn dataField="CC"/>
             <DataGridColumn dataField="Level" textAlign="right"/>
             <DataGridColumn dataField="Length" textAlign="right" formatter="{numfmt}"/>
             <DataGridColumn dataField="AttachCount" textAlign="right" formatter="{numfmt}"/>
         </columns>
     </DataGrid>
 </rMateGrid>

Members

allItemSelectedboolean

전체 선택 여부.

Default Value:

• false

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getAllItemSelected(), setAllItemSelected(value)

allowAllSelectionboolean

헤더의 CheckBox를 통해 전체를 선택 또는 해제할 수 있는 기능을 제공할 지 여부.

true일 경우 헤더에 CheckBox가 나타납니다

Default Value:

• true

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getAllowAllSelection(), setAllowAllSelection(value)

allowChildrenSelectionboolean

데이타가 계층형일 경우 선택 변경시 하위 자식노드도 변경되는 기능의 사용 여부.

allowMultipleSelection가 true일 경우에만 작동합니다.

Since:

• 4.0

Default Value:

• false

allowMultipleSelectionboolean

사용자가 여러개의 행을 선택할수 있는지 여부.

true일 경우 CheckBox로 선택을 하게되고, false일 경우 RadioButton으로 선택을 하게 됩니다.

Default Value:

• true

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getAllowMultipleSelection(), setAllowAllSelection(value)

disabledItemCanSelectedboolean

secondLabelJsFunction에 의해 disabled된 체크박스 또는 라디오 버튼에 대해 selected를 변경할 수 있는지 여부

false일 경우에는 disabled되면 해당 체크박스 또는 라디오 버튼의 selected는 무조건 false 처리되며, true일 경우에는 selected를 변경할 수 있게 됩니다.

하지만 disabled된 체크박스도 체크할 수 있게 되면, 헤더의 체크박스에 의한 변경시 모든 체크박스가 변경되는 문제가 발생하게 되어
이 속성을 true로 설정할 경우에는 헤더의 체크박스는 disabled 됩니다.

Since:

• 5.0

Default Value:

• false

headerTextstring

컬럼의 헤더 텍스트.

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getHeaderText(), setHeaderText(value)

headerWordWrapboolean

헤더에서 텍스트의 길이가 길어 한 줄에 표시하지 못할 경우 다음 줄에 출력시킬지 여부.

Default Value:

• false

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getHeaderWordWrap(), setHeaderWordWrap(value)

minWidthnumber

컬럼의 최소 넓이.

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getMinWidth(), setMinWidth(value)

resizableboolean

컬럼의 넓이 변경 가능 여부.

DataGrid의 resizableColumns 속성이 true일 때만 적용됩니다.

Default Value:

• true

secondLabelJsFunctionfunction

행의 선택 가능여부를 계산할 콜백함수를 지정합니다.

함수의 반환값이 true이면 선택가능 하고 false이면 enabled가 false처리되어 선택할 수 없게 됩니다.

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSecondLabelFunction(), setSecondLabelFunction(value)

Example

secondLabelJsFunction 함수의 파라메터는 다음과 같습니다.

function secondLabelJsFunction(item, value, column)
  - item : 해당 행의 data 객체
  - value : 해당 셀의 라벨
  - column : 해당 셀의 컬럼을 정의한 Column 객체

selectedIndexnumber

선택된 행의 데이터내의 index 값.

아무런 선택이 없을 경우 -1이 지정됩니다.

Default Value:

• -1

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedIndex(), setSelectedIndex(value)

selectedIndicesArray

선택된 행들의 데이터내의 index 배열.

아무런 선택이 없을 경우 []이 지정됩니다.

Default Value:

• []

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedIndices(), setSelectedIndices(value)

selectedItemobject

선택된 행의 데이터.

그리드 데이터의 형식이 배열일 때 선택된 데이터를 다른 그리드의 데이터로 활용할 경우에는, 내부 관리변수(rm_internal_uid)때문에 오류가 발생할 수 있으므로 GridRoot.clone() 함수를 사용하여 복사하여 사용하시기 바랍니다.

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedItem(), setSelectedItem(value)

selectedItemsArray

선택된 행들의 데이터의 배열.

그리드 데이터의 형식이 배열일 때 선택된 데이터를 다른 그리드의 데이터로 활용할 경우에는, 내부 관리변수(rm_internal_uid)때문에 오류가 발생할 수 있으므로 GridRoot.clone() 함수를 사용하여 복사하여 사용하시기 바랍니다.

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedItems(), setSelectedItems(value)

showDataTipsboolean

컬럼에서 데이터팁을 표시할지 여부.

Default Value:

• false

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getShowDataTips(), setShowDataTips(value)

syncWithRowClickboolean

DataGrid의 selectionMode가 selectorColumn일 때 그리드의 행 선택시 체크표시 될지 여부.

Since:

• 4.0

Default Value:

• false

visibleboolean

컬럼의 가시성 여부.

Default Value:

• true

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getVisible(), setVisible(value)

widthnumber

컬럼의 넓이.

pixel단위로 적용됩니다.

Default Value:

• 40

See:

• 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getWidth(), setWidth(value)

Methods

clearSelection()

행 선택 내용을 초기화합니다.

clearStyle(styleProp)

컴포넌트에 등록되어 있는 스타일을 지웁니다.

Name	Type	Description
styleProp	string	스타일 속성명

getSizeStyle(styleProp){Number}

컴포넌트에 등록되어 있는 스타일을 숫자로 변환하여 반환합니다.

paddingLeft, paddingRight등과 같이 "px"등의 단위가 붙는 경우, "px"를 제거하고 숫자로 변환되는 스타일을 가져올 경우에 사용합니다.

Name	Type	Description
styleProp	string	스타일 속성명

Returns:

Type	Description
Number	스타일에 등록되어 있는 값, 없을시 null

getStyle(styleProp)

컴포넌트에 등록되어 있는 스타일을 반환합니다.

스타일에 등록되어 있는 값, 없을시 null값을 리턴합니다.

Name	Type	Description
styleProp	string	스타일 속성명

isItemSelected(data){boolean}

전달된 행 데이터의 선택여부를 반환합니다.

Name	Type	Description
data	object	조회하고자 하는 행의 데이타.

Returns:

Type	Description
boolean	선택된 행이면 true를 반환.

setPxStyle(styleProp, newValue)

컴포넌트에 스타일을 숫자+"px" 형식으로 등록합니다.

paddingLeft, paddingRight등과 같이 "px"를 붙여 값을 설정해야 하는 경우 사용합니다.

Name	Type	Description
styleProp	string	스타일 속성명
newValue	Number	스타일에 등록할 값

setStyle(styleProp, newValue)

컴포넌트에 스타일을 등록합니다.

Name	Type	Description
styleProp	string	스타일 속성명
newValue	*	스타일에 등록할 값

Styles

backgroundColorcolor

배경색을 나타냅니다.

colorcolor

텍스트의 색깔을 나타냅니다.

cursorstring

열의 셀위에 표시되는 마우스 커서를 지정합니다.

(유효값 : CSS에서 지원하는 cursor)

Default Value:

• "default"

disabledColorcolor

잠긴상태의 텍스트 컬러를 나타냅니다.

fontFamilystring

사용할 폰트를 지정합니다.

fontSizestring

폰트 크기를 픽셀단위로 지정합니다.

fontStylestring

폰트 스타일을 나타냅니다. (유효값 : “normal”,”italic”)

fontWeightstring

폰트의 두께 속성을 나타냅니다 (유효값 : “normal”,”bold”)

headerStyleNamestring

컬럼 헤더의 스타일 이름을 나타냅니다.

letterSpacingstring

각각의 글자(character) 사이의 추가적인 공간을 지정합니다.

paddingLeftstring

왼쪽 여백을 나타냅니다.

Default Value:

• 1px

paddingRightstring

오른쪽 여백을 나타냅니다.

Default Value:

• 1px

textAlignstring

텍스트 정렬 방식을 나타냅니다. (유효값 : “left”,”right”,”center”)

Default Value:

• "left"

textDecorationstring

텍스트에 밑줄을 그을지 나타냅니다. (유효값 : “none”,”underline”)

textIndentnumber

텍스트의 시작 들여쓰기를 픽셀단위로 지정합니다.

Default Value:

• 0

Events

change

사용자가 마우스나 키보드를 조작하여 선택사항을 바꿨을 때 발생합니다.

Type:

• Event

Properties:

Name	Type	Description
columnIndex	number	변경된 컬럼 index번호
rowIndex	number	변경된 행의 index번호