CPF 入门教程 - 属性和事件（七）

CPF C#跨平台桌面UI框架

 

系列教程

CPF 入门教程（一）

CPF 入门教程 - 数据绑定和命令绑定（二）

CPF 入门教程 - 样式和动画（三）

CPF 入门教程 - 绘图（四） 

CPF 入门教程 - 设计器和模板库的使用（五）

CPF 入门教程 - 控件布局（六） 

CPF 入门教程 - 属性和事件（七）

CPF 入门教程 - 各个控件介绍（八） 

CPF 入门教程 - 各平台各系统发布说明（九）  

 

依赖属性

CpfObject相当于WPF里的DependencyObject依赖对象。继承该类的对象，所有属性默认都是依赖属性

 

依赖属性有什么用？支持属性变化通知，数据绑定，触发器，动画等等。

 

属性写法：

        /// <summary>
        /// 绑定的数据上下文
        /// </summary>
        [PropertyMetadata(null)]
        public virtual object DataContext
        {
            get { return GetValue<object>(); }
            set { SetValue(value); }
        }

        /// <summary>
        /// 前景色
        /// </summary>
        [UIPropertyMetadata(typeof(ViewFill), "Black", UIPropertyOptions.AffectsRender)]
        public ViewFill Foreground
        {
            get { return (ViewFill)GetValue(); }
            set { SetValue(value); }
        }

 

属性上的特性可以是 PropertyMetadata或者UIPropertyMetadata 中的一个，默认值建议通过这两个特性来设置。如果不加这两个特性，那默认值就是null或者0，属性不能是private，否则子类无法使用该属性，

子类不能用new的方式来覆盖属性

如果是复杂属性类型默认值，可以通过重写 OnOverrideMetadata 来设置

        protected override void OnOverrideMetadata(OverrideMetadata overridePropertys)
        {
            base.OnOverrideMetadata(overridePropertys);
            overridePropertys.Override("StrokeStyle", new UIPropertyMetadataAttribute(new Stroke(1)));
        }

 

如果不希望声明为依赖属性，上面加[NotCpfProperty]

        [NotCpfProperty]
        public bool IsMeasureValid
        {
            get;
            private set;
        }

 

附加属性：

       

特殊的依赖属性，用来做特殊功能的标记

/// <summary>
/// 获取或设置元素行索引
/// </summary>
public static Attached<int> RowIndex
{
    get { return CpfObject.RegisterAttached(0); }
}

 

Grid.RowIndex(control, 1);//使用附加属性方式设置行索引

var index = Grid.RowIndex(control);//获取附加属性值

 
control.Attacheds.Add(Grid.ColumnIndex, 0);
//附加属性的设置和绑定
new Border
{
     Attacheds={ { Grid.ColumnIndex, 0,nameof(TabStripPlacement),this}},
}

 

计算属性

计算属性来自Vue里的computed  可绑定，只读属性

当SelectValue或者TextSize属性值变化之后导致TestComputedProperty属性值变化，有提供属性通知

        [Computed(nameof(SelectValue), nameof(TextSize))]
        public string TestComputedProperty
        {
            get { return SelectValue == null ? "" : SelectValue.ToString() + TextSize; }
        }

 

 

属性通知

如果是对象自己内部绑定，定义个方法，上面加个PropertyChanged(通知的属性名)就行，方法参数必须是

(object newValue, object oldValue, PropertyMetadataAttribute attribute)

PropertyChanged可以加多个，相当于绑定到多个属性通知事件

 

 [PropertyChanged(nameof(MarginBottom))]
 [PropertyChanged(nameof(MarginLeft))]
 [PropertyChanged(nameof(MarginRight))]
 [PropertyChanged(nameof(MarginTop))]
 void RegisterMargin(object newValue, object oldValue, PropertyMetadataAttribute attribute)
 {

 }

 

一般不建议用重写 OnPropertyChanged的方式来处理属性变化事件

 

如果外部的话，绑定PropertyChanged事件，通过事件数据CPFPropertyChangedEventArgs来判断属性和获取属性数据

 

事件定义

CpfObejct里的事件定义，弱引用事件，并且不会被重复绑定       

public event EventHandler<RoutedEventArgs> DoubleClick
{
     add { AddHandler(value); }
     remove { RemoveHandler(value); }
}


RaiseEvent(e, nameof(DoubleClick));//触发事件

 

由于是弱引用的，所以不能采用Lambda方式来绑定事件，因为可能会被回收导致绑定失效

比如这种写法this.Click+=(s,e)=>{…};