TreeView.LineImagesFolder Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le chemin d'accès à un dossier qui contient les images de ligne qui sont utilisées pour relier des nœuds enfants à des nœuds parents.
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
Valeur de propriété
Le chemin d'accès à un dossier qui contient les images de ligne utilisées pour relier des nœuds. La valeur par défaut est une chaîne vide (" "), ce qui signifie que la propriété LineImagesFolder n'est pas définie.
Exemples
L’exemple de code suivant montre comment utiliser la propriété pour spécifier le LineImagesFolder dossier qui contient les images de ligne à afficher dans le TreeView contrôle. Pour utiliser cet exemple, utilisez l’outil Concepteur de lignes au préalable pour créer un ensemble d’images de ligne. Placez-les dans un dossier nommé LineImages dans le répertoire de l’exemple d’application.
<%@ 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>
Remarques
Le TreeView contrôle peut afficher des lignes qui connectent des nœuds enfants aux nœuds parents lorsque la ShowLines propriété est définie sur true
. Lorsque des lignes sont affichées, utilisez la propriété pour spécifier un dossier accessible sur le LineImagesFolder web qui contient l’ensemble d’images pré-rendues à utiliser pour les lignes. Le tableau suivant décrit les images utilisées par le TreeView contrôle.
Image | Description |
---|---|
Dash.gif | Image de ligne affichée en regard du nœud racine lorsqu’il n’existe qu’un seul nœud racine dans la structure d’arborescence et que le nœud racine est une feuille. |
Dashminus.gif | Image de signe moins (-) affichée en regard du nœud racine lorsqu’il n’y a qu’un seul nœud racine dans la structure de l’arborescence pour indiquer que le nœud racine est développé. |
Dashplus.gif | Image de signe plus (+) affichée en regard du nœud racine lorsqu’il n’existe qu’un seul nœud racine dans la structure d’arborescence pour indiquer que le nœud racine est réduit. |
I.gif | Image de ligne affichée pour connecter des nœuds adjacents. |
L.gif | Image de ligne affichée en regard du dernier nœud d’une branche lorsque le nœud est une feuille. |
Lminus.gif | Image de ligne affichée en regard du dernier nœud d’une branche pour indiquer que le nœud est développé. |
Lplus.gif | Image de ligne affichée en regard du dernier nœud d’une branche pour indiquer que le nœud est réduit. |
Minus.gif | Image de signe moins (-) affichée en regard du premier nœud racine dans une structure d’arborescence qui contient plusieurs nœuds racines pour indiquer que le nœud est développé. Cette image ne contient pas de ligne supplémentaire et s’affiche uniquement une fois que le nœud racine a été réduit. Lorsque la page est chargée pour la première fois, l’image Rminus.gif s’affiche. |
Noexpand.gif | Image d’espaceur vide affichée en regard d’un nœud feuille. Cette image permet au texte de s’aligner verticalement. |
Plus.gif | Image de signe plus (+) affichée en regard du premier nœud racine dans une structure d’arborescence qui contient plusieurs nœuds racines pour indiquer que le nœud est réduit. Cette image ne contient pas de ligne supplémentaire et s’affiche uniquement une fois que le nœud racine a été développé une seule fois. Lorsque la page est chargée pour la première fois, l’image Rplus.gif s’affiche. |
R.gif | Image de ligne affichée en regard du premier nœud racine dans une structure d’arborescence qui contient plusieurs nœuds racines pour indiquer que le nœud est un nœud feuille. |
Rminus.gif | Image de signe moins (-) affichée en regard du premier nœud racine dans une structure d’arborescence qui contient plusieurs nœuds racines pour indiquer que le nœud est développé. Cette image contient une ligne supplémentaire et s’affiche uniquement lorsque la page est chargée pour la première fois. Une fois le nœud racine réduit, l’image Minus.gif s’affiche. |
Rplus.gif | Image de signe plus (+) affichée en regard du premier nœud racine dans une structure d’arborescence qui contient plusieurs nœuds racines pour indiquer que le nœud est réduit. Cette image contient une ligne supplémentaire et s’affiche uniquement lorsque la page est chargée pour la première fois. Une fois le nœud racine développé une fois, l’image Plus.gif s’affiche. |
T.gif | Image de ligne affichée en regard d’un nœud au milieu de la structure d’arborescence (à une intersection t) pour indiquer que le nœud est une feuille. |
Tminus.gif | Image de signe moins (-) affichée en regard d’un nœud au milieu de la structure d’arborescence (à une intersection t) pour indiquer que le nœud est développé. |
Tplus.gif | Image de signe plus (+) affichée en regard d’un nœud au milieu de la structure d’arborescence (à une intersection t) pour indiquer que le nœud est réduit. |
Notes
Si la LineImagesFolder propriété n’est pas définie, le TreeView contrôle utilise les images par défaut intégrées (20 x 20 pixels).
Certains concepteurs visuels, tels que Microsoft Visual Studio, fournissent des outils pour générer les images de ligne.
L’heure d’exécution ne retourne pas les images personnalisées pour les affichages de droite à gauche. Pour prendre en charge les pages Web de gauche à droite et de droite à gauche, vous devez créer des jeux d’images pour les deux directions.
La valeur de cette propriété est stockée dans l’état d’affichage.