TreeView.ExpandImageUrl Eigenschaft

Definition

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

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

Eigenschaftswert

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ExpandImageUrl -Eigenschaft verwendet wird, um ein benutzerdefiniertes Bild für den Erweiterbaren Knotenindikator anzugeben. Damit das Codebeispiel angezeigt wird und das Bild im Steuerelement angezeigt wird, müssen Sie Ihr eigenes Bild angeben, und die ImageSet -Eigenschaft muss auf TreeNodeImageSet.Customfestgelegt sein.


<%@ 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 ExpandImageUrl -Eigenschaft, um ein benutzerdefiniertes Bild für den erweiterbaren Knotenindikator anzugeben. Dieses Bild wird neben einem erweiterbaren Knoten angezeigt und ist in der Regel ein Pluszeichen (+).

Wenn die ShowExpandCollapse -Eigenschaft auf truefestgelegt ist, zeigt das TreeView Steuerelement ein Pluszeichen (+) oder ein Minuszeichen (-) oder ein Platzhalterbild neben einem Knoten an, um anzugeben, ob der Knoten erweiterbar, reduzierbar oder nicht erweiterbar ist. Sie können benutzerdefinierte Bilder angeben, indem Sie zuerst die ImageSet -Eigenschaft auf TreeViewImageSet.Customfestlegen und dann die NoExpandImageUrlEigenschaften , ExpandImageUrlund CollapseImageUrl auf die URLs für die benutzerdefinierten Bilder festlegen. Wenn keine Bilder angegeben sind, werden die Standardbilder verwendet. Um die Erweiterungsknotenindikatoren auszublenden, legen Sie die ShowExpandCollapse -Eigenschaft auf fest false.

Hinweis

Stellen Sie sicher, dass alle Bilder, die TreeView durch NoExpandImageUrldie Eigenschaften , ExpandImageUrlund CollapseImageUrl angegeben werden, die gleichen Dimensionen aufweisen, um sicherzustellen, dass knoten im Steuerelement ordnungsgemäß ausgerichtet sind.

Um ein benutzerdefiniertes Bild richtig anzuzeigen, müssen Sie möglicherweise auf falsefestlegenShowLines.

Wenn Sie ein benutzerdefiniertes Image für den Indikator für erweiterbare Knoten verwenden, sollten Sie auch erwägen, die ExpandImageToolTip -Eigenschaft so festzulegen, dass eine QuickInfo für das Bild angegeben wird.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen