IExpression
Defines a contract for expression objects that can provide dynamic property values and participate in the RadProperty value resolution system.
Definition
Namespace:Telerik.WinControls
Assembly:Telerik.WinControls.dll
Syntax:
public interface IExpression
Methods
Gets the current value for the specified property on the given RadObject.
object GetValue(RadObject forObject, RadProperty property)
The RadObject instance for which to retrieve the property value.
propertyRadPropertyThe RadProperty whose value should be retrieved.
Returns:The current value of the property, or UnsetValue if no value is available.
This method is called by the property system when resolving property values. Implementations should return the appropriate value based on their expression logic or UnsetValue to allow fallback to the next value source.
Called when this expression is being attached to the specified property on the given RadObject.
void OnAttach(RadObject radObject, RadProperty dp)
The RadObject to which the expression is being attached.
dpRadPropertyThe RadProperty to which the expression is being attached.
This method provides an opportunity for expressions to initialize resources, subscribe to events, or perform other setup operations when they begin providing values for a property.
Called when this expression is being removed from the specified property on the given RadObject.
void OnDetach(RadObject radObject, RadProperty dp)
The RadObject from which the expression is being detached.
dpRadPropertyThe RadProperty from which the expression is being detached.
This method provides an opportunity for expressions to clean up resources, unsubscribe from events, or perform other cleanup operations when they are no longer providing values for a property.
Attempts to set a value through this expression.
bool SetValue(RadObject radObject, RadProperty dp, object value)
The RadObject on which to set the property value.
dpRadPropertyThe RadProperty to set.
valueobjectThe value to set.
Returns:true if the expression handled the set operation; otherwise, false.
Most expression types are read-only and will return false from this method.
Data binding expressions may support two-way binding and return true when
they successfully update the underlying data source.