Partilhar via

TreeView.NoExpandImageUrl Propriedade

  • Referência

Definição

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

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

public:
 property System::String ^ NoExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string NoExpandImageUrl { get; set; }
member this.NoExpandImageUrl : string with get, set
Public Property NoExpandImageUrl As String

Valor da propriedade

String

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

Exemplos

O exemplo de código a seguir demonstra como usar a NoExpandImageUrl propriedade para especificar uma imagem personalizada para o indicador de nó não expansí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 NoExpandImageUrl propriedade para especificar uma imagem personalizada para o indicador de nó não expansível. A imagem do indicador de nó não expansível (ou espaçador) é exibida ao lado de nós folha (no lugar dos indicadores de nó expansível e recolhível) para alinhar os nós folha com nós pai ou raiz.

Quando a ShowExpandCollapse propriedade é definida como true, o TreeView controle exibe um sinal de adição (+) ou sinal de subtração (-) 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 primeiro definindo a ImageSet propriedade como TreeViewImageSet.Custom, e depois definindo o NoExpandImageUrl, ExpandImageUrle CollapseImageUrl as propriedades para as URLs das 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.

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

Aplica-se a

Confira também