|
 |
|
| |
org.eclipse.jface.databinding.swt
Class WidgetValueProperty
java.lang.Object
 org.eclipse.core.databinding.property.value.ValueProperty
org.eclipse.core.databinding.property.value.SimpleValueProperty
org.eclipse.jface.databinding.swt.WidgetValueProperty
-
All Implemented Interfaces:
- org.eclipse.core.databinding.property.IProperty, org.eclipse.core.databinding.property.value.IValueProperty,
IWidgetValueProperty
-
public abstract class WidgetValueProperty
- extends org.eclipse.core.databinding.property.value.SimpleValueProperty
- implements
IWidgetValueProperty
Abstract value property implementation for
Widget properties. This
class implements some basic behavior that widget properties are generally
expected to have, namely:
- Calling
observe(Object) should create the observable on the
display realm of the widget, rather than the current default realm
- All
observe() methods should return an
ISWTObservableValue
This class also provides a default widget listener implementation using SWT's
untyped listener API. Subclasses may pass one or more SWT
event type constants to the super constructor to indicate which events signal
a property change.
-
Since:
- 1.3
|
Constructor Summary
|
protected
|
WidgetValueProperty
()
Constructs a WidgetValueProperty which does not listen for any SWT
events. |
protected
|
WidgetValueProperty
(int changeEvent)
Constructs a WidgetValueProperty with the specified SWT event type |
protected
|
WidgetValueProperty
(int[] changeEvents)
Constructs a WidgetValueProperty with the specified SWT event type(s). |
|
WidgetValueProperty
(int[] changeEvents,
int[] staleEvents)
Constructs a WidgetValueProperty with the specified SWT event types. |
|
Methods inherited from class org.eclipse.core.databinding.property.value.SimpleValueProperty
|
doGetValue, doSetValue, getValue, observeDetail, observeDetail, observeDetail, setValue
|
|
Methods inherited from class org.eclipse.core.databinding.property.value.ValueProperty
|
list, map, observeDetail, set, value, valueFactory, valueFactory
|
|
Methods inherited from class java.lang.
Object
|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
|
|
Methods inherited from interface org.eclipse.core.databinding.property.value.IValueProperty
|
getValueType, list, map, observeDetail, observeDetail, observeDetail, observeDetail, set, value, valueFactory, valueFactory
|
WidgetValueProperty
protected WidgetValueProperty()
- Constructs a WidgetValueProperty which does not listen for any SWT
events.
WidgetValueProperty
protected WidgetValueProperty(int changeEvent)
- Constructs a WidgetValueProperty with the specified SWT event type
-
Parameters:
-
changeEvent - SWT event type constant of the event that signifies a property
change.
WidgetValueProperty
protected WidgetValueProperty(int[] changeEvents)
- Constructs a WidgetValueProperty with the specified SWT event type(s).
-
Parameters:
-
changeEvents - array of SWT event type constants of the events that signify a
property change.
WidgetValueProperty
public WidgetValueProperty(int[] changeEvents,
int[] staleEvents)
- Constructs a WidgetValueProperty with the specified SWT event types.
-
Parameters:
-
changeEvents - array of SWT event type constants of the events that signify a
property change. -
staleEvents - array of SWT event type constants of the events that signify a
property became stale.
adaptListener
public org.eclipse.core.databinding.property.INativePropertyListener adaptListener(org.eclipse.core.databinding.property.ISimplePropertyListener listener)
-
Description copied from class:
org.eclipse.core.databinding.property.value.SimpleValueProperty
- Returns a listener capable of adding or removing itself as a listener on
a source object using the the source's "native" listener API. Events
received from the source objects are parlayed to the specified listener
argument.
This method returns null if the source object has no listener APIs for
this property.
-
-
Specified by:
-
adaptListener in class org.eclipse.core.databinding.property.value.SimpleValueProperty
-
-
Parameters:
-
listener - the property listener to receive events
-
Returns:
- a native listener which parlays property change events to the
specified listener, or null if the source object has no listener
APIs for this property.
observe
public
IObservableValue observe(
Object source)
-
Description copied from interface:
org.eclipse.core.databinding.property.value.IValueProperty
- Returns an observable value observing this value property on the given
property source.
-
-
Specified by:
-
observe in interface org.eclipse.core.databinding.property.value.IValueProperty
-
Overrides:
-
observe in class org.eclipse.core.databinding.property.value.ValueProperty
-
-
Parameters:
-
source - the property source
-
Returns:
- an observable value observing this value property on the given
property source
observe
public
IObservableValue observe(
Realm realm,
Object source)
-
Description copied from interface:
org.eclipse.core.databinding.property.value.IValueProperty
- Returns an observable value observing this value property on the given
property source
-
-
Specified by:
-
observe in interface org.eclipse.core.databinding.property.value.IValueProperty
-
Overrides:
-
observe in class org.eclipse.core.databinding.property.value.SimpleValueProperty
-
-
Parameters:
-
realm - the observable's realm -
source - the property source
-
Returns:
- an observable value observing this value property on the given
property source
wrapObservable
protected
ISWTObservableValue wrapObservable(
IObservableValue observable,
Widget widget)
-
-
observe
public
ISWTObservableValue observe(
Widget widget)
-
Description copied from interface:
IWidgetValueProperty
- Returns an
ISWTObservableValue observing this value property on
the given widget
-
-
Specified by:
-
observe
in interface
IWidgetValueProperty
-
-
Parameters:
-
widget - the source widget
-
Returns:
- an observable value observing this value property on the given
widget
observeDelayed
public
ISWTObservableValue observeDelayed(int delay,
Widget widget)
-
Description copied from interface:
IWidgetValueProperty
- Returns an
ISWTObservableValue observing this value property on
the given widget, which delays notification of value changes until at
least delay milliseconds have elapsed since that last change
event, or until a FocusOut event is received from the widget (whichever
happens first).
This method is equivalent to
SWTObservables.observeDelayedValue(delay, observe(widget)).
-
-
Specified by:
-
observeDelayed
in interface
IWidgetValueProperty
-
-
Parameters:
-
delay - the delay in milliseconds. -
widget - the source widget
-
Returns:
- an observable value observing this value property on the given
widget, and which delays change notifications for
delay milliseconds.
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.
|
|
|
