열에 관련지을 수 있고 있는 데이터 프로바이더 아이템내의 필드 또는 property의 이름입니다. 아이템 렌더러로 표시할 수 있는 텍스트를 계산하기 위해서, 각 DataGridColumn 컨트롤에서는, 이 property 및 labelFunction property, 또 그 어느쪽이든가 설정되어 있을 필요가 있습니다. dataField property 및 labelFunction property가 설정되어 있는 경우, 데이터는 labelFunction 를 사용해 표시되어dataField 를 사용해 소트 됩니다. dataField 로 지정된 property가 존재하지 않는 경우, 소트를 올바르게 실행하려면 sortCompareFunction 를 설정할 필요가 있습니다.

이 property의 이 값은, 반드시 열헤더에 표시되는 string이다고는 할 수 없습니다. 이 property는, 데이터 프로바이더의 데이터에 액세스 하는 목적에서만 사용합니다. 상세한 것에 대하여는,headerText property를 참조해 주세요.

See also

데이터 힌트로서 표시하는 데이터 프로바이더내의 필드의 이름입니다. 디폴트에서는, 각 데이터 프로바이더 아이템으로label 라는 이름의 property가 검색되어 그 값이 리스트에 표시됩니다. 다만, 데이터 프로바이더에 label property가 존재하지 않는 경우는,dataTipField property를 설정해 다른 property를 지정할 수 있습니다. 예를 들어, 데이타베이스에 포함되는 일련의 인물명이 유저에게 표시되는 경우에는, 값을 "FullName" 로 설정할 수 있습니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

dataTip 를 결정하기 위해서(때문에) 데이터 프로바이더의 각 아이템으로 실행하는 콜백 함수를 지정합니다. 이 property는 itemToDataTip Methods로 사용합니다.

디폴트에서는, 각 데이터 프로바이더 아이템으로label 라는 이름의 property가 검색되어 그 값이 dataTip 로서 표시됩니다. 다만, 데이터 세트에 따라서는,label property가 존재하지 않고, 또 행에 데이터를 표시하기 위해서 사용할 수 있는 다른 property도 존재하지 않는 것이 있습니다. 예를 들어, 풀네임을 dataTip 로서 표시할 필요가 있는데, 데이터 프로바이더에는 lastName 필드와 firstName 필드가 독립해 존재하고 있다고 하는 상태가 생각됩니다. 이러한 경우는, 양쪽 모두의 필드의 값을 단일의 string로서 돌려주는 함수를 dataTipFunction property로 지정합니다. 또, 포맷과 로컬라이즈를 처리하기 위해서 dataTipFunction property를 사용할 수도 있습니다.

이 함수는, 데이터 프로바이더 엘리먼트를 거둔 단일의 Object Parameters를 취해, string를 돌려주는 함수인 것이 필요합니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

열안의 아이템이 편집 가능한가 어떤가를 나타내는 플래그입니다. 이 값이 true 로, DataGrid 의 editable property도 true 이면, 렬내의 아이템은 편집 가능합니다. 아이템을 클릭하는지, Tab 키와 커서 키를 사용해 아이템으로 이동하는 것으로, 그 아이템을 개별적으로 편집할 수 있습니다.

디폴트치true.

리스트아이템의 새로운 데이터를 포함하는 아이템 에디터의 property의 이름입니다. 예를 들어, 디폴트의 itemEditor 는 TextInput 이기 (위해)때문에,editorDataField property의 디폴트치는 "text" 가 되어, TextInput 컨트롤의 text property가 지정됩니다.

디폴트치"text".

아이템 렌더러의 크기에 대한 아이템 에디터의 높이입니다 (픽셀 단위). 이 property를 사용하면, 에디터를 아이템 렌더러와 수픽셀분 오버랩 시켜, 에디터의 주위의 경계선을 보정할 수가 있습니다. 덧붙여 에디터의 표시중에 이러한 값을 변경해도, 그러한 변경은 현재의 에디터에 반영됩니다만, 다음의 아이템 렌더러로 에디터가 열렸을 때에 반영됩니다.

디폴트치0.

아이템 에디터로 Enter 키를 사용할지 어떨지를 나타내는 플래그입니다. true 의 경우는 아이템 에디터로 Enter 키를 사용할 수 있습니다. 이 경우, DataGrid 는 Enter 키를 검색하지 않고, 그 조작에 반응해 에디터를 이동합니다. 덧붙여 에디터의 표시중에 이 값을 변경해도, 그러한 변경은 현재의 에디터에 반영됩니다만, 다음의 아이템 렌더러로 에디터가 열렸을 때에 반영됩니다.

디폴트치false. .

아이템 렌더러의 크기에 대한 아이템 에디터의 폭입니다 (픽셀 단위). 이 property를 사용하면, 에디터를 아이템 렌더러와 수픽셀분 오버랩 시켜, 에디터의 주위의 경계선을 보정할 수가 있습니다. 덧붙여 에디터의 표시중에 이러한 값을 변경해도, 그러한 변경은 현재의 에디터에 반영됩니다만, 다음의 아이템 렌더러로 에디터가 열렸을 때에 반영됩니다.

디폴트치0.

아이템의 좌상구석의 위치에 대한 아이템 에디터의 좌상구석의 x 축상의 위치입니다 (픽셀 단위). 이 property를 사용하면, 에디터를 아이템 렌더러와 수픽셀분 오버랩 시켜, 에디터의 주위의 경계선을 보정할 수가 있습니다. 덧붙여 에디터의 표시중에 이러한 값을 변경해도, 그러한 변경은 현재의 에디터에 반영됩니다만, 다음의 아이템 렌더러로 에디터가 열렸을 때에 반영됩니다.

디폴트치0.

아이템의 좌상구석의 위치에 대한 아이템 에디터의 좌상구석의 y 축상의 위치입니다 (픽셀 단위). 이 property를 사용하면, 에디터를 아이템 렌더러와 수픽셀분 오버랩 시켜, 에디터의 주위의 경계선을 보정할 수가 있습니다. 덧붙여 에디터의 표시중에 이러한 값을 변경해도, 그러한 변경은 현재의 에디터에 반영됩니다만, 다음의 아이템 렌더러로 에디터가 열렸을 때에 반영됩니다.

디폴트치0.

열의 열헤더를 표시하는 아이템 렌더러 인스턴스에 대응하는 클래스 팩토리입니다. 이 property의 값으로서 드롭 인 아이템 렌더러, inline 아이템 렌더러, 또는 custom 아이템 렌더러의 각 컴퍼넌트를 지정할 수 있습니다.

디폴트의 아이템 렌더러는 DataGridItemRenderer 클래스입니다. 이것은 아이템 데이터를 텍스트로서 표시합니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

이 열의 헤더의 텍스트입니다. 디폴트에서는, DataGrid 컨트롤은 dataField property의 값을 헤더 텍스트로서 사용합니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

헤더내의 텍스트가 1 행에 들어가지 않는 경우에 되풀이할지 어떨지를 나타내는 플래그입니다. undefined 의 경우는, DataGrid 컨트롤의 wordWrap property가 사용됩니다.

디폴트치undefined.

IME (입력 Methods 에디터)의 모드를 지정합니다. IME 를 사용하는 것에 의해, 유저는 중국어, 일본어, 및 한국어의 텍스트를 입력할 수 있습니다. itemFocusIn 이벤트가 발생하면 IME 모드가 설정되어itemFocusOut 이벤트가 발생하면 설정전의 값에 돌아옵니다. flash.system.IMEConversionMode 클래스에서, 이 property의 유효한 값의 정수를 정의합니다.

디폴트치는 null 입니다. 이 경우, DataGrid 컨트롤의 imeMode property의 값이 사용됩니다.

See also

열이 편집 가능한 경우에 열의 편집에 사용하는 아이템 에디터의 인스턴스에 대응하는 클래스 팩토리입니다.

디폴트치new ClassFactory(mx.controls.TextInput).

열에 있는 각 아이템의 데이터를 표시하는 아이템 렌더러 인스턴스에 대응하는 클래스 팩토리입니다. 이 property의 값으로서 드롭 인 아이템 렌더러, inline 아이템 렌더러, 또는 custom 아이템 렌더러의 각 컴퍼넌트를 지정할 수 있습니다.

디폴트의 아이템 렌더러는 DataGridItemRenderer 클래스입니다. 이것은 아이템 데이터를 텍스트로서 표시합니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

이 열에 표시하는 텍스트를 결정하는 함수입니다. 디폴트에서는, 데이터에 있는 필드의 텍스트 가운데, 그 열의 이름과 일치하는 텍스트가 열에 표시됩니다. 그러나, 그 데이터내의 복수의 필드에 근거하는 텍스트나, 필요한 형식으로 되어 있지 않은 데이터를 표시하는 것이 필요하게 될 수도 있습니다. 그러한 경우는,labelFunction 를 사용해 콜백 함수를 지정해 주세요.

DataGrid 컨트롤의 경우, Methods 서명의 형식은 다음과 같이 됩니다.

labelFunction(item:Object, column:DataGridColumn) :String

여기서,item 에는 DataGrid 아이템 object를 지정해,column 는 DataGrid 열을 지정합니다.

콜백 함수를 사용하면, 데이터내의 firstName 와 lastName 의 필드의 결합, Date 에 대한 custom 형식의 적용, 숫자로 나타내진 달부터 string에의 변환등이 가능합니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

열의 최소폭입니다.

디폴트치20. .

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

아이템 렌더러가 아이템 에디터이기도 한 것을 나타내는 플래그입니다. 이 property를 true 로 설정하면 itemEditor property는 무시되어 그 아이템의 아이템 렌더러가 아이템 에디터로서 사용됩니다.

디폴트치false.

열의 폭을 유저가 변경할 수 있을지 어떨지를 나타내는 플래그입니다. true 의 경우, 유저는 열헤더의 사이의 grid lines을 드러그 해, 열의 크기를 변경할 수 있습니다.

디폴트치true.

열에 데이터 힌트를 표시할지 어떨지를 나타내는 플래그입니다. true 의 경우, 행의 텍스트에 대해서 데이터 힌트가 표시됩니다. 데이터 힌트는, 행에 표시 다 할 수 없는 긴 텍스트를 표시하기 위한 툴 힌트입니다.

디폴트치false.

이 열의 헤더의 클릭 조작으로 유저가 데이터 프로바이더를 소트 할 수 있을지 어떨지를 나타내는 플래그입니다. 이 property와 DataGrid 의 sortableColumns property의 양쪽 모두를 true 로 설정하면, 유저가 이 열의 헤더를 마우스로 클릭해 떼어 놓았을 때에, DataGrid 컨트롤로부터 headerRelease 이벤트가 dispatch됩니다. 이 headerRelease 이벤트에 대해서 다른 핸들러가 preventDefault() Methods를 호출하지 않으면, 열의 dataField property 또는 sortCompareFunction 를 사용해 dataProvider 중(안)에서 아이템이 늘어놓고 바꿀 수 있습니다.

디폴트치true.

열안의 데이터를 소트 할 경우에 불려 가는 콜백 함수입니다. 이 property를 지정하지 않는 경우, 기본적인 string 또는 수치의 소트를 사용해 데이터의 소트가 시행됩니다. 데이터가 string도 수치도 아닌 경우, 또는 dataField property가 데이터 프로바이더의 유효한 property가 아닌 경우는, 소트가 기능하지 않는지, 예외가 생성됩니다. labelFunction property의 값을 지정하는 경우는, 이 열에서의 소트가 불가가 되지 않은 한,sortCompareFunction property에 함수도 지정할 필요가 있습니다.

DataGrid 컨트롤은 이 함수를 사용해, 데이터 프로바이더의 콜렉션의 엘리먼트를 소트 합니다. 콜백 함수의 함수 서명은 2 개의 Parameters를 받아, 다음과 같은 형식에 따를 필요가 있습니다.

mySortCompareFunction(obj1:Object, obj2:Object) :int 

obj1 — 비교하는 데이터 엘리먼트입니다.

obj2 — obj1 의 비교 대상이 되는 데이터 엘리먼트입니다.

이 함수는 object의 비교에 근거해 다음과 같은 값을 돌려줍니다.

• 승순으로 obj1 가 obj2 보다 먼저 출현하는 경우는 -1.
• obj1 와 obj2 가 같은 경우는 0.
• 승순으로 obj1 가 obj2 보다 다음에 출현하는 경우는 1.

메모: obj1 Parameters와 obj2 Parameters는 데이터 프로바이더 엘리먼트 전체입니다. 단순한 아이템의 데이터가 아닙니다.

디폴트치null.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

열이 데이터 프로바이더의 sort field가 되어 있는 경우에 소트가 승순인가 어떤가를 나타내는 플래그입니다.

디폴트치true;.

열이 가시 상태인가 어떤가를 나타내는 플래그입니다. true 의 경우, 열은 가시입니다.

디폴트치true.

열의 폭을 나타내는 픽셀수. If horizontalScrollPolicy 가 false 의 경우, 표시되는 모든 열이 표시 가능 영역내에 들어갈 필요가 있습니다. 이 경우, 모든 렬폭을 합계한 폭이 너무 작거나 너무 크거나 했을 경우, DataGrid 에서는 개개의 열의 폭이 그대로 사용된다고는 할 수 없습니다.

디폴트치100.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

이 열의 행에 표시하는 텍스트가 1 행에 들어가지 않는 경우에 되풀이할지 어떨지를 나타내는 플래그입니다. undefined 의 경우는, DataGrid 컨트롤의 wordWrap property가 사용됩니다.

디폴트치undefined.

constructor　 　.

dataTipField property 및 dataTipFunction property에 근거해, 특정의 데이터 object의 데이터 힌트로서 아이템 렌더러가 표시하는 string를 돌려줍니다. 이 Methods가 Parameters를 string로 변환할 수 없는 경우는, 단일의 공백 캐릭터가 돌려주어집니다.

이 Methods는, DataGridColumn 클래스의 서브 클래스를 작성하기 위해서 개발자가 사용하는 것입니다. 어플리케이션 개발자에 의한 사용은 고려되고 있지 않습니다.

지정된 데이터 object에 대해서 아이템 렌더러가 표시하는 string를 돌려줍니다. DataGridColumn 또는 그 DataGrid 의 labelFunction property가 null 값가 아닌 경우, 그 데이터 object에 함수를 적용합니다. 그렇지 않은 경우, 이 Methods는 dataField property에 의해 지정되는 필드의 내용을 추출하는지, 데이터 object의 string치를 취득합니다. 이 Methods가 Parameters를 string로 변환할 수 없는 경우는, 단일의 공백 캐릭터가 돌려주어집니다.