TreeView.ExpandImageUrl Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

Valor da propriedade

String

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

Exemplos

O exemplo de código a seguir demonstra como usar a ExpandImageUrl propriedade para especificar uma imagem personalizada para o indicador de nó expansível. Para que o exemplo de código seja exibido e a imagem apareça 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 ExpandImageUrl propriedade para especificar uma imagem personalizada para o indicador de nó expansível. Essa imagem é exibida ao lado de um nó expansível e geralmente é um sinal de adição (+).

Quando a ShowExpandCollapse propriedade é definida como true, o TreeView controle exibe um sinal de adição (+) ou 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 TreeView nós se alinhem corretamente no controle ao usar imagens personalizadas, verifique se todas as imagens especificadas pelo NoExpandImageUrl, ExpandImageUrle CollapseImageUrl as propriedades têm as mesmas dimensões.

Para exibir uma imagem personalizada corretamente, talvez seja necessário definir ShowLines como false.

Ao usar uma imagem personalizada para o indicador de nó expansível, você também deve considerar definir a ExpandImageToolTip propriedade para especificar uma Dica de Ferramenta para a imagem.

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

Aplica-se a

Partilhar via