mx.collections.SortField (Flex™ 2 레퍼런스 가이드)

Package	mx.collections
Class	public class SortField
Inheritance	SortField EventDispatcher Object

기존의 뷰내에서 필드 또는 property에 대해서 소트를 설정하기 위해서 필요한 소트 정보를 제공합니다. 통상, 소트는 복잡한 아이템, 즉 object의 property에 대해서 소트가 실행되는 아이템의 콜렉션에 대해서 설정합니다. 다음에 예를 나타냅니다.


     var col:ICollectionView = new ArrayCollection();
     col.addItem({first:"Anders", last:"Dickerson"});
     var sort:Sort = new Sort();
     sort.fields = [new SortField("first", true)];
     col.sort = sort;

콜렉션에 String,Date,Boolean 등이 단순한 아이템이 포함되어 있는 경우가 있습니다. 이 경우는, 이러한 단순형에 직접 소트를 적용합니다. 이 경우의 소트를 설정할 때는, 단일의 sort field만을 지정해,name 를 지정할 수 없습니다. 다음에 예를 나타냅니다.


     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     sort.fields = [new SortField(null, true)];
     col.sort = sort;

MXML 문장구조법 expanded

MXML 문장구조법의 비표시

<mx:SortField> 태그에는, 이하의 속성이 있습니다.

 <mx:SortField property caseInsensitive="false" compareFunction="내부 비교 함수" descending="false" name="null" numeric="false" />

	property	정의
		caseInsensitive : Boolean 이 필드의 소트에서는 대문자와 소문자를 구별하지 않는지 어떤지를 지정합니다.	SortField
		compareFunction : Function 관련지을 수 있었던 콜렉션의 아이템을 소트중에 2 개의 아이템을 비교하는 함수입니다.	SortField
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		descending : Boolean 이 필드를 내림차순으로 소트 할지 어떨지를 지정합니다.	SortField
		name : String 소트 하는 필드의 이름입니다.	SortField
		numeric : Boolean 소트 대상의 필드에 수치 (number/int/uint)인가, 또는 수치의 string 표현이 포함되어 있는 경우에, 콤퍼레이터에 수치 비교를 실행시키도록(듯이) 지정합니다.	SortField
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

Public Methods

상속된 Public Methods의 비표시

상속된 Public Methods 보기

	Methods		정의
		SortField (name:String = null, caseInsensitive:Boolean = false, descending:Boolean = false, numeric:Boolean = false) constructor　　.	SortField
		addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.	EventDispatcher
		dispatchEvent (event:Event ):Boolean 이벤트를 event 플로우(flow)에 dispatch합니다.	EventDispatcher
		hasEventListener (type:String ):Boolean EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.	EventDispatcher
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void EventDispatcher object로부터 listener를 삭제합니다.	EventDispatcher
		reverse ():void 이 sort field의 조건을 역순서로 합니다.	SortField
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object
		willTrigger (type:String ):Boolean 지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.	EventDispatcher

property의 상세

caseInsensitive

property

caseInsensitive:Boolean [read-write]

이 필드의 소트에서는 대문자와 소문자를 구별하지 않는지 어떤지를 지정합니다.

디폴트치false.

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

Implements
public function get caseInsensitive():Boolean
public function set caseInsensitive(value:Boolean ):void

compareFunction

property

compareFunction:Function [read-write]

관련지을 수 있었던 콜렉션의 아이템을 소트중에 2 개의 아이템을 비교하는 함수입니다. Sort object의 compareFunction property를 지정했을 경우는, Sort 의 SortField object의 compareFunction property는 모두 무시됩니다.

비교 함수에는 다음의 서명이 필요합니다.

function myCompare(a:Object, b:Object) :int

이 함수에서는, 다음의 값이 돌려주어질 필요가 있습니다.

a 가 b 의 전에 표시되는 소트순서의 경우는 -1
a = b 의 경우는 0
a 가 b 의 뒤에 표시되는 소트순서의 경우는 1

디폴트치는, string, 수치, 일자를 비교할 수 있는 내부 비교 함수입니다. 이 비교 함수에서는, 승순 또는 내림차순에서의 비교가 가능해, string의 비교에 관해서는 대문자와 소문자의 구별의 유무를 지정할 수 있습니다. custom 비교 알고리즘이 필요한 경우에게만, 독자적인 함수를 지정합니다. 이것은, 통상, 계산 필드가 표시로 사용되고 있는 경우에게만 해당합니다.

Implements
public function get compareFunction():Function
public function set compareFunction(value:Function ):void

descending

property

descending:Boolean [read-write]

이 필드를 내림차순으로 소트 할지 어떨지를 지정합니다.

디폴트치는 false (승순)입니다.

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

Implements
public function get descending():Boolean
public function set descending(value:Boolean ):void

name

property

name:String [read-write]

소트 하는 필드의 이름입니다.

디폴트치null.

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

Implements
public function get name():String
public function set name(value:String ):void

numeric

property

numeric:Boolean [read-write]

소트 대상의 필드에 수치 (number/int/uint)인가, 또는 수치의 string 표현이 포함되어 있는 경우에, 콤퍼레이터에 수치 비교를 실행시키도록(듯이) 지정합니다. 이 property가 false 의 경우는, 수치의 string 표현이 포함되는 필드는, string 비교에 의해 소트 됩니다. 예를 들어,"1" 은 "9" 보다 작은 string치이기 (위해)때문에, 100 은 99 보다 먼저 옵니다.

디폴트치false.

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

Implements
public function get numeric():Boolean
public function set numeric(value:Boolean ):void

constructor　　 의 상세

SortField

()

constructor　　

public 함수 SortField(name:String  = null, caseInsensitive:Boolean  = false, descending:Boolean  = false, numeric:Boolean  = false)

constructor　　.

Parameters

	`name:String` (default = `null`) — 이 필드가 비교에 사용하는 property의 이름입니다. object가 단순형의 경우,`null` 를 건네줍니다.

	`caseInsensitive:Boolean` (default = `false`) — string를 소트 하는 경우는, 값의 대문자 소문자를 무시할지 어떨지를 콤퍼레이터에 지시합니다.

	`descending:Boolean` (default = `false`) — 아이템을 내림차순에 배치할지 어떨지를 콤퍼레이터에 지시합니다.

	`numeric:Boolean` (default = `false`) — 소트 아이템을 알파벳순서는 아니고 숫자로서 비교할지 어떨지를 콤퍼레이터에 지시합니다.

Methods의 상세

reverse

()

Methods

public function reverse():void

이 sort field의 조건을 역순서로 합니다. 예를 들어, 필드가 내림차순으로 소트 되었을 경우는 승순으로 소트 됩니다.

메모 : ICollectionView 는, SortFields 가 변경되어도 자동적으로 갱신되지 않습니다. 뷰를 갱신하려면 ,refresh() Methods를 호출합니다.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class SortField	property \| Methods