精通Silverlight——12.5.3 定义控件属性

　　在开始添加属性和行为之前应该理解，定义用户UI的XAML文件将作为程序集的资源嵌入到程序集中。因此为了能够引用XAML中定义的对象，必须在类的构造函数中添加一些代码，通常分为如下四步。

q      获取当前程序集的实例。

q      从程序集中获取资源文件流。

q      将流转换为字符串类型。

q      使用Control类的 InitializeFromXaml 实例化XAML中定义的可视化树。

在MyLabel控件中，相应的程序代码如下所示：

   public class MyLabel : Control

    {

        //implementationRoot相当于根画布

        FrameworkElement implementationRoot;

        //Xaml文件中定义的TextBlock

        TextBlock tb;

        public MyLabel()

        {

            //获取当前程序集实例

            Assembly asm = this.GetType().Assembly;

            //获取程序集的资源清单，注意xaml的命名。

            Stream s = asm.GetManifestResourceStream("mySampleControls.MyLabel.xaml");

            //调用InitializeFromXaml初始化控件树。

            implementationRoot = this.InitializeFromXaml(new StreamReader(s).ReadToEnd());

            //获取在Xaml中定义的TextBlock控件

            tb = implementationRoot.FindName("tb") as TextBlock;

            //定义加载事件

            this.Loaded += new EventHandler(MyLabel_Loaded);

            //指定宽和高

            base.Width = implementationRoot.Width;

            base.Height = implementationRoot.Height;

        }

        ……

VS2008会为用户控件项目自动添加如下的代码，完成与上面代码相同的工作。

        public MyLabel()

        {

            System.IO.Stream s = this.GetType().Assembly.GetManifestResourceStream("mySampleControls.MyLabel.xaml");

            this.InitializeFromXaml(new System.IO.StreamReader(s).ReadToEnd());

        }

默认情况下，控件并不具有任何属性。通过在类中添加公共属性定义，就能在XAML和代码文件中使用控件的属性了，MyLabel控件定义了四个属性，代码如下所示：

        //定义控件的宽度

        public virtual new double Width

        {

            get

            {

                return implementationRoot.Width;

            }

            set

            {

                implementationRoot.Width = value;

                UpdateLayout();

            }

        }

        //定义控件的高度

        public virtual new double Height

        {

            get

            {

                return implementationRoot.Height;

            }

            set

            {

                implementationRoot.Height = value;

                UpdateLayout();

            }

        }

        //定义控件的文本设置属性

        public String Text

        {

            get

            {

                return tb.Text;

            }

            set

            {

                tb.Text = value;

                UpdateLayout();

            }

        }

        //定义控件的颜色

        public SolidColorBrush LabelColor

        {

            get

            {

                return (SolidColorBrush)tb.Foreground;

            }

            set

            {

                tb.Foreground = (SolidColorBrush)value;

            }

        }

        protected void UpdateLayout()

        {

            tb.SetValue(Canvas.LeftProperty, (Width - tb.ActualWidth) / 2);

            tb.SetValue(Canvas.TopProperty, (Height - tb.ActualHeight) / 2);

        }

注意这里使用了new关键字定义控件的Width和Height属性，C#中的new关键字用于隐藏基类的定义。由于Control也具有Width和Height属性，但是这两个属性与控件的实际的宽度和高度并不具有任何的关联。这两个属性非常重要，读者在创建用户控件时应该使用new关键字隐藏Control类的Width和Height。

Width和Height的设置和设置值都被转换为画布的高度和宽度，用户控件本身也可以看作是一个组合控件的容器，类似于ASP.NET中的用户控件一样。最后属性的set语法中调用了UpdateLayout事件，用于当属性值更改后自动更新控件的布局。