Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
swdev:dotnet:wpf:dependency_properties [2010/12/27 14:56] smayr created |
swdev:dotnet:wpf:dependency_properties [2013/01/25 09:16] (current) smayr [Example 1] |
||
---|---|---|---|
Line 1: | Line 1: | ||
== Dependency Properties == | == Dependency Properties == | ||
- | If data binding to certain properties | + | If data binding |
Here is a good example (from: [[http:// | Here is a good example (from: [[http:// | ||
Line 8: | Line 8: | ||
public class Button : ButtonBase | public class Button : ButtonBase | ||
{ | { | ||
- | // The dependency property | + | |
- | public static readonly DependencyProperty IsCancelProperty; | + | public static readonly DependencyProperty IsCancelProperty; |
- | static Button() | + | |
+ | // Constructor | ||
+ | | ||
+ | { | ||
+ | // Register the property | ||
+ | Button.IsCancelProperty = DependencyProperty.Register(“IsCancel”, | ||
+ | typeof(bool), | ||
+ | new FrameworkPropertyMetadata(false, | ||
+ | new PropertyChangedCallback(OnIsCancelPropertyChanged))); | ||
+ | … | ||
+ | } | ||
+ | |||
+ | // A .NET property wrapper (not must) | ||
+ | public bool IsCancel | ||
+ | { | ||
+ | get { return (bool)GetValue(Button.IsCancelProperty ); } | ||
+ | set { SetValue(Button.IsCancelProperty , value); } | ||
+ | } | ||
+ | |||
+ | // A property changed callback (not must) | ||
+ | private static void OnIsCancelPropertyChanged( | ||
+ | DependencyObject o, DependencyPropertyChangedEventArgs e) { … } | ||
+ | … | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | Alternatively: | ||
+ | <code csharp> | ||
+ | public class Button : ButtonBase | ||
{ | { | ||
- | // Register the property | + | |
- | Button.IsCancelProperty = DependencyProperty.Register(“IsCancel”, | + | |
- | typeof(bool), | + | typeof(bool), |
- | new FrameworkPropertyMetadata(false, | + | new FrameworkPropertyMetadata(false, |
- | new PropertyChangedCallback(OnIsDefaultChanged))); | + | new PropertyChangedCallback(OnIsCancelPropertyChanged))); |
- | … | + | |
+ | // A .NET property wrapper (not must) | ||
+ | public bool IsCancel | ||
+ | { | ||
+ | get { return (bool)GetValue(Button.IsCancelProperty ); } | ||
+ | set { SetValue(Button.IsCancelProperty , value); } | ||
+ | } | ||
+ | |||
+ | // A property changed callback (not must) | ||
+ | private static void OnIsCancelPropertyChanged( | ||
+ | DependencyObject source, DependencyPropertyChangedEventArgs e) | ||
+ | { | ||
+ | | ||
+ | |||
+ | // Put some update logic here... | ||
+ | | ||
+ | if (control.IsCancel == true) | ||
+ | { | ||
+ | // do something | ||
+ | } | ||
+ | } | ||
+ | |||
+ | // Constructor | ||
+ | static Button() | ||
+ | { | ||
+ | } | ||
+ | |||
+ | | ||
} | } | ||
- | // A .NET property wrapper (not must) | + | </code> |
- | public bool IsCancel | + | |
+ | IMPORTANT: The accessor property is fine to use, but the XAML code will only call the SetValue() and GetValue() methods directly, so make sure that no other code gets added to the accessor property, to make sure both work the same. | ||
+ | |||
+ | === Example 1 === | ||
+ | <code csharp> | ||
+ | public class Employee : DependencyObject | ||
{ | { | ||
- | get { return (bool)GetValue(Button.IsCancelProperty | + | private static readonly DependencyProperty EmpIdProperty = |
- | set { SetValue(Button.IsCancelProperty | + | DependencyProperty.Register(" |
- | } | + | new PropertyMetadata(0, |
- | // A property changed callback | + | new PropertyChangedCallback(EmpIdCallBack), |
- | private static void OnIsCancelChanged( | + | new CoerceValueCallback(CoerceEmpId))); |
- | DependencyObject o, DependencyPropertyChangedEventArgs e) { … } | + | |
- | … | + | private static readonly DependencyProperty NameProperty = |
+ | DependencyProperty.Register(" | ||
+ | |||
+ | private static readonly DependencyProperty DepartmentProperty = | ||
+ | DependencyProperty.Register(" | ||
+ | |||
+ | private static readonly DependencyProperty CompanyProperty = | ||
+ | DependencyProperty.Register(" | ||
+ | new PropertyMetadata(" | ||
+ | |||
+ | // If employee id is greater than 1000 then make it 1000 | ||
+ | static void EmpIdCallBack(DependencyObject d, DependencyPropertyChangedEventArgs args) | ||
+ | { | ||
+ | Employee emp = (Employee)d; | ||
+ | |||
+ | if (emp.EmpId >= 1000) | ||
+ | { | ||
+ | emp.EmpId = 1000; | ||
+ | } | ||
+ | } | ||
+ | |||
+ | // If the employee Id is negative then make it positive | ||
+ | static Object CoerceEmpId(DependencyObject d, Object baseValue) | ||
+ | { | ||
+ | int value = (int)baseValue; | ||
+ | |||
+ | if (value < 0) | ||
+ | return value * -1; | ||
+ | else | ||
+ | return value; | ||
+ | } | ||
+ | |||
+ | public int EmpId | ||
+ | { | ||
+ | | ||
+ | set { SetValue(EmpIdProperty, value); } | ||
+ | } | ||
+ | |||
+ | public string Name | ||
+ | { | ||
+ | get { return | ||
+ | set { SetValue(NameProperty, | ||
+ | } | ||
+ | |||
+ | public string Department | ||
+ | { | ||
+ | get { return (string)GetValue(DepartmentProperty); | ||
+ | set { SetValue(DepartmentProperty, value); } | ||
+ | } | ||
+ | |||
+ | public string Company | ||
+ | | ||
+ | get { return (string)GetValue(CompanyProperty); | ||
+ | set { SetValue(CompanyProperty, | ||
+ | } | ||
} | } | ||
</ | </ | ||
+ | |||
+ | Source: [[http:// | ||
+ | |||
+ | === Example 2 === | ||
+ | |||
+ | A user control that requires a Dependency Property in order to set the '' | ||
+ | |||
+ | XAML: | ||
+ | <code xml> | ||
+ | < | ||
+ | . . . | ||
+ | < | ||
+ | <ListBox Name=" | ||
+ | | ||
+ | < | ||
+ | < | ||
+ | <Image Source="/ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | <Image Source="/ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | <Image Source="/ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | C# code: | ||
+ | <code csharp> | ||
+ | using System; | ||
+ | using System.Collections.Generic; | ||
+ | using System.Linq; | ||
+ | using System.Text; | ||
+ | using System.Windows; | ||
+ | using System.Windows.Controls; | ||
+ | using System.Windows.Data; | ||
+ | using System.Windows.Documents; | ||
+ | using System.Windows.Input; | ||
+ | using System.Windows.Media; | ||
+ | using System.Windows.Media.Imaging; | ||
+ | using System.Windows.Navigation; | ||
+ | using System.Windows.Shapes; | ||
+ | |||
+ | namespace ACME.Controls | ||
+ | { | ||
+ | public partial class ucActiveInstrument : UserControl | ||
+ | { | ||
+ | #region DependencyProperty SelectedItemIndex | ||
+ | // | ||
+ | // SelectedItemIndex | ||
+ | // | ||
+ | // Dependency Property | ||
+ | public static readonly DependencyProperty SelectedItemIndexProperty = | ||
+ | DependencyProperty.Register( | ||
+ | " | ||
+ | typeof(int), | ||
+ | typeof(ucActiveInstrument), | ||
+ | new FrameworkPropertyMetadata( | ||
+ | new int(), | ||
+ | OnSelectedItemIndexPropertyChanged | ||
+ | ) | ||
+ | ); | ||
+ | |||
+ | // .NET Property Wrapper | ||
+ | public int SelectedItemIndex | ||
+ | { | ||
+ | // Important: Do not add any logic to these properties, because they are only | ||
+ | // called when you set the property from code. If you set the property from XAML | ||
+ | // the SetValue() method is called directly. | ||
+ | get { return (int)GetValue(SelectedItemIndexProperty); | ||
+ | set { SetValue(SelectedItemIndexProperty, | ||
+ | } | ||
+ | // Alias | ||
+ | public int SelectedItemIdx | ||
+ | { | ||
+ | get { return SelectedItemIndex; | ||
+ | } | ||
+ | |||
+ | /// | ||
+ | /// < | ||
+ | /// OnPropertyChanged event handler for fitting view model. | ||
+ | /// </ | ||
+ | /// <param name=" | ||
+ | /// <param name=" | ||
+ | /// | ||
+ | private static void OnSelectedItemIndexPropertyChanged( | ||
+ | DependencyObject source, | ||
+ | DependencyPropertyChangedEventArgs e) | ||
+ | { | ||
+ | ucActiveInstrument control = source as ucActiveInstrument; | ||
+ | //DateTime time = (DateTime)e.NewValue; | ||
+ | |||
+ | // | ||
+ | // Put some update logic here... | ||
+ | // | ||
+ | // | ||
+ | // | ||
+ | control.lstOptions.SelectedIndex = (int)e.NewValue; | ||
+ | } | ||
+ | #endregion | ||
+ | |||
+ | // | ||
+ | /// < | ||
+ | /// Constructor. | ||
+ | /// </ | ||
+ | // | ||
+ | public ucActiveInstrument() | ||
+ | { | ||
+ | InitializeComponent(); | ||
+ | } | ||
+ | |||
+ | // | ||
+ | /// < | ||
+ | /// SelectionChange event handler for lstOptions. | ||
+ | /// </ | ||
+ | /// <param name=" | ||
+ | /// <param name=" | ||
+ | // | ||
+ | private void lstOptions_SelectionChanged(object sender, SelectionChangedEventArgs e) | ||
+ | { | ||
+ | this.SelectedItemIndex = lstOptions.SelectedIndex; | ||
+ | } | ||
+ | |||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | == See Also == | ||
+ | * [[swdev: | ||
+ | * [[http:// |