TreeView.NoExpandImageUrl 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置自定义图像的 URL,该图像用作不可展开节点的指示符。
public:
property System::String ^ NoExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string NoExpandImageUrl { get; set; }
member this.NoExpandImageUrl : string with get, set
Public Property NoExpandImageUrl As String
属性值
为不可展开节点所显示的自定义图像的 URL。 默认值为空字符串 (""),这将显示默认的空白图像。
示例
下面的代码示例演示如何使用 NoExpandImageUrl 属性为不可扩展节点指示器指定自定义映像。 若要显示代码示例和要在控件中显示的图像,必须提供自己的图像,并且 ImageSet 属性必须设置为 TreeNodeImageSet.Custom
。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeView Custom Images Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeView Custom Images Example</h3>
<!-- Set the custom images of this TreeView control -->
<!-- declaratively. -->
<asp:TreeView id="CustomTreeView"
NoExpandImageUrl="Space.jpg"
CollapseImageUrl="Minus.jpg"
CollapseImageToolTip="Collapse Node"
ExpandImageUrl="Plus.jpg"
ExpandImageToolTip="Expand Node"
RootNodeStyle-ImageUrl="Root.jpg"
ParentNodeStyle-ImageUrl="Parent.jpg"
LeafNodeStyle-ImageUrl="Leaf.jpg"
ImageSet="Custom"
runat="server">
<Nodes>
<asp:TreeNode Value="Home"
NavigateUrl="Home.aspx"
Text="Home"
Target="_blank"
Expanded="True">
<asp:TreeNode Value="Page 1"
NavigateUrl="Page1.aspx"
Text="Page 1"
Target="_blank">
<asp:TreeNode Value="Section 1"
ImageUrl="custom.jpg"
NavigateUrl="Section1.aspx"
Text="Section 1"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Value="Page 2"
Selected="True"
NavigateUrl="Page2.aspx"
Text="Page 2"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
</Nodes>
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeView Custom Images Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeView Custom Images Example</h3>
<!-- Set the custom images of this TreeView control -->
<!-- declaratively. -->
<asp:TreeView id="CustomTreeView"
NoExpandImageUrl="Space.jpg"
CollapseImageUrl="Minus.jpg"
CollapseImageToolTip="Collapse Node"
ExpandImageUrl="Plus.jpg"
ExpandImageToolTip="Expand Node"
RootNodeStyle-ImageUrl="Root.jpg"
ParentNodeStyle-ImageUrl="Parent.jpg"
LeafNodeStyle-ImageUrl="Leaf.jpg"
ImageSet="Custom"
runat="server">
<Nodes>
<asp:TreeNode Value="Home"
NavigateUrl="Home.aspx"
Text="Home"
Target="_blank"
Expanded="True">
<asp:TreeNode Value="Page 1"
NavigateUrl="Page1.aspx"
Text="Page 1"
Target="_blank">
<asp:TreeNode Value="Section 1"
ImageUrl="custom.jpg"
NavigateUrl="Section1.aspx"
Text="Section 1"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Value="Page 2"
Selected="True"
NavigateUrl="Page2.aspx"
Text="Page 2"
Target="_blank">
</asp:TreeNode>
</asp:TreeNode>
</Nodes>
</asp:TreeView>
</form>
</body>
</html>
注解
使用该 NoExpandImageUrl 属性为不可扩展节点指示器指定自定义映像。 (或空格键) 的不可展开节点指示器图像显示在叶节点旁边, (代替可展开和可折叠的节点指示器,) 将叶节点与父节点或根节点对齐。
ShowExpandCollapse当属性设置为true
时,控件TreeView会显示一个加号 (+) 或减号 () 或节点旁边的占位符图像,以指示节点是可展开的、可折叠的还是不可展开的。 可以通过先将ImageSet属性TreeViewImageSet.Custom
设置为自定义映像,然后将自定义映像的 URL 和CollapseImageUrl属性设置为NoExpandImageUrlExpandImageUrl自定义映像的 URL 来指定自定义映像。 如果未指定任何映像,则使用默认映像。 若要隐藏扩展节点指示器,请将 ShowExpandCollapse 属性设置为 false
。
备注
若要确保在使用自定义图像时控件中的TreeView节点正确对齐,请确保由控件NoExpandImageUrlExpandImageUrl指定的所有图像和CollapseImageUrl属性具有相同的尺寸。
此属性的值存储在视图状态中。