Struct ReflectionBinding 

pub struct ReflectionBinding { /* private fields */ }

A binding whose path is text, resolved at run time against the metadata that the objects along the path declared: registered properties for objects of the class hierarchy, declared model metadata for everything else.

A binding is a mutable reference object: it is created with ReflectionBinding::empty or ReflectionBinding::new, configured property by property (or with the chaining with_* forms) and shared as Rc<ReflectionBinding>, which converts to Rc<dyn BindingBase>. Handles compare by identity. The properties are read when the binding is instantiated on a target: changing them afterwards affects later instances only.

Implementations

impl ReflectionBinding

pub fn converter(&self) -> Option<Rc<dyn IValueConverter>>

The converter to use.

pub fn set_converter(&self, value: Option<Rc<dyn IValueConverter>>)

pub fn with_converter_value( self: Rc<Self>, value: Option<Rc<dyn IValueConverter>>, ) -> Rc<Self>

The chaining form of the setter.

pub fn converter_culture(&self) -> Option<CultureInfo>

The culture in which to evaluate the converter. None (the default) uses the current culture.

pub fn set_converter_culture(&self, value: Option<CultureInfo>)

pub fn with_converter_culture( self: Rc<Self>, value: Option<CultureInfo>, ) -> Rc<Self>

The chaining form of the setter.

pub fn converter_parameter(&self) -> Option<BoxedValue>

A parameter to pass to the converter.

pub fn set_converter_parameter(&self, value: Option<BoxedValue>)

pub fn with_converter_parameter( self: Rc<Self>, value: Option<BoxedValue>, ) -> Rc<Self>

The chaining form of the setter.

pub fn delay(&self) -> i32

The amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

pub fn set_delay(&self, value: i32)

pub fn with_delay(self: Rc<Self>, value: i32) -> Rc<Self>

The chaining form of the setter.

pub fn element_name(&self) -> Option<String>

The name of the element to use as the binding source.

pub fn set_element_name(&self, value: Option<String>)

pub fn with_element_name(self: Rc<Self>, value: Option<String>) -> Rc<Self>

The chaining form of the setter.

pub fn fallback_value(&self) -> Option<BoxedValue>

The value to use when the binding is unable to produce a value; the unset marker for none.

pub fn set_fallback_value(&self, value: Option<BoxedValue>)

pub fn with_fallback_value( self: Rc<Self>, value: Option<BoxedValue>, ) -> Rc<Self>

The chaining form of the setter.

pub fn mode(&self) -> BindingMode

The binding mode.

pub fn set_mode(&self, value: BindingMode)

pub fn with_mode(self: Rc<Self>, value: BindingMode) -> Rc<Self>

The chaining form of the setter.

pub fn path(&self) -> String

The binding path.

pub fn set_path(&self, value: String)

pub fn with_path(self: Rc<Self>, value: String) -> Rc<Self>

The chaining form of the setter.

pub fn priority(&self) -> BindingPriority

The binding priority.

pub fn set_priority(&self, value: BindingPriority)

pub fn with_priority(self: Rc<Self>, value: BindingPriority) -> Rc<Self>

The chaining form of the setter.

pub fn relative_source(&self) -> Option<Rc<RelativeSource>>

The relative source for the binding.

pub fn set_relative_source(&self, value: Option<Rc<RelativeSource>>)

pub fn with_relative_source( self: Rc<Self>, value: Option<Rc<RelativeSource>>, ) -> Rc<Self>

The chaining form of the setter.

pub fn source(&self) -> Option<BoxedValue>

The source for the binding; the unset marker (the default) for none.

pub fn set_source(&self, value: Option<BoxedValue>)

pub fn with_source(self: Rc<Self>, value: Option<BoxedValue>) -> Rc<Self>

The chaining form of the setter.

pub fn string_format(&self) -> Option<String>

The string format.

pub fn set_string_format(&self, value: Option<String>)

pub fn with_string_format(self: Rc<Self>, value: Option<String>) -> Rc<Self>

The chaining form of the setter.

pub fn target_null_value(&self) -> Option<BoxedValue>

The value to use when the binding produces null; the unset marker for none.

pub fn set_target_null_value(&self, value: Option<BoxedValue>)

pub fn with_target_null_value( self: Rc<Self>, value: Option<BoxedValue>, ) -> Rc<Self>

The chaining form of the setter.

pub fn update_source_trigger(&self) -> UpdateSourceTrigger

What triggers updates of the binding source in two-way and one-way-to-source bindings.

pub fn set_update_source_trigger(&self, value: UpdateSourceTrigger)

pub fn with_update_source_trigger( self: Rc<Self>, value: UpdateSourceTrigger, ) -> Rc<Self>

The chaining form of the setter.

pub fn type_resolver(&self) -> Option<TypeResolver>

Resolves the type names in the path (casts, attached properties, ancestor types).

pub fn set_type_resolver(&self, value: Option<TypeResolver>)

pub fn with_type_resolver( self: Rc<Self>, value: Option<TypeResolver>, ) -> Rc<Self>

The chaining form of the setter.

pub fn default_anchor(&self) -> Option<WeakRef<FerroObject>>

The anchor to use if the target is not an element.

pub fn set_default_anchor(&self, value: Option<WeakRef<FerroObject>>)

pub fn with_default_anchor( self: Rc<Self>, value: Option<WeakRef<FerroObject>>, ) -> Rc<Self>

The chaining form of the setter.

pub fn name_scope(&self) -> Option<Weak<dyn INameScope>>

The name scope in which named elements are looked up.

pub fn set_name_scope(&self, value: Option<Weak<dyn INameScope>>)

pub fn with_name_scope( self: Rc<Self>, value: Option<Weak<dyn INameScope>>, ) -> Rc<Self>

The chaining form of the setter.

impl ReflectionBinding

pub fn empty() -> Rc<Self>

Creates a binding without a path (the parameterless constructor).

pub fn new(path: &str) -> Rc<Self>

Creates a binding with the given path.

pub fn construct(path: &str) -> Self

The class data of a binding with the given path, for a type that derives from this one.

pub fn with_converter( self: Rc<Self>, converter: Rc<dyn IValueConverter>, ) -> Rc<Self>

The chaining form of set_converter, for a converter.

pub fn try_create_instance( &self, target: &FerroObject, target_property: Option<&'static FerroProperty>, anchor: Option<&Ref<FerroObject>>, ) -> Result<Rc<BindingExpression>, ExpressionParseException>

Instantiates the binding, reporting a malformed path as an error instead of panicking.

Trait Implementations

impl BindingBase for ReflectionBinding

fn create_instance( &self, target: &FerroObject, target_property: Option<&'static FerroProperty>, anchor: Option<&Ref<FerroObject>>, ) -> Rc<dyn BindingExpressionBase>

Panics if the path is malformed (a programmer error, as in the managed implementation); use try_create_instance for paths that come from user input.

fn as_any(&self) -> Option<&dyn Any>

The implementing value, for casting to its concrete type (as_any()?.downcast_ref::<T>()): the equivalent of is/as on the contract. None for an implementation that does not expose itself.

impl Default for ReflectionBinding

fn default() -> Self

Returns the “default value” for a type.

impl MarkupTyped for ReflectionBinding

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl PartialEq for ReflectionBinding

Compares by identity (reference equality), as the reference type this mirrors.

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.