TreeView.LineImagesFolder Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la ruta de acceso a una carpeta que contiene las imágenes de la línea que se utilizan para conectar los nodos secundarios a los nodos primarios.
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 propiedad
La ruta de acceso a una carpeta que contiene las imágenes de línea utilizadas para conectar los nodos. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido la propiedad LineImagesFolder.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la propiedad para especificar la LineImagesFolder carpeta que contiene las imágenes de línea que se van a mostrar en el TreeView control . Para trabajar con este ejemplo, use la herramienta Diseñador de líneas de antemano para crear un conjunto de imágenes de línea. Colóquelos en una carpeta denominada LineImages en el directorio de la aplicación de ejemplo.
<%@ 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>
Comentarios
El TreeView control puede mostrar líneas que conectan nodos secundarios a nodos primarios cuando la ShowLines propiedad está establecida true
en . Cuando se muestren líneas, use la LineImagesFolder propiedad para especificar una carpeta accesible desde web que contenga el conjunto de imágenes prede renderizadas que se usarán para las líneas. En la tabla siguiente se describen las imágenes que usa el TreeView control .
Imagen | Descripción |
---|---|
Dash.gif | Imagen de línea que se muestra junto al nodo raíz cuando solo hay un nodo raíz en la estructura de árbol y el nodo raíz es una hoja. |
Dashminus.gif | Imagen de signo menos (-) que se muestra junto al nodo raíz cuando solo hay un nodo raíz en la estructura de árbol para indicar que se expande el nodo raíz. |
Dashplus.gif | Imagen de signo más (+) que se muestra junto al nodo raíz cuando solo hay un nodo raíz en la estructura de árbol para indicar que el nodo raíz está contraído. |
I.gif | Imagen de línea que se muestra para conectar nodos adyacentes. |
L.gif | Imagen de línea que se muestra junto al último nodo de una rama cuando el nodo es una hoja. |
Lminus.gif | Imagen de línea que se muestra junto al último nodo de una rama para indicar que el nodo está expandido. |
Lplus.gif | Imagen de línea que se muestra junto al último nodo de una rama para indicar que el nodo está contraído. |
Minus.gif | Imagen de signo menos (-) que se muestra junto al primer nodo raíz de una estructura de árbol que contiene varios nodos raíz para indicar que el nodo está expandido. Esta imagen no contiene una línea adicional y solo se muestra después de que el nodo raíz se contraiga una vez. Cuando se carga por primera vez la página, se muestra la imagen Rminus.gif. |
Noexpand.gif | Imagen del espaciador en blanco que se muestra junto a un nodo hoja. Esta imagen permite que el texto se alinee verticalmente. |
Plus.gif | Imagen de signo más (+) que se muestra junto al primer nodo raíz de una estructura de árbol que contiene varios nodos raíz para indicar que el nodo está contraído. Esta imagen no contiene una línea adicional y solo se muestra después de que el nodo raíz se haya expandido una vez. Cuando se carga por primera vez la página, se muestra la imagen Rplus.gif. |
R.gif | Imagen de línea que se muestra junto al primer nodo raíz de una estructura de árbol que contiene varios nodos raíz para indicar que el nodo es un nodo hoja. |
Rminus.gif | Imagen de signo menos (-) que se muestra junto al primer nodo raíz de una estructura de árbol que contiene varios nodos raíz para indicar que el nodo está expandido. Esta imagen contiene una línea adicional y solo se muestra cuando la página se carga por primera vez. Una vez contraído el nodo raíz, se muestra la imagen Minus.gif. |
Rplus.gif | Imagen de signo más (+) que se muestra junto al primer nodo raíz de una estructura de árbol que contiene varios nodos raíz para indicar que el nodo está contraído. Esta imagen contiene una línea adicional y solo se muestra cuando la página se carga por primera vez. Después de expandir el nodo raíz una vez, se muestra la imagen de Plus.gif. |
T.gif | Imagen de línea que se muestra junto a un nodo en medio de la estructura de árbol (en una intersección t) para indicar que el nodo es una hoja. |
Tminus.gif | Imagen de signo menos (-) que se muestra junto a un nodo en medio de la estructura de árbol (en una intersección t) para indicar que el nodo está expandido. |
Tplus.gif | Imagen de signo más (+) que se muestra junto a un nodo en medio de la estructura de árbol (en una intersección t) para indicar que el nodo está contraído. |
Nota
Si no se establece la LineImagesFolder propiedad, el TreeView control usará las imágenes predeterminadas integradas (20 x 20 píxeles).
Algunos diseñadores visuales, como Microsoft Visual Studio, proporcionan herramientas para generar las imágenes de línea.
El tiempo de ejecución no voltea las imágenes personalizadas para las pantallas de derecha a izquierda. Para admitir páginas web de izquierda a derecha y derecha a izquierda, debe crear conjuntos de imágenes para ambas direcciones.
El valor de esta propiedad se almacena en estado de vista.