TreeView.ExpandImageUrl 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定可展開節點指示器之自訂影像的 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

屬性值

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 來指定自訂影像，然後將 、 ExpandImageUrl 和 CollapseImageUrl 屬性設定 NoExpandImageUrl 為自訂影像的 URL。 如果未指定任何影像，則會使用預設影像。 若要隱藏擴充節點指標，請將 ShowExpandCollapse 屬性設定為 false 。

注意

若要在使用自訂影像時，確保控制項中的 TreeView 節點正確對齊，請確定 、 和 CollapseImageUrl 屬性所 NoExpandImageUrlExpandImageUrl 指定的所有影像具有相同維度。

若要正確顯示自訂影像，您可能需要設定 ShowLines 為 false 。

針對可展開節點指標使用自訂影像時，您也應該考慮設定 ExpandImageToolTip 屬性來指定影像的工具提示。

此屬性的值會儲存在檢視狀態中。

適用於

另請參閱