TreeView.LineImagesFolder Propriedade
Definição
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 o caminho para uma pasta que contém as imagens de linha usadas para conectar nós filho a nós pai.
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 da propriedade
O caminho para uma pasta que contém as imagens de linha usadas para conectar nós. O padrão é uma cadeia de caracteres vazia (""), que indica que a propriedade LineImagesFolder não está definida.
Exemplos
O exemplo de código a seguir demonstra como usar a LineImagesFolder propriedade para especificar a pasta que contém as imagens de linha a serem exibidas no TreeView controle . Para trabalhar com este exemplo, use a ferramenta Designer de Linha com antecedência para criar um conjunto de imagens de linha. Coloque-os em uma pasta chamada LineImages no diretório do aplicativo 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>
Comentários
O TreeView controle pode exibir linhas que conectam nós filho a nós pai quando a ShowLines propriedade é definida true
como . Quando as linhas forem exibidas, use a LineImagesFolder propriedade para especificar uma pasta acessível pela Web que contém o conjunto de imagens pré-renderizadas a serem usadas para as linhas. A tabela a seguir descreve as imagens usadas pelo TreeView controle .
Imagem | Descrição |
---|---|
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 de subtração (-) exibida ao lado do nó raiz quando há apenas um nó raiz na estrutura da árvore para indicar que o nó raiz foi expandido. |
Dashplus.gif | Uma imagem de sinal de adição (+) exibida ao lado do nó raiz quando há apenas um nó raiz na estrutura da árvore para indicar que o nó raiz está recolhido. |
I.gif | Uma imagem de linha exibida para conectar nós adjacentes. |
L.gif | Uma imagem de linha exibida ao lado do último nó em um branch quando o nó é uma folha. |
Lminus.gif | Uma imagem de linha exibida ao lado do último nó em um branch para indicar que o nó foi expandido. |
Lplus.gif | Uma imagem de linha exibida ao lado do último nó em um branch para indicar que o nó foi recolhido. |
Minus.gif | Uma imagem de sinal de subtração (-) exibida ao lado do primeiro nó raiz em uma estrutura de árvore que contém vários nós raiz para indicar que o nó foi expandido. Essa imagem não contém uma linha extra e é exibida somente depois que o nó raiz é recolhido uma vez. Quando a página é carregada pela primeira vez, a imagem Rminus.gif é exibida. |
Noexpand.gif | Uma imagem do espaçador em branco exibida ao lado de um nó folha. Essa imagem permite que o texto seja alinhado verticalmente. |
Plus.gif | Uma imagem de sinal de adição (+) exibida ao lado do primeiro nó raiz em uma estrutura de árvore que contém vários nós raiz para indicar que o nó foi recolhido. Essa imagem não contém uma linha extra e é exibida somente depois que o nó raiz é expandido uma vez. Quando a página é carregada pela primeira vez, a imagem Rplus.gif é exibida. |
R.gif | Uma imagem de linha exibida ao lado do primeiro nó raiz em uma estrutura de árvore que contém vários nós raiz para indicar que o nó é um nó folha. |
Rminus.gif | Uma imagem de sinal de subtração (-) exibida ao lado do primeiro nó raiz em uma estrutura de árvore que contém vários nós raiz para indicar que o nó foi expandido. Esta imagem contém uma linha extra e é exibida somente quando a página é carregada pela primeira vez. Depois que o nó raiz tiver sido recolhido uma vez, a imagem Minus.gif será exibida. |
Rplus.gif | Uma imagem de sinal de adição (+) exibida ao lado do primeiro nó raiz em uma estrutura de árvore que contém vários nós raiz para indicar que o nó foi recolhido. Esta imagem contém uma linha extra e é exibida somente quando a página é carregada pela primeira vez. Depois que o nó raiz for expandido uma vez, a imagem Plus.gif será exibida. |
T.gif | Uma imagem de linha exibida ao lado de um nó no meio da estrutura da árvore (em uma interseção t) para indicar que o nó é uma folha. |
Tminus.gif | Uma imagem de sinal de subtração (-) exibida ao lado de um nó no meio da estrutura da árvore (em uma interseção t) para indicar que o nó foi expandido. |
Tplus.gif | Uma imagem de sinal de adição (+) exibida ao lado de um nó no meio da estrutura da árvore (em uma interseção t) para indicar que o nó foi recolhido. |
Observação
Se a LineImagesFolder propriedade não estiver definida, o TreeView controle usará as imagens padrão internas (20 x 20 pixels).
Alguns designers visuais, como Microsoft Visual Studio, fornecem ferramentas para gerar as imagens de linha.
O tempo de execução não inverte imagens personalizadas para exibições da direita para a esquerda. Para dar suporte a páginas da Web da esquerda para a direita e da direita para a esquerda, você deve criar conjuntos de imagens para ambas as direções.
O valor dessa propriedade é armazenado no estado de exibição.