TreeView.ExpandImageUrl Свойство

Определение

Получает или задает URL-адрес пользовательского изображения для индикатора разворачиваемого узла.Gets or sets the URL to a custom image for the expandable node indicator.

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-адрес пользовательского изображения, отображаемого для разворачиваемых узлов.The URL to a custom image to display for expandable nodes. Значение по умолчанию — пустая строка (""), которая отображает изображение по умолчанию — знак плюс (+).The default is an empty string (""), which displays the default plus sign (+) image.

Примеры

В следующем примере кода показано, как использовать ExpandImageUrl свойство для указания пользовательского изображения для индикатора разворачиваемого узла.The following code example demonstrates how to use the ExpandImageUrl property to specify a custom image for the expandable node indicator. Чтобы пример кода отображался и изображение отображалось в элементе управления, необходимо предоставить собственный образ, а ImageSet свойство должно иметь значение TreeNodeImageSet.Custom .For the code example to display and the image to appear in the control, you must provide your own image and the ImageSet property must be set to 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 свойство, чтобы указать пользовательский образ для индикатора разворачиваемого узла.Use the ExpandImageUrl property to specify a custom image for the expandable node indicator. Это изображение отображается рядом с развертываемым узлом и обычно является знаком «плюс» (+).This image is displayed next to an expandable node and is usually a plus sign (+).

Если ShowExpandCollapse свойство имеет значение true , TreeView элемент управления отображает знак плюс (+) или знак минуса (-) или изображение заполнителя рядом с узлом, чтобы указать, что узел является расширяемым, свертываемая или нерасширяемым соответственно.When the ShowExpandCollapse property is set to true, the TreeView control displays a plus sign (+) or minus sign (-) or a placeholder image next to a node to indicate whether the node is expandable, collapsible, or non-expandable, respectively. Можно указать пользовательские образы, задав ImageSet для свойства значение TreeViewImageSet.Custom , а затем задав для NoExpandImageUrl ExpandImageUrl свойств, и CollapseImageUrl URL-адреса пользовательских образов.You can specify custom images by first setting the ImageSet property to TreeViewImageSet.Custom, and then setting the NoExpandImageUrl, ExpandImageUrl, and CollapseImageUrl properties to the URLs for the custom images. Если образы не указаны, используются образы по умолчанию.If no images are specified, the default images are used. Чтобы скрыть индикаторы узла расширения, задайте ShowExpandCollapse для свойства значение false .To hide the expansion node indicators, set the ShowExpandCollapse property to false.

Примечание

Чтобы обеспечить правильное согласование узлов в TreeView элементе управления при использовании пользовательских изображений, убедитесь, что все изображения, указанные в NoExpandImageUrl ExpandImageUrl свойствах, и, CollapseImageUrl имеют одинаковые размеры.To ensure that nodes align correctly in the TreeView control when using custom images, make sure that all the images that are specified by the NoExpandImageUrl, ExpandImageUrl, and CollapseImageUrl properties have the same dimensions.

Чтобы правильно отобразить пользовательский образ, может потребоваться задать значение ShowLines false .To display a custom image correctly, you may need to set ShowLines to false.

При использовании пользовательского изображения для индикатора разворачиваемого узла следует также установить ExpandImageToolTip свойство, чтобы указать подсказку для изображения.When using a custom image for the expandable node indicator, you should also consider setting the ExpandImageToolTip property to specify a ToolTip for the image.

Значение этого свойства хранится в состоянии представления.The value of this property is stored in view state.

Применяется к

См. также раздел