Freigeben über


TreeView.CollapseImageUrl Eigenschaft

Definition

Ruft die URL zu einem benutzerdefinierten Bild für den Indikator eines reduzierbaren Knotens ab oder legt diese fest.

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

Eigenschaftswert

String

Die URL zu einem benutzerdefinierten Bild, das für reduzierbare Knoten angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die das Standardbild mit dem Minuszeichen (-) anzeigt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die CollapseImageUrl Eigenschaft verwenden, um ein benutzerdefiniertes Bild für das kollapsible Knotenindikator anzugeben. Um das Codebeispiel anzuzeigen und das bild, das im Steuerelement angezeigt werden soll, müssen Sie Ihr eigenes Bild bereitstellen und die ImageSet Eigenschaft auf TreeNodeImageSet.Custom"festgelegt" festgelegt werden.


<%@ 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>

Hinweise

Verwenden Sie die CollapseImageUrl Eigenschaft, um ein benutzerdefiniertes Bild für das kollapsible Knotenindikator anzugeben. Dieses Bild wird neben einem kollapsiblen Knoten angezeigt und ist in der Regel ein Minuszeichen (-).

Wenn die ShowExpandCollapse Eigenschaft auf true"" festgelegt ist, zeigt das TreeView Steuerelement ein Pluszeichen (+) oder ein Minuszeichen (+) oder ein Platzhalterbild neben einem Knoten an, um anzugeben, ob der Knoten erweiterbar, kollapsible oder nicht erweiterbar ist. Sie können benutzerdefinierte Bilder angeben, indem Sie zuerst die ImageSet Eigenschaft auf TreeViewImageSet.Custom, und dann die URLs für die benutzerdefinierten Bilder festlegenNoExpandImageUrlExpandImageUrl.CollapseImageUrl Wenn keine Bilder angegeben werden, werden die Standardbilder verwendet. Um die Erweiterungsknotenindikatoren auszublenden, legen Sie die ShowExpandCollapse Eigenschaft auf false.

Hinweis

Um sicherzustellen, dass Knoten beim Verwenden von benutzerdefinierten Bildern korrekt ausgerichtet TreeView sind, stellen Sie sicher, dass alle Bilder, die von dem NoExpandImageUrl, ExpandImageUrlund CollapseImageUrl eigenschaften angegeben werden, die gleichen Dimensionen aufweisen.

Wenn Sie ein benutzerdefiniertes Bild für das zusammenbrechbare Knotenindikator verwenden, sollten Sie auch die Eigenschaft festlegen CollapseImageToolTip , um eine QuickInfo für das Bild anzugeben.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch