在Winform界面使用自定義用戶控制項及TabelPanel和StackPanel佈局控制項

来源:https://www.cnblogs.com/wuhuacong/archive/2020/01/17/12201665.html

在很多時候,我們做一些非常規化的界面的時候,往往需要創建一些用戶控制項,在其中繪製好一些基礎的界面塊,作為後續重覆使用的一個單元,用戶控制項同時也可以封裝處理一些簡單的邏輯。在開發Winform各種類型項目,我都時不時需要定製一些特殊的用戶控制項,以方便在界面模塊中反覆使用。我們一般是在自定義的用戶控制項里... ...


在很多時候,我們做一些非常規化的界面的時候,往往需要創建一些用戶控制項,在其中繪製好一些基礎的界面塊,作為後續重覆使用的一個單元,用戶控制項同時也可以封裝處理一些簡單的邏輯。在開發Winform各種類型項目,我都時不時需要定製一些特殊的用戶控制項,以方便在界面模塊中反覆使用。我們一般是在自定義的用戶控制項裡面,添加各種各樣的界面控制項元素,或者封裝一些特殊的函數處理共外部調用等。本篇隨筆主要介紹基於DevExpress的Winform開發經驗,介紹一個類似看板信息的用戶控制項,併在TabelLayout和StackLayout佈局控制項中進行展示。

1、用戶控制項界面的處理

 在偶爾的一個場合下,看到一個牙醫管家的軟體界面做的非常不錯,其中有一個預約列表的界面感覺非常好,如下界面所示。

 

 其中它的每個用戶信息列表裡面,都是一個綜合信息的展示,非常直觀,估計應該是用戶自定義控制項做的。

在其中裡面,有不同的字體,各式圖標,以及內容的信息展示, 這個我在DevExpress的列表控制項裡面,沒有看到可以如此定義列表內容的,在DevExpress的GridView裡面有一個看板模板的定義有點接近,但是試了一下,可調性不好,於是放棄尋求其他接近方案,玩遍DevExpress的控制項後,發現最好的方式應該是自定義用戶控制項的方式來解決這個界面問題。

花了一點時間,製作了一個用戶控制項,在其中添加一個LayoutControl方便控制佈局,添加一些標簽以及設置了一些圖標,得到下圖所示。

 

  左側的顏色條由於使用Group控制項,因此寬度暫時無法調整,如果介意大小,我們可以在其中在創建一個LayoutControl,然後在其中方式內容即可。

我們改變佈局,然後添加一個顏色塊,得到類似界面如下所示。

 

我們來定義一下用戶控制項的源碼部分,修改其中源碼,增加對應的屬性,方便動態設置用戶控制項的相關屬性,如顏色塊,項目背景色,以及綁定的對象信息等內容。

 

 然後在界面載入完畢後,設置對應的信息和顏色信息,如下代碼所示。

        /// <summary>
        /// 視窗載入事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void UserItemControl_Load(object sender, EventArgs e)
        {
            BindData();
            RefreshColor();
        }

        /// <summary>
        /// 根據用戶定義信息,顯示不同的內容
        /// </summary>
        private void BindData()
        {
            if(this.UserItemInfo != null)
            {
                var info = this.UserItemInfo;
                this.lblCustomerName.Text = info.CustomerName;
                this.lblMobile.Text = info.Mobile;
                this.lblReceiver.Text = info.Receiver;
                this.lblRecordDate.Text = info.RecordDate;
                this.lblRecordNo.Text = info.RecordNo;
                this.lblDealType.Text = "";
                this.lblStar.ImageOptions.ImageIndex = GetStarImageIndex(info.Stars);
                if (!info.IsVip)
                {
                    this.lblVip.Visibility = LayoutVisibility.Never;
                }
            }
        }

        /// <summary>
        /// 刷新背景色
        /// </summary>
        private void RefreshColor()
        {
            if (ItemBlockColor != Color.Empty)
            {
                this.itemColor.AppearanceItemCaption.BackColor = ItemBlockColor;
            }
            if (ItemBackColor != Color.Empty)
            {
                layoutControl1.BackColor = ItemBackColor;
            }
        }

但我們滑鼠浮動在項目上或者離開的時候,或者單擊某項的時候,我們變換下顏色,方便區分顯示。

        private void layoutControl1_MouseLeave(object sender, EventArgs e)
        {
            if (!this.IsSelected)
            {
                this.layoutControl1.ResetBackColor();
            }
        }

        private void layoutControl1_MouseEnter(object sender, EventArgs e)
        {
            if (!this.IsSelected)
                this.layoutControl1.BackColor = Color.FromArgb(192, 255, 192);
        }

        private void layoutControl1_Click(object sender, EventArgs e)
        {
            this.IsSelected = true;
            OnItemClick?.Invoke(this, e);
        }

完成這些後,我們需要在窗體上對內容進行初始化。

最後我們看看界面的效果如下所示

 或者下麵這樣的界面佈局。

如果嫌棄邊框紅色不好看,我們 可以修改邊框為灰色調一點的,這樣總體看起來效果如下所示。

 

 得到和我們最終需要的界面很接近了。

一般除了懸浮滑鼠顏色變化外,控制項單擊後,我們會設置不同的背景色,以示區分。

        /// <summary>
        /// 是否選中節點
        /// </summary>
        public bool IsSelected
        {
            get
            {
                return m_IsSelected;
            }
            set
            {
                m_IsSelected = value;

                this.ItemBackColor = value ? Color.FromArgb(255, 255, 192) : Color.Transparent;
                this.RefreshColor();
            }
        }

一般列表界面中,我們除了支持滑鼠移動、單擊變色的效果外,我們還希望支持通過鍵盤箭頭上下鍵進行上下瀏覽項目。我們如果需要使用鍵盤的按鍵,需要設置窗體的KeyPreview屬性為True,

然後跟蹤按鍵的事件即可,如下所示。

            this.KeyPreview = true;
            this.KeyUp += FrmKanBan_KeyUp;

按鍵事件捕捉處理如下所示,主要就是判斷選中的用戶控制項,並對面板的子控制項的選中效果進行處理。

        private void FrmKanBan_KeyUp(object sender, KeyEventArgs e)
        {
            //單擊滑鼠或者切換按鍵,會觸發用戶控制項獲得selectItem對象,可以進行箭頭上下移動
            if (selectItem != null)
            {
                var panel = selectItem.Parent;
                if (panel != null)
                {
                    //獲取操作項的索引值
                    int oldIndex = panel.Controls.IndexOf(selectItem);
                    if (e.KeyCode == Keys.Up)
                    {
                        if (oldIndex > 0)
                        {
                            //通過序號獲得新的控制項,並單擊它觸發選擇事件
                            var newCtrl = panel.Controls[oldIndex - 1];
                            Item_OnItemClick(newCtrl, new EventArgs());
                        }
                    }
                    else if (e.KeyCode == Keys.Down)
                    {
                        if (oldIndex < (panel.Controls.Count - 1))
                        {
                            //通過序號獲得新的控制項,並單擊它觸發選擇事件
                            var newCtrl = panel.Controls[oldIndex + 1];
                            Item_OnItemClick(newCtrl, new EventArgs());
                        }
                    }
                }
            }
        }

界面中用戶控制項的切換選中效果,需要先清空之前所有的選擇,然後在設置新的選中控制項,所以還需要對控制項觸發單擊事件進行處理,如下所示。

        /// <summary>
        /// 選中的用戶控制項對象實例
        /// </summary>
        UserItemControl selectItem = null;
        /// <summary>
        /// 單擊用戶控制項,觸發清除所有標記後,再次設置選中的項目標記
        /// </summary>
        private void Item_OnItemClick(object sender, EventArgs e)
        {
            //清空所有控制項的選中標記
            var panel = (PanelControl)((Control)sender).Parent;
            foreach (Control ctrl in panel.Controls)
            {
                var item = ctrl as UserItemControl;
                if(item != null)
                {
                    item.IsSelected = false;
                }
            }

            //設置選中控制項
            selectItem = ((UserItemControl)sender);
            selectItem.IsSelected = true;
            this.Text = selectItem.UserItemInfo.CustomerName + "-選中";

            //如果在面板中遮擋,移動滾動條,可以查看到完整用戶控制項界面
            panel.ScrollControlIntoView(selectItem);
        }

如下效果所示。

 

2、TabelLayout和StackLayout佈局控制項的介紹和使用

 我們在做Winform開發的時候,一般知道,微軟傳統Winform的佈局提供兩個控制項,FlowLayoutPanel和TableLayoutPanel,一個是流式佈局,一個是表格佈局,各有各的用處。流式佈局主要就是按照順序挨個放置控制項,表格佈局主要按照表格的定義的行列單元格,嚴格放置控制項,表格單元格控制強度更大,而且控制項具有拉伸效果。

對於DevExpress,我們一般還是傾向於採用它提供給的控制項來做界面,可以很好融合它的皮膚效果,相對於Winform傳統兩個佈局控制項,DevExpress提供了兩個封裝效果相當的控制項佈局StackPanel和 TablePanel,他們的效果實現大同效果,不過調用的介面不同。

 

 對於兩個控制項,我們希望裡面的內容自動出現滾動條,那麼設置屬性AutoScroll 為True即可,如下代碼所示。

panel.AutoScroll = true;

而StackPanel另外需要LayoutDirection,也就是控制項順序展現的方式,如下代碼所示。

panel.LayoutDirection = StackPanelLayoutDirection.TopDown;

使用StackPanel面板來測試展示用戶控制項列表的界面代碼如下所示。

        /// <summary>
        /// 使用StackPanel對用戶控制項佈局進行處理
        /// </summary>
        private void InitPanel(StackPanel panel)
        {
            panel.AutoScroll = true;//面板自動出現滾動條
            panel.LayoutDirection = StackPanelLayoutDirection.TopDown;//從上往下展示
            panel.Controls.Clear();//清空界面

            var list = GetInfoList(); //獲取用戶控制項綁定的對象信息列表
            for (int i = 0; i < list.Count; i++)
            {
                //定義用戶控制項實例
                var item = new UserItemControl();
                item.UserItemInfo = list[i];//綁定對象信息

                item.Anchor = AnchorStyles.Top | AnchorStyles.Left | AnchorStyles.Right;
                item.ItemBlockColor = colors[i %10]; //變化顏色
                item.OnItemClick += Item_OnItemClick;//觸發選中事件

                panel.Controls.Add(item);
            }
        }

對於表格佈局TablePanel控制項來說,使用初始化控制項的方式也差不多,不過有個別地方註意即可。

        /// <summary>
        /// 使用TablePanel對用戶控制項佈局進行處理
        /// </summary>
        private void InitPanel(TablePanel panel)
        {
            panel.AutoScroll = true;//面板自動出現滾動條
            panel.Controls.Clear();//清空界面
            panel.Rows.Clear();//清空行
            panel.Columns.Clear();//清空列

            //添加列定義(增加一個列即可)
            panel.Columns.Add(new TablePanelColumn(TablePanelEntityStyle.Relative, 55F));
            var list = GetInfoList(); //獲取用戶控制項綁定的對象信息列表
            for (int i = 0; i < list.Count; i++)
            {
                //定義行信息
                panel.Rows.Add(new TablePanelRow(TablePanelEntityStyle.AutoSize, 100F));

                //定義用戶控制項實例
                var item = new UserItemControl();
                item.UserItemInfo = list[i];
                //定義拉伸效果
                item.Anchor = AnchorStyles.Top | AnchorStyles.Left | AnchorStyles.Right;
                item.ItemBlockColor = colors[i % 10]; //變化顏色
                item.OnItemClick += Item_OnItemClick;//觸發選中事件

                //先添加控制項到面板集合中
                panel.Controls.Add(item);
                //設置控制項的單元格位置
                panel.SetCell(item, i, 0);
            }

            //添加多一行,確保佈局
            panel.Rows.Add(new TablePanelRow(TablePanelEntityStyle.AutoSize, 100F));
        }

添加控制項的時候,需要註意下麵的代碼,才能正常展示控制項信息,否則無法看到用戶控制項。

                //先添加控制項到面板集合中
                panel.Controls.Add(item);
                //設置控制項的單元格位置
                panel.SetCell(item, i, 0);

最後對比下效果,左邊是TablePanel,右邊是StackPanel展現出來的效果。

 

 以上就是界面如何在DevExpress開發中使用各種用戶控制項進行用戶控制項的創建、以及實現滑鼠進入、移出、單擊的不同效果,以及實現鍵盤上下箭頭按鍵的事件選中效果,並介紹DevExpress中兩個佈局控制項TabelPanel和StackPanel的正常使用,達到展示控制項信息的作用。


您的分享是我們最大的動力!

更多相關文章
  • 這幾天,對程式重構,主要針對angularjs的綁定: 第一個例子: 下麵是一段html程式: 不管是name或者是ng-model的屬性值,它都有一定規律"StartX"和"EndX" 後面的數字是連續的序號。 我們可以使用ASP.NET MVC的Razor的語法@for來簡化它們: @{ for ...
  • C#實現的Check Password,並根據輸錯密碼的次數分情況鎖定賬戶:如果輸入錯誤3次,登錄賬戶鎖定5分鐘並提示X點X分後重試登錄。如果5分鐘後再次輸入,累計輸入錯誤密碼累計達到5次。則賬戶會被永久鎖定,需聯繫系統管理員進行把資料庫中的輸入錯誤的次數(errorcount)進行清零解鎖才能登陸 ...
  • [TOC] MVC "MVC 維基百科,自由的百科全書" MVC 是軟體工程的一種軟體架構模式,它不是具體的技術,而是一種代碼分層的理念,主要體現了職責分離原則。 M Model 模型 V View 視圖 C Controller 控制器 對 MVC 的誤解及緣由 誤解:頁面視圖 = View ,E ...
  • 簡介 Orleans用起來的確很爽,更爽的是咱們有能監控它的工具。 " OrleansDashboard " 這個工具是一個可視化的Silo監控工具,Silo和Grain的活躍狀態一目瞭然,各個介面的響應速度也可以很清晰的統計到。 安裝 使用NuGet引用 然後修改 的配置,添加Dashboard: ...
  • Teigha中實體旋轉 代碼: using (var trans = database.TransactionManager.StartTransaction()) { Entity ent = trans.GetObject(entityId, OpenMode.ForWrite) asEntit ...
  • 什麼是AutoMapper?AutoMapper是一個簡單的小型庫,用於解決一個看似複雜的問題 - 擺脫將一個對象映射到另一個對象的代碼。這種類型的代碼是相當沉悶和無聊的寫,所以為什麼不發明一個工具來為我們做? 我們來看看在.netcore3.1中怎樣使用AutoMapper9.0。 Profile ...
  • 程式處理存放圖片的幾種方式 我的理解有4個: 1:放在項目本身得文件夾中,直接部署到伺服器上 2:存放在磁碟中,然後資料庫中存放路徑,讀取得時候傳路徑。這個適合小項目 3:將圖片轉換成二進位文件,但是不建議這樣做,因為會給資料庫造成壓力。 4:存放在雲存儲器上,也是在資料庫上存地址,不過是雲地址,使 ...
  • 第一部分:面向對象 封裝 繼承(里氏轉換) 多態第二部分:值類型、引用類型、字元串操作第三部分:集合文件操作第四部分:正則表達式第五部分:XML操作第六部分:委托、事件第七部分:反射。 //存儲著我們當前正在運行的進程//Process[] pro = Process.GetProcesses(); ...
一周排行
  • 比如要拆分“呵呵呵90909086676喝喝999”,下麵當type=0返回的是中文字元串“呵呵呵,喝喝”,type=1返回的是數字字元串“90909086676,999”, private string GetStrings(string str,int type=0) { IList<strin ...
  • Swagger一個優秀的Api介面文檔生成工具。Swagger可以可以動態生成Api介面文檔,有效的降低前後端人員關於Api介面的溝通成本,促進項目高效開發。 1、使用NuGet安裝最新的包:Swashbuckle.AspNetCore。 2、編輯項目文件(NetCoreTemplate.Web.c ...
  • 2020 年 7 月 30 日, 由.NET基金會和微軟 將舉辦一個線上和為期一天的活動,包括 微軟 .NET 團隊的演講者以及社區的演講者。本次線上大會 專註.NET框架構建微服務,演講者分享構建和部署雲原生應用程式的最佳實踐、模式、提示和技巧。有關更多信息和隨時瞭解情況:https://focu... ...
  • #abp框架Excel導出——基於vue #1.技術棧 ##1.1 前端採用vue,官方提供 UI套件用的是iview ##1.2 後臺是abp——aspnetboilerplate 即abp v1,https://github.com/aspnetboilerplate/aspnetboilerp ...
  • 前言 本文的文字及圖片來源於網路,僅供學習、交流使用,不具有任何商業用途,版權歸原作者所有,如有問題請及時聯繫我們以作處理。 作者:碧茂大數據 PS:如有需要Python學習資料的小伙伴可以加下方的群去找免費管理員領取 input()輸入 Python提供了 input() 內置函數從標準輸入讀入一 ...
  • 從12年到20年,python以肉眼可見的趨勢超過了java,成為了當今It界人人皆知的編程語言。 python為什麼這麼火? 網路編程語言搜索指數 適合初學者 Python具有語法簡單、語句清晰的特點,這就讓初學者在學習階段可以把精力集中在編程對象和思維方法上。 大佬都在用 Google,YouT ...
  • 在社會上存在一種普遍的對培訓機構的學生一種歧視的現象,具體表現在,比如:當你去公司面試的時候,一旦你說了你是培訓機構出來的,那麼基本上你就涼了,那麼你瞞著不說,然後又通過了面試成功入職,但是以後一旦在公司被髮現有培訓經歷,可能會面臨被降薪,甚至被辭退,培訓機構出來的學生,在用人單位眼裡就是能力低下的 ...
  • from typing import List# 這道題看了大佬寫的代碼,經過自己的理解寫出來了。# 從最外圍的四周找有沒有為O的,如果有的話就進入深搜函數,然後深搜遍歷# 判斷上下左右的位置是否為Oclass Solution: def solve(self, board: List[List[s ...
  • import requests; import re; import os; # 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, li ...
  • import requests; import re; import os; import parsel; 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537. ...