.Text中的用户文章管理界面是使用Advanced Panel的主要界面。Advanced Panel与普通WebPanel相比,多提供一个Header栏,并且可以不使用任何代码实现折叠[Collapsing]功能,这是该控件最有特色的地方。
控件常用属性
1. Collapsible属性
该属性为bool型,如果为true,该控件会在右侧显示一个折叠按钮,用于显示或隐藏Panel所包含的内容。否则不显示按钮,该控件变为不可折叠的panel。
2. Collapsed属性
该属性为bool型,默认值为false,初始化时会显示panel容器中的所有内容;如果为true,初始化时,panel容器中的内容不会显示出来。如果为true,显示效果如下:
图中,只能看到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",这样就可以在初始化时隐藏内容区。
原文地址:http://www.cnblogs.com/tonyqus/archive/2005/03/04/112730.html