使用C#語言實現的查詢條件界面展開/收起方案

先簡單說一下應用場景，現有一個C#客戶端的查詢界面，上方放置查詢條件，下方放置查詢結果。由於實際狀況中查詢條件可能佔了好幾行的位置，因此但願在界面上默認只保留一行最主要的查詢條件，並在右側有一個「展開/收起」功能。

收起時界面：

展開時界面：

最開始個人實現方式是這樣的，在界面上放置一個LinkLabel，設置此LinkLabel的鼠標單擊事件，調整查詢條件所在Panel的Height屬性。

C#代碼以下：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace SatyrAndNymph
{
    public partial class FormMethod1 : Form
    {
        //收起狀態時Panel高度
        private const int HeightWhenFold = 50;
        //收起狀態時LinkLabel顯示文字
        private const string DescriptionWhenFold = "展開";
        //展開狀態時Panel高度
        private const int HeightWhenExpand = 85;
        //展開狀態時LinkLabel顯示文字
        private const string DescriptionWhenExpand = "收起";

        /// <summary>
        /// 窗體構造函數
        /// </summary>
        public FormMethod1()
        {
            InitializeComponent();
            //構造函數後將Panel調整爲收起狀態
            lnkControlHeight.Text = DescriptionWhenFold;
            pnlQueryConds.Height = HeightWhenFold;
        }

        /// <summary>
        /// LinkLabel單擊事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void lnkControlHeight_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
        {
            //根據顯示文字爲展開/收起，調整Panel的高度及LinkLabel展現文字
            if (lnkControlHeight.Text == DescriptionWhenFold)
            {
                lnkControlHeight.Text = DescriptionWhenExpand;
                pnlQueryConds.Height = HeightWhenExpand;
            }
            else if (lnkControlHeight.Text == DescriptionWhenExpand)
            {
                lnkControlHeight.Text = DescriptionWhenFold;
                pnlQueryConds.Height = HeightWhenFold;
            }
        }
    }
}

不過我認爲這樣處理仍是不夠完美：每次使用都須要專門建立一個LinkLabel，而且每一個頁面的代碼都不同，由於父容器的標識符是不同的。

爲了解決這兩個問題，我設計了一個自定義控件以方便後續的開發工做。

控件名爲HeightController，界面以下：

自定義控件中只包含一個LinkLabel，AutoSize屬性被設置爲False，Dock屬性被設置爲Full，TextAlign屬性被設置爲MiddleLeft。

C#代碼以下：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace SatyrAndNymph
{
    /// <summary>
    /// 展開/收起控制器
    /// </summary>
    public partial class HeightController : UserControl
    {
        /// <summary>
        /// 展開/收起控制器
        /// </summary>
        public HeightController()
        {
            InitializeComponent();
        }

        private void HeightController_Load(object sender, EventArgs e)
        {
            //設計器模式時，不觸發展開/收起，不然會對設計工做形成干擾
            if (!this.DesignMode)
            {
                //調整展開/收起狀況
                if (ControllerStatus == ControllerStatusEnum.FOLD)
                {
                    Fold();
                }
                else if (ControllerStatus == ControllerStatusEnum.EXPAND)
                {
                    Expand();
                }
            }
        }

        /// <summary>
        /// 控制器狀態
        /// </summary>
        private ControllerStatusEnum _controllerStatus = ControllerStatusEnum.FOLD;

        ///<summary>
        /// 控制器狀態
        ///</summary>
        [System.ComponentModel.Description("控制器狀態")]
        public ControllerStatusEnum ControllerStatus
        {
            get
            {
                return _controllerStatus;
            }
            set
            {
                _controllerStatus = value;
            }
        }

        /// <summary>
        /// 父容器展開
        /// </summary>
        public void Expand()
        {
            ControllerStatus = ControllerStatusEnum.EXPAND;
            if (this.Parent != null)
            {
                this.Parent.Height = HeightWhenExpand;
            }
            this.lnkHeightController.Text = DescriptionWhenExpand;
        }

        /// <summary>
        /// 父容器收起
        /// </summary>
        public void Fold()
        {
            ControllerStatus = ControllerStatusEnum.FOLD;
            if (this.Parent != null)
            {
                this.Parent.Height = HeightWhenFold;
            }
            this.lnkHeightController.Text = DescriptionWhenFold;
        }

        /// <summary>
        /// 收起時高度
        /// </summary>
        private int _heightWhenFold = 50;

        ///<summary>
        /// 收起時高度
        ///</summary>
        [DefaultValue(50)]
        [System.ComponentModel.Description("收起時高度")]
        public int HeightWhenFold
        {
            get
            {
                return _heightWhenFold;
            }
            set
            {
                _heightWhenFold = value;
            }
        }

        /// <summary>
        /// 收起時顯示文字
        /// </summary>
        private string _descriptionWhenFold = "展開";

        ///<summary>
        /// 收起時顯示文字
        ///</summary>
        [System.ComponentModel.Description("收起時顯示文字")]
        public string DescriptionWhenFold
        {
            get
            {
                return _descriptionWhenFold;
            }
            set
            {
                _descriptionWhenFold = value;
            }
        }

        /// <summary>
        /// 展開時高度
        /// </summary>
        private int _heightWhenExpand = 85;

        ///<summary>
        /// 展開時高度
        ///</summary>
        [DefaultValue(85)]
        [System.ComponentModel.Description("展開時高度")]
        public int HeightWhenExpand
        {
            get
            {
                return _heightWhenExpand;
            }
            set
            {
                _heightWhenExpand = value;
            }
        }

        /// <summary>
        /// 展開時顯示文字
        /// </summary>
        private string _descriptionWhenExpand = "收起";

        ///<summary>
        /// 展開時顯示文字
        ///</summary>
        [System.ComponentModel.Description("展開時顯示文字")]
        public string DescriptionWhenExpand
        {
            get
            {
                return _descriptionWhenExpand;
            }
            set
            {
                _descriptionWhenExpand = value;
            }
        }

        /// <summary>
        /// 點擊LinkLabel文字
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void lnkHeightController_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
        {
            if (this.Parent != null)
            {
                int height = this.Parent.Height;
                //根據父容器高度判斷父容器應是收起仍是展開
                if (ControllerStatus == ControllerStatusEnum.FOLD)
                {
                    Expand();
                }
                else
                {
                    Fold();
                }
            }
        }

    }
}

使用此控件時，直接將此控件拖入要改變高度的Panel或其餘容器便可。

使用前須要先在控件屬性中設置好以下5項內容：

各屬性說明以下：

一、ControllerStatus，是一個枚舉，包含EXPAND和FOLD兩種選擇，決定窗體打開時查詢條件是展開或是收起的。

二、DescriptionWhenExpand，當查詢條件區域處於展開狀態時，控制器展現的文字

三、DescriptionWhenFold，當查詢條件區域處於收起狀態時，控制器展現的文字

四、HeightWhenExpand，查詢條件區域處於展開狀態時高度

五、HeightWhenFold，查詢條件區域處於收起狀態時高度

HeightController控件使用效果以下：

收起時界面：

展開時界面：

DEMO程序下載地址：https://pan.baidu.com/s/1bLQ9jC

END