TreeView.CollapseImageUrl Свойство

Определение

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

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

Значение свойства

String

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

Примеры

В следующем примере кода показано, как использовать CollapseImageUrl свойство для задания пользовательского изображения для индикатора сворачиваемого узла.The following code example demonstrates how to use the CollapseImageUrl property to specify a custom image for the collapsible 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>

Комментарии

Используйте CollapseImageUrl свойство, чтобы указать пользовательский образ для индикатора сворачиваемого узла.Use the CollapseImageUrl property to specify a custom image for the collapsible node indicator. Это изображение отображается рядом с свертываемая узлом и обычно является знаком "минус" (-).This image is displayed next to a collapsible node and is usually a minus sign (-).

Если ShowExpandCollapse свойство имеет значение true , TreeView элемент управления отображает знак плюса (+) или знак минуса (-) или изображение заполнителя рядом с узлом, чтобы указать, что узел является расширяемым, свертываемая или нерасширяемым соответственно.When the ShowExpandCollapse property is set to true, the TreeView control displays a plus sign (+) or a 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.

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

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

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

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