Windows 8 开发之设置合约

 　　合约：合约就像一个或多个程序之间的协议。合约定义了应用程序在与其它程序或Windows 进行交互时必须遵循的一些约定。我们对一个应用的一些设置，常用的可以放到AppBar上面，如果不是很常用的，比如应用程序的主题颜色，可以放到设置合约，也就是通过超级菜单调出来的设置面板上。下面就介绍如何把我们的设置选项添加的设置面板中。

1.引入命名空间：Windows.UI.ApplicationSettings;
2.注册设置事件

　　在程序启动的时候，App.xaml.cs文件中有一个名为OnLaunched的方法会被调用。在OnLaunched的开头，我创建了一个event handler，当用户打开SettingsPane时，会被调用。你自定义的设置画面直到用户打开Settings Charm时，才会被加载。当你“暂停”你的程序或者游戏，如果设置面板被打开了，那么这个event也会被调用。

 protected override void OnLaunched(LaunchActivatedEventArgs args)
        {
            SettingsPane.GetForCurrentView().CommandsRequested += App_CommandsRequested;    //注册设置事件
            Frame rootFrame = Window.Current.Content as Frame;

            // 不要在窗口已包含内容时重复应用程序初始化，
            // 只需确保窗口处于活动状态
            if (rootFrame == null)
            {
                // 创建要充当导航上下文的框架，并导航到第一页
                rootFrame = new Frame();

                if (args.PreviousExecutionState == ApplicationExecutionState.Terminated)
                {
                    //TODO: 从之前挂起的应用程序加载状态
                }

                // 将框架放在当前窗口中
                Window.Current.Content = rootFrame;
            }

            if (rootFrame.Content == null)
            {
                // 当未还原导航堆栈时，导航到第一页，
                // 并通过将所需信息作为导航参数传入来配置
                // 参数
                if (!rootFrame.Navigate(typeof(MainPage), args.Arguments))
                {
                    throw new Exception("Failed to create initial page");
                }
            }
            // 确保当前窗口处于活动状态
            Window.Current.Activate();
        }

        void App_CommandsRequested(SettingsPane sender, SettingsPaneCommandsRequestedEventArgs args)
        {
            SettingsCommand cmd = new SettingsCommand("关于", "关于应用", (handle) =>
            {
                Popup popup = CreatePopup.Create(new AboutPage(),346);
                popup.IsOpen = true;
                
            });
            SettingsCommand cmd1 = new SettingsCommand("主题", "主题颜色", (handle) =>
            {
                Popup popup = CreatePopup.Create(new ThemColor(), 346);
                popup.IsOpen = true;
            });
            args.Request.ApplicationCommands.Add(cmd);
            args.Request.ApplicationCommands.Add(cmd1);
        }

　　如上代码所示，我创建了一个SettingsCommand对象，并提供了三个值。除非你需要在程序运行时修改SettingsPane，否则第一个参数值并不太重要。它就是一个简单ID，随后可以通过这个ID可以引用到SettingsCommand。标签“主题颜色”可以是任意的字符串，不过我建议不要超过40个字符，否则会被截断。最后一个参数值是这个command的handler。当用户轻触lable 时，会执行该handler。在这里，我用lambada 表达式来简化该处理。表达式里面，我创建了一个Popup控件，并将其IsOpen 属性设置为true。改变这个属性，可以使Popup显示在屏幕上。

3.  创建Popup控件
　　首先是一个自定义的UserControl，之后我会介绍到该UserControl，现在只需要明白AboutPage.xaml是一个UserControl即可，AboutPage.xaml是用于Popup控件中的。

    public class CreatePopup
    {
        public static Popup Create(UserControl element, double width)
        {
            Popup p = new Popup();
            p.Child = element;
            p.IsLightDismissEnabled = true;
            p.ChildTransitions = new TransitionCollection();
            p.ChildTransitions.Add(new PaneThemeTransition()    //声明边缘 UI（如应用程序栏）的边缘转换位置。
            {
                Edge = (SettingsPane.Edge == SettingsEdgeLocation.Right) ?
                        EdgeTransitionLocation.Right :
                        EdgeTransitionLocation.Left
            });//检查SettingsPane的edge,有些国家的超级菜单在左边。

            element.Width = width;
            element.Height = Window.Current.Bounds.Height;           
            p.SetValue(Canvas.LeftProperty, SettingsPane.Edge == SettingsEdgeLocation.Right ? (Window.Current.Bounds.Width - width) : 0);//设置距离左边的边距
            p.SetValue(Canvas.TopProperty, 0);
            return p;
        }
    }

 　　上面定义了UserControl的高度和宽度，并将element赋值给Popup控件p。（这里建议的宽度是346或者646，高度应该是用户屏幕的完整高度，参考：设计指南）。最后，设置了popup的left 和top 属性，这样popup将会出现在适当的位置，然后将p返回给SettingsCommand。 
 　　注解：Windows 8可以根据机器的本地化设置而有不同的变化。如果有的国家的语言是从右往左读的，那么Charms  Bar的实际位置是在屏幕的左边，而不是右
边。这就是为什么我在给popup的LeftProperty赋值时，检查SettingsPane的“edge”。

4. 创建UserControl
　　添加一个新的UserControl项到工程中。为了跟之前的代码想匹配，我将其命名为AboutPage.xaml。这个文件中代码的内容完全取决于你。没有任何的官方文档约束。在UserControl中，可以通过在MainPage中定义一个共有字段public static MainPage Current来访问MainPage页面中控件，实现对页面里面控件的属性进行修改。

 

 如需源代码，点击SettingPanel.zip下载