TreeView.NoExpandImageUrl Eigenschaft

Definition

Ruft die URL zu einem benutzerdefinierten Bild für den Indikator eines nicht erweiterbaren Knotens ab oder legt diesen fest.

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

Eigenschaftswert

String

Die URL zu einem benutzerdefinierten Bild, das für nicht erweiterbare Knoten angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die das standardmäßige leere Bild anzeigt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der NoExpandImageUrl Eigenschaft ein benutzerdefiniertes Bild für den nicht erweiterbaren Knotenindikator angeben. Damit das Codebeispiel angezeigt wird und das Bild im Steuerelement angezeigt werden soll, müssen Sie ihr eigenes Bild angeben, und die ImageSet Eigenschaft muss auf festgelegt TreeNodeImageSet.Customwerden.


<%@ 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 NoExpandImageUrl Eigenschaft, um ein benutzerdefiniertes Bild für den nicht erweiterbaren Knotenindikator anzugeben. Das nicht erweiterbare Knotenanzeigebild (oder Leerzeichen) wird neben Blattknoten (anstelle der erweiterbaren und zusammensetzbaren Knotenindikatoren) angezeigt, um die Blattknoten mit übergeordneten oder Stammknoten auszurichten.

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, einklappbar oder nicht erweiterbar ist. Sie können benutzerdefinierte Bilder angeben, indem Sie zuerst die ImageSet Eigenschaft TreeViewImageSet.Customauf und dann die URLs ExpandImageUrlder benutzerdefinierten Bilder festlegen und CollapseImageUrl dann die NoExpandImageUrlURLs der benutzerdefinierten Bilder festlegen. 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 im TreeView Steuerelement ausgerichtet werden, stellen Sie sicher, dass alle Bilder, die von den NoExpandImageUrl, ExpandImageUrlund CollapseImageUrl Eigenschaften angegeben werden, dieselben Dimensionen aufweisen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch