• 【原译】一个可定制的WPF任务对话框


    今天实在看WPF揭秘的时候看到TaskDialog这个控件的。然后就去找了一下开源的代码。在codeproject上发现了这个,非常给力。。另外codeproject改版后很漂亮哦。

    介绍:
    这是用WPF实现Vista上TaskDialog效果的代码。

    Messagbox消息框
    通过调用重写的静态Show方法。TaskDialog就会表现的像一个Messagebox。他有四个文本类型的属性:Header(头部), Content(内容), Detail(更多), 和 Footer(底部),其实Detail是一个折叠的区域, 而Header和Footer还有一个icon属性(HeaderIcon和FooterIcon),除此之外,Header还有Background(背景)和Foreground(前景)属性

    // TaskDialog.Show方法签名
    publicstaticTaskDialogResult Show(
        stringtitle,
        stringheader,
        stringcontent,
        stringdetail,
        stringfooter,
        TaskDialogButton button,
        TaskDialogResult defaultResult,
        TaskDialogIcon headerIcon,
        TaskDialogIcon footerIcon,
        Brush headerBackground,
        Brush headerForeground)
     
    // TaskDialog.Show 方法的一个例子
    TaskDialog.Show("Task Dialog 测试",
         "消息框的标题文字",
         "消息框的内容部分. "+
         " 可以自适应内容.",
         "消息框的细节部分 "+
         "可以自适应内容",
         "消息框的底部.",
         TaskDialogButton.Ok,
         TaskDialogResult.None,
         TaskDialogIcon.Information,
         TaskDialogIcon.Shield,
         Brushes.White,
         Brushes.Navy);

    定制TaskDialog
    使用静态的Show方法。Header, Content, Detail, 和Footer 就限制了只能传递字符串作为值了。
    为了定义这个对话框,你先创建TaskDialog类的一个对象,然后分别设置一下各个属性,最后调用Show方法就可以了

    // TaskDialog 实例化例子
    TaskDialog dialog=newTaskDialog();
    dialog.Title="TaskDialog example";
    dialog.HeaderIcon=TaskDialogIcon.Warning;
    dialog.SystemSound=TaskDialogSound.Exclamation;
    // header 属性设置
    dialog.Header="This is the Header.";
    dialog.HeaderBackground=Brushes.DarkGray;
    dialog.HeaderForeground=Brushes.White;
    // Content, Detail 和 Footer属性设置
    dialog.Content="This is the content";
    dialog.Detail="This is the detail";
    dialog.Footer="this is the Footer";
    dialog.Show();

    TaskDialog控件派生自HeaderedContentControl类,因为从HeaderedContentControl类可以获得Header和Content属性,TaskDialog仅仅是添加了Detail和Footer属性,这些属性是Object类型,并且有他们自己的template(模板)属性HeaderTemplate, ContentTemplate, DetailTemplate, 和 FooterTemplate),TaskDialog类对于文本内容有着缺省的数据模板,当然你也可以用那四个模板来替换,这样你就可以以你喜欢的任何方式来格式化文本了。下面这个图展示了通过斜体和下划线来格式化文本。


    图2

    //为上面这个图的content属性的 DataTemplate 模板
    <DataTemplatex:Key="_customContentDataTemplate">
       <TextBlock Text="{Binding Content,
            RelativeSource={RelativeSource FindAncestor,
                            AncestorType={x:Type Controls:TaskDialog}}}"
            FontStyle="Italic"
            TextDecorations="Underline"
            TextWrapping="Wrap"/>
    </DataTemplate>

    因为Header,Content,Detail和Footer是object类型,因此不再受到只能是文本的限制了,你可以防止你喜欢的任何类型到TaskDialog,下面这个例子中的TaskDialog是不是很像UAC的提示呢。这里Content属性是一个UserControl类型,放置了一个图片和一些文本还有两个CommandButtons(都是普通的按钮。。不过添加了一些定制的样式,再加了Header属性)


    图三

    一个模拟vista的文件拷贝窗口的TaskDialog。。


    图四

    额外的一些有意思的属性

    下面是TaskDialog暴露的属性列表(按字母表排序)
    Button1Text: string类型,当TaskDialogButton属性被设置为Custom的时候,用来设置按钮的文字
    Button2Text: 同上
    Button3Text: 同上
    DefaultResult: TaskDialogResult类型. 设置缺省的按钮
    IsButton1Enabled: bool类型. 获取或设置按钮的Enabled状态
    IsButton2Enabled: 同上
    IsButton3Enabled: 同上
    IsCloseButtonEnabled: bool类型. 获取或设置窗口关闭按钮的Enabled状态 (缺省为false)
    IsExpanded: bool类型,获取或是设置Detail部分的可见性。
    IsModal: bool类型,获取或是设置对话框是不是模态的
    ShowInTaskBar: bool类型,获取或是设置对话框是不是显示在任务栏中
    SystemSound: TaskDialogSound类型. 设置当对话框显示的时候播放的声音
    TaskDialogButton: TaskDialogButton类型. 显示在对话框上的按钮可以是None, Ok, OkCancel, YesNo, YesNoCancel, or Custom (查看上面提到的按钮设置)
    Title: string类型,对话框的标题
    ToggleButtonTexts: TaskDialogToggleButtonTexts提供了两个属性来设置toggle按钮的这个属性,当toggle 按钮折叠或是展开的时候 (缺省是’Show Details’ 和’Hide Details’).
    TopMost: 设置对话框是否置顶

    Demo

    下载TaskDialog例子,查看Window1.xaml中按钮的单击事件,来看TaskDialog是如何被创建的。。

    版权:本文,包括源代码和文件,在CPOL下授权。

    原文地址:A-Customizable-WPF-TaskDialog

    著作权声明:本文由http://leaver.me 翻译,欢迎转载分享。请尊重作者劳动,转载时保留该声明和作者博客链接,谢谢!

  • 相关阅读:
    HTML学习基础(一)
    初识C#
    SQL小知识
    jQuery(四)
    jQuery(三)
    认识jQuery(二)
    认识Jquery
    初识Javascript
    初识HTML
    博客,你好!
  • 原文地址:https://www.cnblogs.com/lazycoding/p/2697994.html
Copyright © 2020-2023  润新知