TreeView.CollapseImageUrl Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a URL para uma imagem personalizada para o indicador de nó recolhível.

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

Valor da propriedade

String

A URL para uma imagem personalizada a ser exibida para nós recolhíveis. O padrão é uma cadeia de caracteres vazia (""), que exibe a imagem do sinal de subtração (-) padrão.

Exemplos

O exemplo de código a seguir demonstra como usar a CollapseImageUrl propriedade para especificar uma imagem personalizada para o indicador de nó recolhível. Para que o exemplo de código seja exibido e a imagem a ser exibida no controle, você deve fornecer sua própria imagem e a ImageSet propriedade deve ser definida como 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>

Comentários

Use a CollapseImageUrl propriedade para especificar uma imagem personalizada para o indicador de nó recolhível. Essa imagem é exibida ao lado de um nó recolhível e geralmente é um sinal de menos (-).

Quando a ShowExpandCollapse propriedade é definida como true, o TreeView controle exibe um sinal de adição (+) ou um sinal de menos(-) ou uma imagem de espaço reservado ao lado de um nó para indicar se o nó é expansível, recolhível ou não expansível, respectivamente. Você pode especificar imagens personalizadas definindo primeiro a ImageSet propriedade como TreeViewImageSet.Custom, e, em seguida, definindo o NoExpandImageUrl, ExpandImageUrle CollapseImageUrl as propriedades para as URLs para as imagens personalizadas. Se nenhuma imagem for especificada, as imagens padrão serão usadas. Para ocultar os indicadores de nó de expansão, defina a ShowExpandCollapse propriedade como false.

Observação

Para garantir que os nós se alinhem corretamente no TreeView controle ao usar imagens personalizadas, verifique se todas as imagens especificadas pelo NoExpandImageUrl, ExpandImageUrle CollapseImageUrl as propriedades têm as mesmas dimensões.

Ao usar uma imagem personalizada para o indicador de nó recolhível, você também deve considerar a configuração da CollapseImageToolTip propriedade para especificar uma Dica de Ferramenta para a imagem.

O valor dessa propriedade é armazenado no estado de exibição.

Aplica-se a

Confira também