prop:String — The name of the public property defined in the
site Object to be bound.
The property will receive the current value of chain,
when the value of chain changes.

host:Object — The object that hosts the property or property chain
to be watched.
The host maintains a list of sites to update
when prop changes.

chain:Object — A value specifying the property or chain to be watched.
Legal values are:

String containing the name of a public bindable property
of the host object.

An Object in the form:
{ name: property name, getter: function(host) { return host[property name] } }.
This Object must contain the name of, and a getter function for,
a public bindable property of the host object.

A non-empty Array containing a combination of the first two
options that represents a chain of bindable properties accessible
from the host.
For example, to bind the property host.a.b.c,
call the method as:
bindProperty(site, prop, host, ["a","b","c"]).

Note: The property or properties named in the chain argument
must be public, because the describeType() method suppresses all information
about non-public properties, including the bindability metadata
that ChangeWatcher scans to find the change events that are exposed
for a given property.
However, the getter function supplied when using the { name, getter }
argument form described above can be used to associate an arbitrary
computed value with the named (public) property.

commitOnly:Boolean (default = false) — Set to true if the handler
should be called only on committing change events;
set to false if the handler should be called
on both committing and non-committing change events.
Note: the presence of non-committing change events for a property
is indicated by the [NonCommittingChangeEvent(<event-name>)]
metadata tag.
Typically these tags are used to indicate fine-grained value changes,
such as modifications in a text field prior to confirmation.

useWeakReference:Boolean (default = false) — Determines whether the reference to site
is strong or weak.
A strong reference (the default) prevents site from being garbage-collected.
A weak reference does not.
Added for Flex 4.

Returns

ChangeWatcher — A ChangeWatcher instance, if at least one property name has
been specified to the chain argument; null otherwise.

Binds a setter function, setter, to a bindable property
or property chain.
If a ChangeWatcher instance is successfully created,
the setter function is invoked.
The setter must have the following function signature:

function mySetterFunction(object:Object):void {
//Do whatever you want with the value of the bound property.
}

where object contains the
current value of chain.

Parameters

setter:Function — Setter method to invoke with an argument of the current
value of chain when that value changes.

host:Object — The host of the property.
See the bindProperty() method for more information.
The host maintains a list of setters to update
when prop changes.

chain:Object — The name of the property, or property chain.
See the bindProperty() method for more information.

commitOnly:Boolean (default = false) — Set to true if the handler should be
called only on committing change events.
See the bindProperty() method for more information.

useWeakReference:Boolean (default = false) — Determines whether the reference to setter
is strong or weak.
A strong reference (the default) prevents setter from being garbage-collected.
A weak reference does not.
Added for Flex 4.

Returns

ChangeWatcher — A ChangeWatcher instance, if at least one property name
has been specified to the chain argument; null otherwise.