TreeView.NoExpandImageUrl 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 non développable.
public:
property System::String ^ NoExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string NoExpandImageUrl { get; set; }
member this.NoExpandImageUrl : string with get, set
Public Property NoExpandImageUrl As String
Valeur de propriété
URL vers une image personnalisée à afficher pour les nœuds non développables. La valeur par défaut est une chaîne vide (""), ce qui affiche l'image vide par défaut.
Exemples
L’exemple de code suivant montre comment utiliser la NoExpandImageUrl propriété pour spécifier une image personnalisée pour l’indicateur de nœud non extensible. Pour que l’exemple de code s’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 TreeNodeImageSet.Custom
sur .
<%@ 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 NoExpandImageUrl propriété pour spécifier une image personnalisée pour l’indicateur de nœud non extensible. L’image d’indicateur de nœud non extensible (ou espaceur) s’affiche en regard des nœuds feuilles (à la place des indicateurs de nœud extensibles et réductibles) pour aligner les nœuds feuilles avec des nœuds parents ou racines.
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’extension, définissez la propriété false
sur ShowExpandCollapse .
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.
La valeur de cette propriété est stockée dans l’état d’affichage.