TreeView.CollapseImageUrl 属性

定义

获取或设置自定义图像的 URL,该图像用作可折叠节点的指示符。

public:
 property System::String ^ CollapseImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string CollapseImageUrl { get; set; }
member this.CollapseImageUrl : string with get, set
Public Property CollapseImageUrl As String

属性值

String

为可折叠节点所显示的自定义图像的 URL。 默认值为空字符串 (""),这将显示默认的减号 (-) 图像。

示例

下面的代码示例演示如何使用 CollapseImageUrl 属性为可折叠节点指示器指定自定义映像。 若要显示代码示例和要在控件中显示的图像,必须提供自己的图像,并且 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>

注解

使用 CollapseImageUrl 属性为可折叠节点指示器指定自定义映像。 此图像显示在可折叠节点旁边,通常是减号 () 。

ShowExpandCollapse当属性设置为true时,控件TreeView会显示加号 (+) 或减号 () 或节点旁边的占位符图像,以指示节点是可展开的、可折叠的还是不可展开的。 可以通过先将ImageSet属性TreeViewImageSet.Custom设置为自定义映像,然后将自定义图像的 URL 和CollapseImageUrl属性设置为NoExpandImageUrlExpandImageUrl自定义映像,来指定自定义映像。 如果未指定任何映像,则使用默认映像。 若要隐藏扩展节点指示器,请将 ShowExpandCollapse 属性设置为 false

备注

若要确保在使用自定义图像时控件中的TreeView节点正确对齐,请确保由控件NoExpandImageUrlExpandImageUrl指定的所有图像和CollapseImageUrl属性具有相同的尺寸。

对可折叠节点指示器使用自定义映像时,还应考虑设置 CollapseImageToolTip 属性以指定图像的工具提示。

此属性的值存储在视图状态中。

适用于

另请参阅