TreeView.ExpandImageUrl 属性

定义

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

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

属性值

为可展开节点所显示的自定义图像的 URL。 默认值为空字符串 (""),这将显示默认的加号 (+) 图像。

示例

下面的代码示例演示如何使用 ExpandImageUrl 属性为可展开节点指示器指定自定义图像。 对于要显示的代码示例和要在 控件中显示的图像,必须提供自己的图像, 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>

注解

ExpandImageUrl使用 属性为可展开节点指示器指定自定义映像。 此图像显示在可展开节点旁边,通常是 (+) 的加号。

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

注意

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

若要正确显示自定义图像,可能需要将 设置为 ShowLinesfalse

将自定义映像用于可展开节点指示器时,还应考虑设置 ExpandImageToolTip 属性以指定图像的工具提示。

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

适用于

另请参阅