5

DevExpress的WidgetView的使用介绍

 3 years ago
source link: https://www.cnblogs.com/wuhuacong/p/13602764.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

很多程序可能都会有一个首页综合展示系统的相关信息，如汇总信息，图表统计、待办业务、提醒信息等内容，在Web上可能叫做Dashboard仪表板，或者首页页面，不管哪种叫法，都是综合展示一些信息，提供一些信息展示或者处理工作的入口，我们在Winform里面，有时候也需要这样的仪表板首页，这个使用DevExpress的控件组的话，可以使用WidgetView控件来实现。

1、DevExpress默认案例

DevExpress的Demo样例提供了一些WidgetView的样式，如下所示。

8867-20200902195222014-413582788.png

 

8867-20200902195615412-2132538568.png
8867-20200902171000089-1732365931.png

通过上面的案例，我们可以看到，利用WidgetView可以创建很丰富的汇总、报表、待办等相关内容，只要处理得当，可以为我们的Dashboard首页提供很丰富的综合内容展示。

2、WidgetView的使用介绍

WidgetView的使用，如果要较好掌握它的使用，需要了解DocumentManager、WidgetView、Document、StackGroup的概念是什么，以及它们之间的关系。

我们可以通过窗体的设计器来创建一个DocumentManager，其中DocumentManager里面包含一个WidgetView，用来做视图管理的；然后在设计模式上创建多个对应的Document，而Document是用来管理对应展示的内容的（如自定义用户控件），StackGroup等是用来管理Document布局展示的，除了StackLayout外，可以通过WidgetView的LayoutMode属性设置其他布局类型，如Table Layout, Flow Layout 以及 Free Layout等。如下是在设计模式下创建几个空白的Document以及使用的LayoutMode 为StackLayout来排版Document的排列方式。

8867-20200902170614104-1061699318.png

如果需要在设计模式下维护WidgetView的一些内容，可以通过窗体下面的DocumentManager对象进行维护。

8867-20200902170655718-708954954.png

以上的Demo就是简单的创建几个空白的Document以及常规的StackLayout的方式排版，运行得到界面效果如下所示。 

8867-20200902170509217-448675058.png

一般实际情况下，我们是在首页上综合展示各种报表内容、图表内容、待办信息等内容的，那么各个模块的内容，可以使用自定义用户控件来处理，然后综合展示即可，实际情况下，首先我们先创建用户控件界面，以及实现好各个内容的展示；然后我们可以在设计模式下指定不同Document下容纳的控件信息，也可通过动态创建的方式创建所需要的内容。

以下是我使用代码动态构建的WidgetView界面，通过动态创建DocumentManager、Document，以及加载各种自定义用户控件，组合成下面的界面效果。 

8867-20200902170422272-2043270806.png

用户自定义控件界面，我们在Controls里面放置各种不同内容的用户控件，如下界面方案中的项目文件界面所示。 

8867-20200902170541284-696805924.png

动态创建WidgetView相关的内容比较简单，我这里把所有相关的代码一并贴出，方便了解。 

    /// <summary>
    /// 动态构建的Widget View
    /// </summary>
    public partial class FrmWidget2 : DevExpress.XtraEditors.XtraForm
    {
        public FrmWidget2()
        {
            InitializeComponent();
        }

        private void FrmWidget2_Load(object sender, EventArgs e)
        {
            AddDocumentManager();
        }

        WidgetView view;
        StackGroup group1, group2;
        void AddDocumentManager()
        {
            var docMananger = new DocumentManager(components);
            view = new WidgetView();
            docMananger.View = view;
            docMananger.ContainerControl = this;

            view.AllowDocumentStateChangeAnimation = DevExpress.Utils.DefaultBoolean.True;
            group1 = new StackGroup();
            group2 = new StackGroup();
            group1.Length.UnitType = LengthUnitType.Star;
            group1.Length.UnitValue = 2;
            view.StackGroups.AddRange(new StackGroup[] { group1, group2 });

            //添加文档
            AddDocuments();

            //设置布局显示
            view.LayoutMode = LayoutMode.StackLayout;
            view.DocumentSpacing = 3;

            //tableLayout的行列定义
            //构建每个文档所属的ColumnIndex和RowIndex
            this.view.Rows.Clear();
            this.view.Columns.Clear();
            List<Point> points = new List<Point>();
            for (int i = 0; i < 3; i++)
            {
                this.view.Rows.Add(new RowDefinition() { });
                for (int j = 0; j < 2; j++)
                {
                    this.view.Columns.Add( new ColumnDefinition());
                    points.Add(new Point(i, j));
                }
            }
            Random random = new Random();
            foreach (Document document in view.Documents)
            {
                Point newLocation = points[random.Next(points.Count)];
                document.RowIndex = newLocation.Y;
                document.ColumnIndex = newLocation.X;
                points.Remove(newLocation);
            }

            //添加 Document对象到group1不是必须的，因为所有新创建的文档都是默认放置到第一个StackGroup中.
            //group1.Items.AddRange(new Document[] { view.Documents[0] as Document, view.Documents[1] as Document });
            view.Controller.Dock(view.Documents[view.Documents.Count - 3] as Document, group2);
            view.Controller.Dock(view.Documents[view.Documents.Count - 2] as Document, group2);
            view.Controller.Dock(view.Documents[view.Documents.Count - 1] as Document, group2);
        }

        /// <summary>
        /// 动态添加用户控件作为Widget视图的文档内容
        /// </summary>
        void AddDocuments()
        {
            CreateDocument(typeof(Calendar), "日历控件", Color.Blue);
            CreateDocument(typeof(ToDoList), "待办列表4", Color.Yellow);
            CreateDocument(typeof(News), "消息信息", Color.Navy);
            CreateDocument(typeof(TodoControl), "待办控件", Color.Red);
            CreateDocument(typeof(MyDateControl), "日期控件", Color.Green);
            CreateDocument(typeof(Mail), "邮箱信息", Color.Purple);
        }
        /// <summary>
        /// 创建指定的文档
        /// </summary>
        /// <param name="controlType">文档用户控件对象类型</param>
        /// <param name="caption">标题</param>
        /// <param name="backColor">背景色</param>
        void CreateDocument(Type controlType, string caption, Color backColor)
        {
            //创建用户控件
            var control = Activator.CreateInstance(controlType) as Control;

            //创建指定的文档
            var document = view.AddDocument(control) as Document;
            document.Caption = caption;
            //背景色
            document.AppearanceCaption.BackColor = backColor;
        }
    }

以上就是DevExpress的WidgetView的各种相关内容的介绍，以及介绍在设计模式下、代码动态构建两种方式下的处理方式，希望对你了解这个特殊的控件有所帮助。

None.gif主要研究技术：代码生成工具、会员管理系统、客户关系管理软件、病人资料管理软件、Visio二次开发、酒店管理系统、仓库管理系统等共享软件开发
专注于Winform开发框架/混合式开发框架、Web开发框架、Bootstrap开发框架、微信门户开发框架的研究及应用。
  转载请注明出处：
None.gif撰写人：伍华聪  http://www.iqidi.com 

report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK