.Text中的Advanced Panel学习笔记

.Text中的用户文章管理界面是使用Advanced Panel的主要界面。Advanced Panel与普通WebPanel相比，多提供一个Header栏，并且可以不使用任何代码实现折叠[Collapsing]功能，这是该控件最有特色的地方。

控件常用属性
1. Collapsible属性
    该属性为bool型，如果为true，该控件会在右侧显示一个折叠按钮，用于显示或隐藏Panel所包含的内容。否则不显示按钮，该控件变为不可折叠的panel。
2. Collapsed属性
    该属性为bool型，默认值为false，初始化时会显示panel容器中的所有内容；如果为true，初始化时，panel容器中的内容不会显示出来。如果为true，显示效果如下：

[图1]
图中，只能看到Panel的Header，但看不到Panel具体内容，只有点击右侧的折叠切换按钮才可以看到。
3. LinkBeforeHeader属性
    该属性为bool型，默认值为false。如果为false，右面的折叠按钮会显示在Header的右下方，效果如图2

[图2]
    如果为true，则像图1一样显示折叠按钮
4. HeaderText属性
    该属性为string型，用于设置Header标题的内容，例如图2中的HeaderText的值为Edit Post
5. LinkImageCollapsed属性
    该属性为string型，用于设置折叠按钮处于“折叠”状态的图片路径。
6. LinkImage属性
    该属性为string型，用于设置折叠按钮处于“展开”状态的图片路径。
7. BodyCssClass属性
    该属性为string型，用于设置内容显示区的样式。注意，由于内容显示区的实际上是一个div层，设置的样式要符合<div>的属性，不要出现不能设置的属性。.Text中的BodyCssClass="Edit"，设置如下：
   

div.Edit   {} {
    color: #333333;
    border-bottom: 1px solid #AAAAAA;
    margin-bottom: 8px;
    padding: 4px 12px;
    background: #f5f5f5;
}

当然你也可以设置一些其他属性如border-top[上边框], border-left [左边框], border-right[右边框]等。
8. DisplayHeader属性
    该属性为bool型，用于设置是否显示Header栏
9. HeaderCssClass属性
    该属性为string型，用于设置Header的样式。.Text中，HeaderCssClass="CollapsibleTitle"，设置如下：

div.CollapsibleTitle  {} {
    font-size: 105%;
    background: #E5E5E5;
    border-top: 1px solid #AAAAAA;
    border-bottom: 1px dashed #AAAAAA;
    font-weight: bold;
    color: #333333;
    width: auto;
    padding: 2px 12px;
    margin: 12px 0px 0px 0px;
    clear: left;
}

其中我们可以看到border-top: solid，即上边框为实线，border-bottom: dashed，即下边框为虚线。

控件技术分析
1. Panel原理
    Panel本身其实就是一个div层，不管是VS自带的WebPanel还是Advanced Panel都是如此。
2. 折叠效果实现
    折叠按钮是一个关键，在最后生成的html代码中我们可以看到这样的代码：

< a  id ="Edit_Link"  onclick ="ToggleVisible('Edit_Contents','Edit_LinkImage','image/toggle_gray_up.gif','image/toggle_gray_down.gif'); return false;"  href ="#" >
< img  id ="Edit_LinkImage"  src ="image/toggle_gray_down.gif"  alt =""  border ="0"   />
</ a >

    超链接标签中onclick被重载，一旦按钮按下，调用ToggleVisible()函数。 让我们来看看ToggleVisible函数的实现：

function  ToggleVisible(targetID, imageID, linkImage, linkImageCollapsed)
{
     if  (document.getElementById){
          target  =  document.getElementById(targetID);
           if  (target.style.display  ==   " none " ) {
              target.style.display  =   "" ;
          }  else  {
              target.style.display  =   " none " ;
          }
          
           if  (linkImageCollapsed  !=   "" ) {
              image  =  document.getElementById(imageID);
               if  (target.style.display  ==   " none " ) {
                  image.src  =  linkImageCollapsed;
              }  else  {
                  image.src  =  linkImage;
              }
          }
      }
}

其中，参数targetID指定内容显示区的id，即div层的id，.Text中为Edit_Contents。参数imageID指定显示出来的折叠按钮的图片id。
该函数通过javascript中的getElementById获得特定html元素的指针，从而控制相应的html元素。至于显示和隐藏内容是通过修改html元素的style.display属性实现的，当style.display="none"时，则不显示，如果style.display=""，则显示。

其实，在本控件中，ToggleVisible是动态装载的，该函数放在uicontrols.js文件中，通过重载Panel控件的OnPreRender事件可以完成javascript的动态加载，具体方法可以见《ASP.NET服务器控件与组件开发》。装载代码如下：

protected   override   void  OnPreRender(EventArgs e)
{    
    if (Collapsible){
                Page.RegisterClientScriptBlock(CLIENT_SCRIPT_KEY, 
                    Utilities.GetClientScriptInclude(CLIENT_SCRIPT_FILE));
            }
    base.OnPreRender(e);
}

其中，CLIENT_SCRIPT_KEY和CLIENT_SCRIPT_FILE为控件内部定义的常量。
3. Collapsed属性的实现
    Collapsed属性如果为true，则一开始就不显示内容区，该工作是通过重载Panel控件的Render方法实现的，代码如下：

if  (Collapsed)
{                    
        _contents.Style.Add("display", "none");
    _image.ImageUrl = LinkImageCollapsed;
}

其中的_contents.Style.Add()为内容显示层增加了style.display="none"，这样就可以在初始化时隐藏内容区。