This page was saved using jaction on 2006-09-04 8:33:31.
Address: http://flexdocs.kr/docs/flex2/langref/mx/binding/utils/ChangeWatcher.html
Title: mx.binding.utils.ChangeWatcher (Flex™ 2 레퍼런스 가이드)  •  Size: 38889
Packagemx.binding.utils
Classpublic class ChangeWatcher
InheritanceChangeWatcher Inheritance Object

ChangeWatcher 클래스는, 바인드 가능한 Flex property와 함께 사용할 수 있는 유틸리티 Methods를 정의합니다. 이러한 Methods를 사용하면, 바인드 가능 property가 갱신될 때마다 실행되는 event 핸들러를 정의할 수 있습니다.



Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
Public Methods
 Methods정의
  ChangeWatcher (access:Object , handler:Function , commitOnly:Boolean = false, next:ChangeWatcher = null)
constructor   .
ChangeWatcher
  canWatch (host:Object , name:String , commitOnly:Boolean = false):Boolean
[static] 그 property에 대한 데이터 바인딩 이벤트를 호스트가 공개하고 있을지 어떨지를 판별할 수 있습니다.
ChangeWatcher
  getEvents (host:Object , name:String , commitOnly:Boolean = false):Object
[static] 호스트 object의 모든 바인드 가능 property에 대한 모든 바인딩 이벤트를 돌려줍니다.
ChangeWatcher
  getValue ():Object
감시되는 property 또는 property 체인의 현재의 값을 취득합니다. 호스트 object가 null 의 경우는 null 가 취득됩니다.
ChangeWatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  isWatching ():Boolean
체인내의 각 Watcher 에 적어도 1 개의 change 이벤트를 관련지을 수 있고 있는 경우는,true 를 돌려줍니다.
ChangeWatcher
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
  reset (newHost:Object ):void
이 ChangeWatcher 인스턴스를 리셋트 해, 새로운 호스트 object를 사용합니다.
ChangeWatcher
  setHandler (handler:Function ):void
핸들러 함수를 설정합니다.
ChangeWatcher
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
  unwatch ():void
이 ChangeWatcher 인스턴스 및 핸들러 함수를 현재의 호스트로부터 삭제합니다.
ChangeWatcher
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
  watch (host:Object , chain:Object , handler:Function , commitOnly:Boolean = false):ChangeWatcher
[static] ChangeWatcher 인스턴스를 작성해, 개시합니다.
ChangeWatcher
constructor    의 상세
ChangeWatcher()constructor   
public 함수 ChangeWatcher(access:Object , handler:Function , commitOnly:Boolean = false, next:ChangeWatcher = null)

constructor   . 공공적이어의 사용을 목적으로 하고 있지 않습니다. 이 Methods는,watch() Methods로부터만 불려 갑니다. Parameters(parameter)의 사용법에 대해서는,watch() Methods를 참조해 주세요.

Parameters
access:Object
 
handler:Function
 
commitOnly:Boolean (default = false)
 
next:ChangeWatcher (default = null)
Methods의 상세
canWatch()Methods
public static function canWatch(host:Object , name:String , commitOnly:Boolean = false):Boolean

그 property에 대한 데이터 바인딩 이벤트를 호스트가 공개하고 있을지 어떨지를 판별할 수 있습니다.

Parameters
host:Object — property의 호스트입니다. 상세한 것에 대하여는,watch() Methods를 참조해 주세요.
 
name:String — property 또는 property 체인의 이름입니다. 상세한 것에 대하여는,watch() Methods를 참조해 주세요.
 
commitOnly:Boolean (default = false) — 위탁하는 change 이벤트에서만 핸들러를 호출하는 경우는 true 로 설정합니다. 상세한 것에 대하여는,watch() Methods를 참조해 주세요.

반환값
Boolean hostname 에 대한 change 이벤트를 공개하고 있는 경우는 true 입니다.
getEvents()Methods 
public static function getEvents(host:Object , name:String , commitOnly:Boolean = false):Object

호스트 object의 모든 바인드 가능 property에 대한 모든 바인딩 이벤트를 돌려줍니다.

Parameters
host:Object — property의 호스트입니다. 상세한 것에 대하여는,watch() Methods를 참조해 주세요.
 
name:String — property 또는 property 체인의 이름입니다. 상세한 것에 대하여는,watch() Methods를 참조해 주세요.
 
commitOnly:Boolean (default = false) — 위탁하지 않는 change 이벤트를 반환값에 포함할지 어떨지를 제어합니다.

반환값
Object — 그 property에 대한 모든 change 이벤트를 포함한 { eventName: isCommitting, ... } 형식의 object입니다.
getValue()Methods 
public function getValue():Object

감시되는 property 또는 property 체인의 현재의 값을 취득합니다. 호스트 object가 null 의 경우는 null 가 취득됩니다. 다음에 예를 나타냅니다.

watch(obj, ["a","b","c"], ...). getValue() === obj.a.b.c
   

반환값
Object — 감시되는 property 또는 property 체인의 현재의 값입니다.
isWatching()Methods 
public function isWatching():Boolean

체인내의 각 Watcher 에 적어도 1 개의 change 이벤트를 관련지을 수 있고 있는 경우는,true 를 돌려줍니다. Watcher 로 선택된 property에 대해서 발생하는 change 이벤트는 호스트에 따라서 다른 경우가 있기 (위해)때문에,isWatching() Methods는 호스트에 따라서 다릅니다.

반환값
Boolean — 체인내의 각 Watcher 에 적어도 1 개의 change 이벤트를 관련지을 수 있고 있는 경우는,true 입니다.
reset()Methods 
public function reset(newHost:Object ):void

이 ChangeWatcher 인스턴스를 리셋트 해, 새로운 호스트 object를 사용합니다. 이 Methods를 호출하면, 다른 호스트에 있는 Watcher 인스턴스를 재사용할 수 있습니다.

Parameters
newHost:Object — property의 새로운 호스트입니다. 상세한 것에 대하여는,watch() Methods를 참조해 주세요.
setHandler()Methods 
public function setHandler(handler:Function ):void

핸들러 함수를 설정합니다.

Parameters
handler:Function — 핸들러 함수입니다. 이 인수를 null 로 지정하지 말아 주세요.
unwatch()Methods 
public function unwatch():void

이 ChangeWatcher 인스턴스 및 핸들러 함수를 현재의 호스트로부터 삭제합니다. reset() Methods를 사용하면, ChangeWatcher 인스턴스를 재추가해, 다른 호스트 object에 있는 같은 property 또는 property 체인을 감시할 수 있습니다.

watch()Methods 
public static function watch(host:Object , chain:Object , handler:Function , commitOnly:Boolean = false):ChangeWatcher

ChangeWatcher 인스턴스를 작성해, 개시합니다. 1 개의 ChangeWatcher 인스턴스로, 1 개의 property 또는 property 체인을 감시할 수 있습니다. property 체인은, 호스트 object로부터 액세스 할 수 있는 일련의 property입니다. 예를 들어, 식 obj.a.b.c 에는 property 체인 (a, b, c)이 있습니다.

Parameters
host:Object — 감시되는 property 또는 property 체인을 호스트 하는 object입니다. reset() Methods를 사용하면, ChangeWatcher 인스턴스를 작성한 후에 host 인수의 값을 변경할 수 있습니다.
 
chain:Object — 감시되는 property 또는 property 체인을 지정하는 값입니다. 유효한 값은 다음과 같습니다.
  • 호스트 object의 파브릭크궶바인드 가능 Public property의 이름을 포함한 string.
  • 형식이{ name: property name, access: function(host) { return host[name] } } 의 object. 이 object에는, 파브릭크궶바인드 가능 property, 및 그 property의 getter 로서 기능하는 함수의 이름이 포함됩니다.
  • 최초의 2 개의 옵션의 임의의 편성을 포함한 empty이 아닌 배열. 이것은, 호스트로부터 액세스 할 수 있는 바인드 가능 property의 체인을 나타냅니다. 예를 들어, property host.a.b.c 를 감시하려면 ,watch(host, ["a","b","c"], ...) (와)과 같이 Methods를 호출합니다.

메모 : describeType()Methods에서는, 비Public property에 관한 정보는 돌려주어지지 않기 때문에, 체인 인수로 지정하는 property는 공공적인 필요가 있습니다. 비Public property에는, 특정의 property에 대해서 공개되고 있는 change 이벤트를 검색하기 위해서 ChangeWatcher 가 스캔 하는, 바인드 가능성을 나타내는 메타데이타등이 있습니다. 다만, 상기의 { name, getter } 인수 형식의 사용시에 getter 함수를 지정하면, 지정한 (Public) property에 임의의 계산 결과를 관련지을 수가 있습니다.

 
handler:Function — 감시되는 property 또는 감시되는 체인내의 property의 변경시에 불려 가는 event 핸들러 함수입니다. Watcher 체인내의 호스트 object에 의해, 그 호스트 object의 [Bindable] 메타데이타타그로 감시 대상 property에 대해서 지정된 이벤트가 dispatch되었을 때에, 변경이 통지됩니다. 디폴트 이벤트의 이름은 propertyChange 입니다.

바인드 가능 property에 의해 dispatch된 event object는, 변경이 없어도 이 핸들러 함수에게 건네집니다. 디폴트에서는, PropertyChangeEvent 형의 event object가 dispatch됩니다. 다만,[Bindable] 메타데이타타그를 사용해 바인드 가능 property를 정의하는 경우, 독자적인 event 타입을 정의할 수 있습니다.

 
commitOnly:Boolean (default = false) — 위탁하는 change 이벤트에서만 핸들러를 호출하는 경우는 true 로 설정해, 위탁하는 change 이벤트와 위탁하지 않는 change 이벤트의 양쪽 모두로 핸들러를 호출하는 경우는 false 로 설정합니다. 메모 : property에 대한 위탁하지 않는 change 이벤트의 존재는,[NonCommittingChangeEvent(<event-name>)] 메타데이타타그로 나타납니다. 통상은, 텍스트 필드에서의 확정전의 변경등이 상세한 값의 변경을 나타내는데, 이러한 태그가 사용됩니다.

반환값
ChangeWatcher — 적어도 1 개의 property명이 chain 인수로 지정되고 있는 경우는 ChangeWatcher 인스턴스, 그 이외의 경우는 null 입니다. 지정된 property 또는 property 체인에 대한 이벤트를 호스트가 공개하고 있지 않는 경우가 있기 (위해)때문에, 돌려주어진 Watcher 가 change 이벤트의 검출과 관련지어에 성공했는지 어떠했는지는 프로텍션되지 않습니다. isWatching() Methods를 사용하면, Watcher 상태를 확인할 수 있습니다.






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/binding/utils/ChangeWatcher.html