TreeView.LineImagesFolder Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o caminho para uma pasta que contém as imagens de linha usadas para ligar os nós filhos aos nós pais.

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

Valor de Propriedade

String

O caminho para uma pasta que contém as imagens de linha usadas para ligar nós. O padrão é uma cadeia vazia (""), o que indica que a LineImagesFolder propriedade não está definida.

Exemplos

O exemplo de código seguinte demonstra como usar a LineImagesFolder propriedade para especificar a pasta que contém as imagens de linha a mostrar no TreeView controlo. Para trabalhar com este exemplo, use a ferramenta Line Designer antes para criar um conjunto de imagens de linhas. Coloque-as numa pasta chamada LineImages dentro do diretório da aplicação de exemplo.


<%@ 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 LineImagesFolderUrl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView LineImagesFolderUrl Example</h3>
      
      <asp:TreeView id="LinksTreeView"
        LineImagesFolder="~\LineImages"
        ShowLines="true" 
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Text="Table of Contents"
             SelectAction="None">
             
            <asp:TreeNode Text="Chapter One">
            
              <asp:TreeNode Text="Section 1.0">
              
                <asp:TreeNode Text="Topic 1.0.1"/>
                <asp:TreeNode Text="Topic 1.0.2"/>
                <asp:TreeNode Text="Topic 1.0.3"/>
              
              </asp:TreeNode>
              
              <asp:TreeNode Text="Section 1.1">
              
                <asp:TreeNode Text="Topic 1.1.1"/>
                <asp:TreeNode Text="Topic 1.1.2"/>
                <asp:TreeNode Text="Topic 1.1.3"/>
                <asp:TreeNode Text="Topic 1.1.4"/>
              
              </asp:TreeNode>
            
            </asp:TreeNode>
            
            <asp:TreeNode Text="Chapter Two">
            
              <asp:TreeNode Text="Section 2.0">
              
                <asp:TreeNode Text="Topic 2.0.1"/>
                <asp:TreeNode Text="Topic 2.0.2"/>
              
              </asp:TreeNode>
            
            </asp:TreeNode>
            
          </asp:TreeNode>

          <asp:TreeNode Text="Appendix A" />
          <asp:TreeNode Text="Appendix B" />
          <asp:TreeNode Text="Appendix C" />
        
        </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 LineImagesFolderUrl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView LineImagesFolderUrl Example</h3>
      
      <asp:TreeView id="LinksTreeView"
        LineImagesFolder="~\LineImages"
        ShowLines="true" 
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Text="Table of Contents"
             SelectAction="None">
             
            <asp:TreeNode Text="Chapter One">
            
              <asp:TreeNode Text="Section 1.0">
              
                <asp:TreeNode Text="Topic 1.0.1"/>
                <asp:TreeNode Text="Topic 1.0.2"/>
                <asp:TreeNode Text="Topic 1.0.3"/>
              
              </asp:TreeNode>
              
              <asp:TreeNode Text="Section 1.1">
              
                <asp:TreeNode Text="Topic 1.1.1"/>
                <asp:TreeNode Text="Topic 1.1.2"/>
                <asp:TreeNode Text="Topic 1.1.3"/>
                <asp:TreeNode Text="Topic 1.1.4"/>
              
              </asp:TreeNode>
            
            </asp:TreeNode>
            
            <asp:TreeNode Text="Chapter Two">
            
              <asp:TreeNode Text="Section 2.0">
              
                <asp:TreeNode Text="Topic 2.0.1"/>
                <asp:TreeNode Text="Topic 2.0.2"/>
              
              </asp:TreeNode>
            
            </asp:TreeNode>
            
          </asp:TreeNode>

          <asp:TreeNode Text="Appendix A" />
          <asp:TreeNode Text="Appendix B" />
          <asp:TreeNode Text="Appendix C" />
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>

Observações

O TreeView controlo pode mostrar linhas que ligam os nós filhos aos nós pais quando a ShowLines propriedade está definida para true. Quando as linhas são exibidas, use a LineImagesFolder propriedade para especificar uma pasta acessível na Web que contenha o conjunto de imagens pré-renderizadas a usar para as linhas. A tabela seguinte descreve as imagens utilizadas pelo TreeView controlo.

Imagem Description
Dash.gif Uma imagem de linha exibida ao lado do nó raiz quando há apenas um nó raiz na estrutura da árvore e o nó raiz é uma folha.
Dashminus.gif Uma imagem de sinal negativo (-) exibida ao lado do nó raiz quando há apenas um nó raiz na estrutura da árvore para indicar que o nó raiz está expandido.
Dashplus.gif Uma imagem de sinal de mais (+) exibida ao lado do nó raiz quando há apenas um nó raiz na estrutura da árvore para indicar que o nó raiz está colapsado.
I.gif Uma imagem de linha exibida para ligar nós adjacentes.
L.gif Uma imagem de linha exibida ao lado do último nó de um ramo quando o nó é uma folha.
Lminus.gif Uma imagem de linha exibida junto ao último nó de um ramo para indicar que o nó está expandido.
Lplus.gif Uma imagem de linha exibida ao lado do último nó de um ramal para indicar que o nó está colapsado.
Minus.gif Uma imagem de sinal negativo (-) exibida ao lado do primeiro nó raiz numa estrutura em árvore que contém múltiplos nós raiz para indicar que o nó está expandido. Esta imagem não contém uma linha extra e só é exibida depois de o nó raiz ter sido colapsado uma vez. Quando a página é carregada pela primeira vez, a imagem Rminus.gif é apresentada.
Noexpand.gif Uma imagem de espaçador em branco exibida ao lado de um nó folha. Esta imagem permite que o texto se alinhe verticalmente.
Plus.gif Uma imagem de sinal de mais (+) exibida ao lado do primeiro nó raiz numa estrutura em árvore que contém múltiplos nós raiz para indicar que o nó está colapsado. Esta imagem não contém uma linha extra e só é exibida depois de o nó raiz ter sido expandido uma vez. Quando a página é carregada pela primeira vez, a imagem Rplus.gif é apresentada.
R.gif Uma imagem de linha exibida ao lado do primeiro nó raiz numa estrutura em árvore que contém múltiplos nós raiz para indicar que o nó é um nó folha.
Rminus.gif Uma imagem de sinal negativo (-) exibida ao lado do primeiro nó raiz numa estrutura em árvore que contém múltiplos nós raiz para indicar que o nó está expandido. Esta imagem contém uma linha extra e é exibida apenas quando a página é carregada pela primeira vez. Depois de o nó raiz ter sido colapsado uma vez, a imagem Minus.gif é apresentada.
Rplus.gif Uma imagem de sinal de mais (+) exibida ao lado do primeiro nó raiz numa estrutura em árvore que contém múltiplos nós raiz para indicar que o nó está colapsado. Esta imagem contém uma linha extra e é exibida apenas quando a página é carregada pela primeira vez. Depois de o nó raiz ter sido expandido uma vez, a imagem Plus.gif é apresentada.
T.gif Uma imagem de linha exibida ao lado de um nó no meio da estrutura em árvore (numa interseção t) para indicar que o nó é uma folha.
Tminus.gif Uma imagem com sinal menos (-) é exibida ao lado de um nó no meio da estrutura em árvore (numa interseção t) para indicar que o nó está expandido.
Tplus.gif Uma imagem com sinal de mais (+) é exibida ao lado de um nó no meio da estrutura em árvore (numa interseção t) para indicar que o nó está colapsado.

Note

Se a LineImagesFolder propriedade não estiver definida, o TreeView controlo usará as imagens predefinidas incorporadas (20 x 20 píxeis).

Alguns designers visuais, como a Microsoft Visual Studio, fornecem ferramentas para gerar as imagens das linhas.

O tempo de execução não inverte imagens personalizadas para ecrãs da direita para a esquerda. Para suportar páginas Web da esquerda para a direita e da direita para a esquerda, deve criar conjuntos de imagens para ambas as direções.

O valor desta propriedade é armazenado no estado de visualização.

Aplica-se a

Ver também