TreeView.CollapseImageUrl 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 l'URL vers une image personnalisée pour l'indicateur de nœud réductible.
public:
property System::String ^ CollapseImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string CollapseImageUrl { get; set; }
member this.CollapseImageUrl : string with get, set
Public Property CollapseImageUrl As String
Valeur de propriété
URL vers une image personnalisée à afficher pour les nœuds réductibles. La valeur par défaut est une chaîne vide (""), ce qui affiche l'image du signe moins (-) par défaut.
Exemples
L’exemple de code suivant montre comment utiliser la CollapseImageUrl propriété pour spécifier une image personnalisée pour l’indicateur de nœud réductible. Pour que l’exemple de code affiche et que l’image apparaisse dans le contrôle, vous devez fournir votre propre image et la ImageSet propriété doit être définie sur 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>
Remarques
Utilisez la CollapseImageUrl propriété pour spécifier une image personnalisée pour l’indicateur de nœud réductible. Cette image s’affiche en regard d’un nœud réductible et est généralement un signe moins (-).
Lorsque la ShowExpandCollapse propriété est définie true
sur , le TreeView contrôle affiche un signe plus (+) ou un signe moins(-) ou une image d’espace réservé en regard d’un nœud pour indiquer si le nœud est extensible, réductible ou non extensible, respectivement. Vous pouvez spécifier des images personnalisées en définissant d’abord la ImageSet propriété TreeViewImageSet.Custom
sur , puis en définissant le NoExpandImageUrl, ExpandImageUrlet CollapseImageUrl les propriétés sur les URL des images personnalisées. Si aucune image n’est spécifiée, les images par défaut sont utilisées. Pour masquer les indicateurs de nœud d’expansion, définissez la ShowExpandCollapse propriété sur false
.
Notes
Pour vous assurer que les nœuds s’alignent correctement dans le contrôle lors de l’utilisation TreeView d’images personnalisées, assurez-vous que toutes les images spécifiées par le NoExpandImageUrl, ExpandImageUrlet CollapseImageUrl les propriétés ont les mêmes dimensions.
Lorsque vous utilisez une image personnalisée pour l’indicateur de nœud réductible, vous devez également envisager de définir la CollapseImageToolTip propriété pour spécifier une info-bulle pour l’image.
La valeur de cette propriété est stockée dans l’état d’affichage.