GridColumn

패키지	spark.components.gridClasses
클래스	public class GridColumn
상속	GridColumn EventDispatcher Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The GridColumn class defines a column of a Spark grid control, such as the Spark DataGrid or Grid control. Each data provider item for the control corresponds to one row of the grid. The GridColumn class specifies the field of the data provider item whose value is to be displayed in the column. It also specifies the item renderer used to display that value, the item editor used to change the value, and other properties of the column.

MXML 구문

MXML 구문 숨기기

The <s:GridColumn> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GridColumn
    Properties
    dataField="null"
    dataTipField="null"
    dataTipFormatter="null"
    dataTipFunction="null"
    editable="true"
    formatter="null"
    headerRenderer="null"
    headerText="value of dataField"
    imeMode="null"
    itemEditor="null"
    itemRenderer="null"
    itemRendererFunction="null"
    labelFunction="null"
    maxWidth="NaN"
    minWidth="20"
    rendererIsEditable="false"
    resizeable="true"
    showDataTips="undefined"
    sortable="true"
    sortCompareFunction="null"
    sortDescending="false"
    visible="true"
    width="NaN"
  />

예제 보기

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		columnIndex : int [읽기 전용] The position of this column in the grid's column list, or -1 if this column's grid is null.	GridColumn
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		dataField : String The name of the field or property in the data provider item associated with the column.	GridColumn
		dataTipField : String The name of the field in the data provider to display as the datatip.	GridColumn
		dataTipFormatter : IFormatter Specifies the formatter used by the column's itemToDataTip() method to convert data provider items to Strings.	GridColumn
		dataTipFunction : Function Specifies a callback function to run on each item of the data provider to determine its data tip.	GridColumn
		editable : Boolean Indicates whether the items in the column are editable.	GridColumn
		formatter : IFormatter Specifies the formatter used by the column's itemToLabel() method to convert data provider items to strings.	GridColumn
		grid : Grid [읽기 전용] The Grid object associated with this column.	GridColumn
		headerRenderer : IFactory The class factory for the IGridItemRenderer class used as the header for this column.	GridColumn
		headerText : String Text for the header of this column.	GridColumn
		imeMode : String Specifies the IME (Input Method Editor) mode.	GridColumn
		itemEditor : IFactory A class factory for IGridItemEditor class used to edit individual grid cells in this column.	GridColumn
		itemRenderer : IFactory The class factory for the IGridItemRenderer class used to render individual grid cells.	GridColumn
		itemRendererFunction : Function If specified, the value of this property must be an idempotent function that returns an item renderer IFactory based on its data provider item and column parameters.	GridColumn
		labelFunction : Function An idempotent function that converts a data provider item into a column-specific string that's used to initialize the item renderer's label property.	GridColumn
		maxWidth : Number The maximum width of this column in pixels.	GridColumn
		minWidth : Number The minimum width of this column in pixels.	GridColumn
		rendererIsEditable : Boolean Determines whether any of the item renderer's controls are editable.	GridColumn
		resizable : Boolean Indicates whether the user is allowed to resize the width of the column.	GridColumn
		showDataTips : * Indicates whether the datatips are shown in the column.	GridColumn
		sortable : Boolean If true, and if the grid's data provider is an ICollectionView, and if the associated grid's sortableColumns property is true, then this column supports interactive sorting.	GridColumn
		sortCompareFunction : Function The function that compares two elements during a sort of on the data elements of this column.	GridColumn
		sortDescending : Boolean If true, this column is sorted in descending order.	GridColumn
		sortField : SortField [읽기 전용] Returns a SortField that can be used to sort a collection by this column's dataField.	GridColumn
		visible : Boolean If true, then display this column.	GridColumn
		width : Number The width of this column in pixels.	GridColumn

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		GridColumn(columnName:String = null) Constructor.	GridColumn
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		itemToDataTip(item:Object):String Convert the specified data provider item to a column-specific datatip String.	GridColumn
		itemToLabel(item:Object):String Convert the specified data provider item to a column-specific String.	GridColumn
		itemToRenderer(item:Object):IFactory Convert the specified data provider item to a column-specific item renderer factory.	GridColumn
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	이벤트		요약	정의 주체
		activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
		deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher

공용 상수

	상수		정의 주체
		ERROR_TEXT : String = "unknown" [정적] The return value for the itemToLabel() or itemToDataTip() method if resolving the corresponding property name (path) fails.	GridColumn

속성 세부 정보

columnIndex

속성

columnIndex:int [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The position of this column in the grid's column list, or -1 if this column's grid is null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 columnIndexChanged 이벤트를 전달합니다.

구현
public function get columnIndex():int

dataField

속성

dataField:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The name of the field or property in the data provider item associated with the column. Each GridColumn requires this property or the labelFunction property to be set to calculate the displayable text for the item renderer. If the dataField and labelFunction properties are set, the data is displayed using the labelFunction and sorted using the dataField.

This value of this property is not necessarily the String that is displayed in the column header. This property is used only to access the data in the data provider. For more information, see the headerText property.

If the column or its grid specifies a labelFunction, then the dataField is not used.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 dataFieldChanged 이벤트를 전달합니다.

구현
public function get dataField():String
public function set dataField(value:String):void

관련 API 요소

itemToLabel
labelFunction

dataTipField

속성

dataTipField:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The name of the field in the data provider to display as the datatip. By default, if showDataTips is true, the associated grid control looks for a property named label on each data provider item and displays it. However, if the data provider does not contain a label property, you can set the dataTipField property to specify a different property name. For example, you could set the value to "FullName" when a user views a set of people's names included from a database.

GridColumn.dataTipField takes precedence over this property.

If this column or its grid specifies a value for the dataTipFunction property, then the dataTipField property is ignored.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 dataTipFieldChanged 이벤트를 전달합니다.

구현
public function get dataTipField():String
public function set dataTipField(value:String):void

관련 API 요소

dataTipFunction
itemToDataTip

dataTipFormatter

속성

dataTipFormatter:IFormatter

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Specifies the formatter used by the column's itemToDataTip() method to convert data provider items to Strings.

If the formatter's styleParent was not specified, it's set to the column's grid, so that the formatter inherits the grid's locale style.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 dataTipFormatterChanged 이벤트를 전달합니다.

구현
public function get dataTipFormatter():IFormatter
public function set dataTipFormatter(value:IFormatter):void

관련 API 요소

itemToDataTip
formatter

dataTipFunction

속성

dataTipFunction:Function

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Specifies a callback function to run on each item of the data provider to determine its data tip. This property is used by the itemToDataTip method.

By default, if showDataTips is true, the column looks for a property named label on each data provider item and displays it as its data tip. However, some data providers do not have a label property nor do they have another property that you can use for displaying data in the rows.

For example, you have a data provider that contains a lastName and firstName fields, but you want to display full names as the data tip. You can specify a function to the dataTipFunction property that returns a single String containing the value of both fields. You can also use the dataTipFunction property for handling formatting and localization.

The signature of the dataTipFunction function must match the following:

dataTipFunction(item:Object, column:GridColumn):String

The item parameter is the data provider item for an entire row. The second parameter is this column object.

A typical function might concatenate an item's firstName and lastName properties, or do some custom formatting on a Date value property.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 dataTipFunctionChanged 이벤트를 전달합니다.

구현
public function get dataTipFunction():Function
public function set dataTipFunction(value:Function):void

관련 API 요소

itemToDataTip
dataTipField

editable

속성

editable:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Indicates whether the items in the column are editable. If true, and the associated grid's editable property is also true, the items in a column are editable and can be individually edited by clicking on a selected item, or by navigating to the item and pressing the F2 key.

기본값: true.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 editableChanged 이벤트를 전달합니다.

구현
public function get editable():Boolean
public function set editable(value:Boolean):void

formatter

속성

formatter:IFormatter

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Specifies the formatter used by the column's itemToLabel() method to convert data provider items to strings.

If the formatter's styleParent was not specified, it's set to the column's grid, so that the formatter inherits the grid's locale style.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 formatterChanged 이벤트를 전달합니다.

구현
public function get formatter():IFormatter
public function set formatter(value:IFormatter):void

관련 API 요소

itemToLabel
dataTipFormatter

grid

속성

grid:Grid [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The Grid object associated with this column.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 gridChanged 이벤트를 전달합니다.

구현
public function get grid():Grid

headerRenderer

속성

headerRenderer:IFactory

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The class factory for the IGridItemRenderer class used as the header for this column. If unspecified, the DataGrid controls's columnHeaderGroup skin part defines the default header renderer.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 headerRendererChanged 이벤트를 전달합니다.

구현
public function get headerRenderer():IFactory
public function set headerRenderer(value:IFactory):void

관련 API 요소

headerText
IGridItemRenderer

headerText

속성

headerText:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Text for the header of this column. By default, the associated grid control uses the value of the dataField property as the header text.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 headerTextChanged 이벤트를 전달합니다.

구현
public function get headerText():String
public function set headerText(value:String):void

imeMode

속성

imeMode:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Specifies the IME (Input Method Editor) mode. The IME enables users to enter text in Chinese, Japanese, and Korean. Flex sets the specified IME mode when the control gets the focus, and sets it back to the previous value when the control loses the focus.

The flash.system.IMEConversionMode class defines constants for the valid values for this property. You can also specify null to specify no IME.

기본값: null.

구현
public function get imeMode():String
public function set imeMode(value:String):void

관련 API 요소

flash.system.IMEConversionMode

itemEditor

속성

itemEditor:IFactory

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

A class factory for IGridItemEditor class used to edit individual grid cells in this column. If this property is null, and the column grid's owner is a DataGrid control, then the value of the DataGrid control's itemEditor property is used. If no item editor is specified by the DataGrid control, then use the DefaultGridItemEditor class.

The default item editor is the DefaultGridItemEditor class, which lets you edit a simple text field. You can create custom item renderers by creating a subclass of the GridItemEditor class. Your custom item editor can write data to the entire row of the grid to define more complex editor.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 itemEditorChanged 이벤트를 전달합니다.

구현
public function get itemEditor():IFactory
public function set itemEditor(value:IFactory):void

itemRenderer

속성

itemRenderer:IFactory

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The class factory for the IGridItemRenderer class used to render individual grid cells. If not specified, use the value of the itemRenderer property from the associated grid control.

The default item renderer is the DefaultGridItemRenderer class, which displays the data item as text. You can create custom item renderers by creating a subclass of the GridItemRenderer class. Your custom item renderer can access the data from the entire row of the grid to define more complex visual representation of the cell.

The default value is the value of the itemRenderer property from the associated grid control, or null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 itemRendererChanged 이벤트를 전달합니다.

구현
public function get itemRenderer():IFactory
public function set itemRenderer(value:IFactory):void

itemRendererFunction

속성

itemRendererFunction:Function

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

If specified, the value of this property must be an idempotent function that returns an item renderer IFactory based on its data provider item and column parameters. Specifying a value to the itemRendererFunction property makes it possible to use more than one item renderer in this column.

The function specified to the itemRendererFunction property must have the following signature:

itemRendererFunction(item:Object, column:GridColumn):IFactory

The item parameter is the data provider item for an entire row. The second parameter is this column object.

Shown below is an example of an item renderer function:

      function myItemRendererFunction(item:Object, column:GridColumn):IFactory
      {
          return (item is Array) ? myArrayItemRenderer : myItemRenderer;
      }

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 itemRendererFunctionChanged 이벤트를 전달합니다.

구현
public function get itemRendererFunction():Function
public function set itemRendererFunction(value:Function):void

labelFunction

속성

labelFunction:Function

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

An idempotent function that converts a data provider item into a column-specific string that's used to initialize the item renderer's label property.

You can use a label function to combine the values of several data provider items into a single string. If specified, this property is used by the itemToLabel() method, which computes the value of each item renderer's label property in this column.

The function specified to the labelFunction property must have the following signature:

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

The item parameter is the data provider item for an entire row. The second parameter is this column object.

A typical label function could concatenate the firstName and lastName properties of the data provider item , or do some custom formatting on a Date value property.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 labelFunctionChanged 이벤트를 전달합니다.

구현
public function get labelFunction():Function
public function set labelFunction(value:Function):void

관련 API 요소

itemToLabel
dataField

maxWidth

속성

maxWidth:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The maximum width of this column in pixels. If specified, the grid's layout makes the column's layout width the smaller of the width of the typicalItem and the maxWidth. If this column is resizable, this property limits how wide the user can make this column. Setting this property does not change the width or minWidth properties.

기본값: NaN.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 maxWidthChanged 이벤트를 전달합니다.

구현
public function get maxWidth():Number
public function set maxWidth(value:Number):void

minWidth

속성

minWidth:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The minimum width of this column in pixels. If specified, the grid's layout makes the column's layout width the larger of the width of the typicalItem and the minWidth. If this column is resizable, this property limits how small the user can make this column. Setting this property does not change the width or maxWidth properties.

기본값: 20.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 minWidthChanged 이벤트를 전달합니다.

구현
public function get minWidth():Number
public function set minWidth(value:Number):void

rendererIsEditable

속성

rendererIsEditable:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Determines whether any of the item renderer's controls are editable. If the column is editable, the focusable controls in the item renderer are given keyboard focus when the user starts editing the item renderer.

When you set this property to true, the cell becomes editable when the user clicks inside of it. Because the cell is editable, the DataGrid displays the editorIndicator skin part, which appears on top of the selectionIndicator skin part. Therefore, the user does not see an indicator for cell selection until the edit session is complete. You can create a custom skin to remove or modify the editorIndicator skin part so that the selectionIndicator skin part appears. For example, you can set alpha property of the editorIndicator to allow the selectionIndicator to show through, or change the size of the editorIndicator so that it is smaller than the cell.

By setting this property to true, you take responsibility for validating and saving input collected by the item renderer. If the item renderer contains an override of the IGridItemRenderer.prepare() method, then you must ensure that unsaved input field changes are not overwritten. For example, rendererIsEditable is true and the renderer contains a single TextInput element that displays the value of data.myDataField. If the renderer's prepare() method sets the TextInput control's text property, then the prepare() method must not set the text property when there are pending changes.

기본값: false.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 rendererIsEditableChanged 이벤트를 전달합니다.

구현
public function get rendererIsEditable():Boolean
public function set rendererIsEditable(value:Boolean):void

resizable

속성

resizable:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Indicates whether the user is allowed to resize the width of the column. If true, and the resizableColumns property of the associated grid is also true, the user can drag the grid lines between the column headers to resize the column.

기본값: true.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 resizableChanged 이벤트를 전달합니다.

구현
public function get resizable():Boolean
public function set resizable(value:Boolean):void

showDataTips

속성

showDataTips:*

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Indicates whether the datatips are shown in the column. If true, datatips are displayed for text in the rows. Datatips are tooltips designed to show the text that is too long for the row.

If this property's value is undefined, the default, then the associated grid's showDataTips property determines if datatips are shown. If this property is set, the grid's showDataTips property is ignored.

기본값: undefined.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 showDataTipsChanged 이벤트를 전달합니다.

구현
public function get showDataTips():*
public function set showDataTips(value:any):void

관련 API 요소

getShowDataTips

sortable

속성

sortable:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

If true, and if the grid's data provider is an ICollectionView, and if the associated grid's sortableColumns property is true, then this column supports interactive sorting. Typically the column's header handles mouse clicks by setting the data provider's sort property to a Sort object whose SortField is this column's dataField.

If the data provider is not an ICollectionView, then this property has no effect.

기본값: true.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 sortableChanged 이벤트를 전달합니다.

구현
public function get sortable():Boolean
public function set sortable(value:Boolean):void

sortCompareFunction

속성

sortCompareFunction:Function

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The function that compares two elements during a sort of on the data elements of this column. If you specify a value of the labelFunction property, you typically also provide a sortCompareFunction.

The sortCompareFunction's signature must match the following:

sortCompareFunction(obj1:Object, obj2:Object, column:GridColumn):int

The function should return a value based on the comparison of the objects:

-1 if obj1 should appear before obj2 in ascending order.
0 if obj1 = obj2.
1 if obj1 should appear after obj2 in ascending order.

The function may use the column parameter to write generic compare functions.

Note: The obj1 and obj2 parameters are entire data provider elements and not just the data for the item.

If the dataProvider is not an ICollectionView, then this property has no effect.

기본값: null.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 sortCompareFunctionChanged 이벤트를 전달합니다.

구현
public function get sortCompareFunction():Function
public function set sortCompareFunction(value:Function):void

sortDescending

속성

sortDescending:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

If true, this column is sorted in descending order. For example, if the column's dataField contains a numeric value, then the first row would be the one with the largest value for this column.

Setting this property does not start a sort; it only sets the sort direction. When the dataProvider.refresh() method is called, the sort is performed.

If the data provider is not an ICollectionView, then this property has no effect.

기본값: false.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 sortDescendingChanged 이벤트를 전달합니다.

구현
public function get sortDescending():Boolean
public function set sortDescending(value:Boolean):void

sortField

속성

sortField:SortField [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Returns a SortField that can be used to sort a collection by this column's dataField.

If the sortCompareFunction property is defined, then the SortField's compareFunction is automatically set.

If the sortCompareFunction property is not defined and the dataField is complex, then the SortField's compare function is assigned to a closure around a default compare function that handles the complex dataField.

If the sortCompareFunction and dataField properties are not defined, but the labelFunction property is defined, then it assigns the compareFunction to a closure that does a basic string compare on the labelFunction applied to the data objects.

구현
public function get sortField():SortField

관련 API 요소

spark.collections.SortField

visible

속성

visible:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

If true, then display this column. If false, no space will be allocated for this column; it will not be included in the layout.

기본값: true.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 visibleChanged 이벤트를 전달합니다.

구현
public function get visible():Boolean
public function set visible(value:Boolean):void

width

속성

width:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The width of this column in pixels. If specified, the grid's layout ignores its typicalItem property and this column's minWidth and maxWidth properties.

기본값: NaN.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 widthChanged 이벤트를 전달합니다.

구현
public function get width():Number
public function set width(value:Number):void

생성자 세부 정보

()

생성자

public function GridColumn(columnName:String = null)

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Constructor.

매개 변수

columnName:String (default = null) — Initial value for the dataField and headerText properties.

메서드 세부 정보

itemToDataTip

()

메서드

public function itemToDataTip(item:Object):String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Convert the specified data provider item to a column-specific datatip String.

This method uses the values dataTipField and dataTipFunction. If those properties are null, it uses the corresponding properties from the associated grid control. If dataTipField properties is also null in the grid control, then use the dataField property.

If dataTipFunction and dataTipFormatter are null, then this method's value is the same as: item[dataTipField].toString(). If dataTipFormatter is specified then this method's value is the same as: dataTipFormatter.format(item[dataTipField]) If resolving the item's dataField causes an error to be thrown, ERROR_TEXT is returned.

If item and dataTipFunction are not null, then this method returns dataTipFunction(item, this), where the second argument is this GridColumn.

매개 변수

item:Object — The value of grid.dataProvider.getItemAt(rowIndex).

반환값

String — A column-specific string for the specified data provider item or ERROR_TEXT.

itemToLabel

()

메서드

public function itemToLabel(item:Object):String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Convert the specified data provider item to a column-specific String. This method is used to initialize item renderers' label property.

If labelFunction is null, and dataField is a string that does not contain "." field name separator characters, and formatter is null, then this method is equivalent to:

item[dataField].toString()

If the formatter was specified, then this method's value is:

formatter.format(item[dataField])

If dataField is a "." separated path, then this method looks up each successive path element. For example if ="foo.bar.baz", then this method returns a string based on the value of item.foo.bar.baz. If resolving the item's dataField causes an error to be thrown, ERROR_TEXT is returned.

If item and labelFunction are not null, then this method returns labelFunction(item, this), where the second argument is this GridColumn.

매개 변수

item:Object — The value of grid.dataProvider.getItemAt(rowIndex).

반환값

String — A column-specific string for the specified dataProvider item or ERROR_TEXT.

itemToRenderer

()

메서드

public function itemToRenderer(item:Object):IFactory

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

Convert the specified data provider item to a column-specific item renderer factory. By default this method calls the itemRendererFunction if it's non-null, otherwise it just returns the value of the column's itemRenderer property.

매개 변수

item:Object — The value of grid.dataProvider.getItemAt(rowIndex).

반환값

IFactory — A column-specific item renderer factory for the specified dataProvider item.

상수 세부 정보

ERROR_TEXT

상수

public static const ERROR_TEXT:String = "unknown"

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.5

The return value for the itemToLabel() or itemToDataTip() method if resolving the corresponding property name (path) fails. The value of this constant is a single space String: " ".

관련 API 요소

itemToLabel
itemToDataTip

예제 예제 사용 방법

GridColumnExample.mxml

<?xml version="1.0" encoding="utf-8"?>

<!--

A simple example of a DataGrid with explicitly specified columns.

The DataGrid's columns are specified by an ArrayList (an IList) and can always be accessed as such.  
For example dataGrid.columns.length returns the total number of columns and 
dataGrid.columns.getItemAt(index) returns the GridColumn at the specified index.  The columns list 
is mutable, which means that GridColumns can be added or removed at any time.

Column widths do not depend on the column's headerText, they're based on the rendered widths of 
the DataGrid's typicalItem. If that's not specified, then the first data item is used.  That's the 
case here.  Each column can specify an explicit width and by default all GridColumns are 
resizable="true", which means that the column can be interactively resized by dragging the edges 
between columns.  Interactively resizing column widths changes the DataGrid's measuredWidth which 
can be a little disconcerting if the DataGrid's width is not constrained.  In this example we've 
constrained the DataGrid's left and right edges which prevents changes in the DataGrid's 
measuredWidth from affecting its actual width.

-->

<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:s="library://ns.adobe.com/flex/spark">
    
    <s:Panel title="Spark DataGrid Control Example which demonstrates a simple DataGrid with explicitly specified columns"
             width="75%" height="75%" 
             horizontalCenter="0" verticalCenter="0">
        
        <s:DataGrid id="dataGrid" left="5" right="5" top="5" bottom="5">
            <s:columns>
                <s:ArrayList>
                    <s:GridColumn dataField="key" headerText="Key"/>
                    <s:GridColumn dataField="name" headerText="Name"/>
                    <s:GridColumn dataField="price" headerText="Price"/>
                    <s:GridColumn dataField="call" headerText="Call"/>
                </s:ArrayList>
            </s:columns>
            
            <s:ArrayCollection>
                <s:DataItem key="1000" name="Abrasive" price="100.11" call="false"/>
                <s:DataItem key="1001" name="Brush" price="110.01" call="true"/>
                <s:DataItem key="1002" name="Clamp" price="120.02" call="false"/>
                <s:DataItem key="1003" name="Drill" price="130.03" call="true"/>
                <s:DataItem key="1004" name="Epoxy" price="140.04" call="false"/>
                <s:DataItem key="1005" name="File" price="150.05" call="true"/>
                <s:DataItem key="1006" name="Gouge" price="160.06" call="false"/>
                <s:DataItem key="1007" name="Hook" price="170.07" call="true"/>
                <s:DataItem key="1008" name="Ink" price="180.08" call="false"/>
                <s:DataItem key="1009" name="Jack" price="190.09" call="true"/>             
            </s:ArrayCollection>
        </s:DataGrid>    
    </s:Panel>
</s:Application>

GridColumnVisibilityExample.mxml

<?xml version="1.0" encoding="utf-8"?>

<!--

Demonstrate the GridColumn visible property and the support for dynamically adding and removing columns.

After selecting a column it's visibility can be changed, a copy of the column can be inserted, and the column can be removed.

The DataGrid columns property is a mutable list - an IList, like ArrayList - and columns can be added or removed at any time.  The difference 
between an IList and an intrinsic collection type like Array or Vector is that ILists dispatch events when they're changed.   That's why the
DropDownList, whose dataProvider is the list of columns, tracks the changes made with the Add/Remove buttons.

Changing a column's visibility does not change its presence or position in the columns IList but it prevents the DataGrid from displaying it.

-->

<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:s="library://ns.adobe.com/flex/spark">
    
    <fx:Script>
        <![CDATA[
            // Insert a column to the left of specified column
            private function addNewColumn(column:GridColumn):void
            {
                const newColumn:GridColumn = new GridColumn();
                newColumn.dataField = column.dataField;
                newColumn.headerText = column.headerText + "+";
                dataGrid.columns.addItemAt(newColumn, column.columnIndex);
            }
            
            // Remove the specified column
            private function removeColumn(column:GridColumn):void
            {
                dataGrid.columns.removeItemAt(column.columnIndex);
            }
        ]]>
    </fx:Script>
    
    <s:Panel title="Spark DataGrid Control Example which demonstrates the GridColumn visible property and dynamically adding and removing columns"
             width="75%" height="75%" 
             horizontalCenter="0" verticalCenter="0">
        
        <s:controlBarContent>
            <s:HGroup verticalAlign="baseline">
                <s:DropDownList id="ddl" prompt="Select" dataProvider="{dataGrid.columns}" labelField="headerText"/>
                <s:Label text="Visible:"/>
                <s:CheckBox selected="@{ddl.selectedItem.visible}" enabled="{ddl.selectedItem}"/>
                <s:Button label="Add" click="addNewColumn(ddl.selectedItem)" enabled="{ddl.selectedItem}"/>
                <s:Button label="Remove" click="removeColumn(ddl.selectedItem)" enabled="{ddl.selectedItem}"/>
            </s:HGroup>
        </s:controlBarContent>
        
        <s:DataGrid id="dataGrid" left="5" right="5" top="5" bottom="5">
            <s:columns>
                <s:ArrayList>
                    <s:GridColumn dataField="key" headerText="Key"/>
                    <s:GridColumn dataField="name" headerText="Name"/>
                    <s:GridColumn dataField="price" headerText="Price"/>
                    <s:GridColumn dataField="call" headerText="Call"/>
                </s:ArrayList>
            </s:columns>
            
            <s:ArrayCollection>
                <s:DataItem key="1000" name="Abrasive" price="100.11" call="false"/>
                <s:DataItem key="1001" name="Brush" price="110.01" call="true"/>
                <s:DataItem key="1002" name="Clamp" price="120.02" call="false"/>
                <s:DataItem key="1003" name="Drill" price="130.03" call="true"/>
                <s:DataItem key="1004" name="Epoxy" price="140.04" call="false"/>
                <s:DataItem key="1005" name="File" price="150.05" call="true"/>
                <s:DataItem key="1006" name="Gouge" price="160.06" call="false"/>
                <s:DataItem key="1007" name="Hook" price="170.07" call="true"/>
                <s:DataItem key="1008" name="Ink" price="180.08" call="false"/>
                <s:DataItem key="1009" name="Jack" price="190.09" call="true"/>             
            </s:ArrayCollection>
        </s:DataGrid>    
    </s:Panel>    
</s:Application>

법적 고지 사항 | 온라인 개인 정보 보호 정책

GridColumn - AS3 Flex

패키지x

언어 요소

부록

패키지 spark.components.gridClasses

columnIndex

dataField

dataTipField

dataTipFormatter

dataTipFunction

editable

formatter

grid

headerRenderer

headerText

imeMode

itemEditor

itemRenderer

itemRendererFunction

labelFunction

maxWidth

minWidth

rendererIsEditable

resizable

showDataTips

sortable

sortCompareFunction

sortDescending

sortField

visible

width

GridColumn

itemToDataTip

itemToLabel

itemToRenderer

ERROR_TEXT