擴展DropDownList控件和ListBox控件(1) - 支持分組功能(optgroup標籤)

DropDownList(ListBox)控件既強大又好用。爲了讓它更強大、更好用，咱們來寫一個繼承自DropDownList(ListBox)的控件。
[×××]

擴展DropDownList控件和ListBox控件(1) - 支持分組功能(optgroup標籤)

做者： webabcd


介紹
擴展DropDownList控件和ListBox控件：
經過 DropDownList控件和ListBox控件的.Items.Add(ListItem item)方法，來爲其添加optgroup標籤，從而實現分組功能


使用方法
一、設置屬性：
OptionGroupValue - 用於添加DropDownList(ListBox)控件的分組項的ListItem的Value值（默認爲optgroup）
二、使用DropDownList(ListBox)控件的.Items.Add(ListItem item)方法：
OptionGroupValue爲默認值時：SmartDropDownList.Items.Add(new ListItem("中國", "optgroup"));


圖示

 

 

關鍵代碼（以DropDownList爲例）
SmartDropDownList.cs

using System;
using System.Collections.Generic;
using System.Text;

using System.Web.UI.WebControls;
using System.Web.UI;

[assembly: System.Web.UI.WebResource( "YYControls.SmartDropDownList.Resources.Icon.bmp", "p_w_picpath/bmp")]

namespace YYControls
{
         /// <summary>
         /// SmartDropDownList類，繼承自DropDownList
         /// </summary>
        [ToolboxData( @"<{0}:SmartDropDownList runat='server'></{0}:SmartDropDownList>")]
        [System.Drawing.ToolboxBitmap( typeof(YYControls.Resources.Icon), "SmartDropDownList.bmp")]
         public partial class SmartDropDownList : DropDownList
        {
                 /// <summary>
                 /// 構造函數
                 /// </summary>
                 public SmartDropDownList()
                {

                }

                 /// <summary>
                 /// 將控件的內容呈現到指定的編寫器中
                 /// </summary>
                 /// <param name="writer">writer</param>
                 protected override void RenderContents(HtmlTextWriter writer)    
                {
                         // 呈現Option或OptionGroup
                        OptionGroupRenderContents(writer);
                }
        }
}

 

Property.cs

using System;
using System.Collections.Generic;
using System.Text;

using System.ComponentModel;
using System.Web.UI;

namespace YYControls
{
         /// <summary>
         /// SmartDropDownList類的屬性部分
         /// </summary>
         public partial class SmartDropDownList
        {
                 /// <summary>
                 /// 用於添加SmartDropDownList的分組項的ListItem的Value值
                 /// </summary>
                [
                Browsable( true),
                Description( "用於添加DropDownList的分組項的ListItem的Value值"),
                Category( "擴展")
                ]
                 public virtual string OptionGroupValue
                {
                        get
                        {
                                 string s = ( string)ViewState[ "OptionGroupValue"];

                                 return (s == null) ? "optgroup" : s;
                        }
                        set
                        {
                                ViewState[ "OptionGroupValue"] = value;
                        }
                }
        }
}

 

OptionGroup.cs

using System;
using System.Collections.Generic;
using System.Text;

using System.Data;
using System.Web.UI.WebControls;
using System.Web.UI;
using System.Web;

namespace YYControls
{
         /// <summary>
         /// SmartDropDownList類的屬性部分
         /// </summary>
         public partial class SmartDropDownList
        {
                 /// <summary>
                 /// 呈現Option或OptionGroup
                 /// </summary>
                 /// <param name="writer">writer</param>
                 private void OptionGroupRenderContents(HtmlTextWriter writer)
                {
                         // 是否須要呈現OptionGroup的EndTag
                         bool writerEndTag = false;

                         foreach (ListItem li in this.Items)
                        {
                                 // 若是沒有optgroup屬性則呈現Option
                                 if (li.Value != this.OptionGroupValue)
                                {
                                         // 呈現Option
                                        RenderListItem(li, writer);
                                }
                                 // 若是有optgroup屬性則呈現OptionGroup
                                 else
                                {
                                         if (writerEndTag)
                                                 // 呈現OptionGroup的EndTag
                                                OptionGroupEndTag(writer);
                                         else
                                                writerEndTag = true;

                                         // 呈現OptionGroup的BeginTag
                                        OptionGroupBeginTag(li, writer);
                                }
                        }

                         if (writerEndTag)
                                 // 呈現OptionGroup的EndTag
                                OptionGroupEndTag(writer);
                }

                 /// <summary>
                 /// 呈現OptionGroup的BeginTag
                 /// </summary>
                 /// <param name="li">OptionGroup數據項</param>
                 /// <param name="writer">writer</param>
                 private void OptionGroupBeginTag(ListItem li, HtmlTextWriter writer)
                {
                        writer.WriteBeginTag( "optgroup");
                        
                         // 寫入OptionGroup的label
                        writer.WriteAttribute( "label", li.Text);

                         foreach ( string key in li.Attributes.Keys)
                        {
                                 // 寫入OptionGroup的其它屬性
                                writer.WriteAttribute(key, li.Attributes[key]);
                        }

                        writer.Write(HtmlTextWriter.TagRightChar);
                        writer.WriteLine();
                }

                 /// <summary>
                 /// 呈現OptionGroup的EndTag
                 /// </summary>
                 /// <param name="writer">writer</param>
                 private void OptionGroupEndTag(HtmlTextWriter writer)
                {
                        writer.WriteEndTag( "optgroup");
                        writer.WriteLine();
                }

                 /// <summary>
                 /// 呈現Option
                 /// </summary>
                 /// <param name="li">Option數據項</param>
                 /// <param name="writer">writer</param>
                 private void RenderListItem(ListItem li, HtmlTextWriter writer)
                {
                        writer.WriteBeginTag( "option");

                         // 寫入Option的Value
                        writer.WriteAttribute( "value", li.Value, true);

                         if (li.Selected)
                        {
                                 // 若是該Option被選中則寫入selected
                                writer.WriteAttribute( "selected", "selected", false);
                        }

                         foreach ( string key in li.Attributes.Keys)
                        {
                                 // 寫入Option的其它屬性
                                writer.WriteAttribute(key, li.Attributes[key]);
                        }

                        writer.Write(HtmlTextWriter.TagRightChar);

                         // 寫入Option的Text
                        HttpUtility.HtmlEncode(li.Text, writer);

                        writer.WriteEndTag( "option");
                        writer.WriteLine();
                }
        }
}

 

OK
[×××]