TreeView.ExpandImageUrl Właściwość

Definicja

Pobiera lub ustawia adres URL na obraz niestandardowy dla wskaźnika węzła, który można rozwinąć.

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

Wartość właściwości

Adres URL obrazu niestandardowego do wyświetlenia dla węzłów z możliwością rozwijania. Wartość domyślna to pusty ciąg (""), który wyświetla domyślny obraz znaku plus (+).

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą ExpandImageUrl właściwości określić obraz niestandardowy dla wskaźnika węzła, który można rozwinąć. Aby przykładowy kod był wyświetlany i obraz wyświetlany w kontrolce, należy podać własny obraz, a ImageSet właściwość musi być ustawiona na TreeNodeImageSet.Customwartość .


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

Uwagi

ExpandImageUrl Użyj właściwości , aby określić obraz niestandardowy dla wskaźnika węzła, który można rozwinąć. Ten obraz jest wyświetlany obok węzła z możliwością rozwijania i zwykle jest znakiem plus (+).

ShowExpandCollapse Gdy właściwość jest ustawiona na truewartość , kontrolka TreeView wyświetla znak plus (+) lub znak minus (-) lub obraz zastępczy obok węzła, aby wskazać, czy węzeł jest rozszerzalny, zwijany, czy nie rozwijalny odpowiednio. Obrazy niestandardowe można określić, ustawiając ImageSet najpierw właściwość na TreeViewImageSet.Custom, a następnie ustawiając NoExpandImageUrlwłaściwości , ExpandImageUrli CollapseImageUrl na adresy URL obrazów niestandardowych. Jeśli nie określono żadnych obrazów, są używane obrazy domyślne. Aby ukryć wskaźniki węzła rozszerzenia, ustaw ShowExpandCollapse właściwość na falsewartość .

Uwaga

Aby upewnić się, że węzły są prawidłowo wyrównane do kontrolki TreeView podczas korzystania z obrazów niestandardowych, upewnij się, że wszystkie obrazy określone przez NoExpandImageUrlwłaściwości , ExpandImageUrli CollapseImageUrl mają te same wymiary.

Aby poprawnie wyświetlić obraz niestandardowy, może być konieczne ustawienie wartości ShowLinesfalse.

W przypadku używania obrazu niestandardowego dla wskaźnika węzła z możliwością rozwijania należy również rozważyć ustawienie ExpandImageToolTip właściwości w celu określenia etykietki narzędzia dla obrazu.

Wartość tej właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też