TreeView.ExpandImageUrl Propriété

Définition

Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud développable.

public:
 property System::String ^ ExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string ExpandImageUrl { get; set; }
member this.ExpandImageUrl : string with get, set
Public Property ExpandImageUrl As String

Valeur de propriété

String

URL vers une image personnalisée à afficher pour les nœuds développables. La valeur par défaut est une chaîne vide (""), ce qui affiche l'image du signe plus (+) par défaut.

Exemples

L’exemple de code suivant montre comment utiliser la ExpandImageUrl propriété pour spécifier une image personnalisée pour l’indicateur de nœud extensible. 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 ExpandImageUrl propriété pour spécifier une image personnalisée pour l’indicateur de nœud extensible. Cette image s’affiche en regard d’un nœud extensible et est généralement un signe plus (+).

Lorsque la ShowExpandCollapse propriété est définie truesur , le TreeView contrôle affiche un signe plus (+) ou 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.Customsur , 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.

Pour afficher correctement une image personnalisée, vous devrez peut-être définir ShowLines sur false.

Lorsque vous utilisez une image personnalisée pour l’indicateur de nœud extensible, vous devez également envisager de définir la ExpandImageToolTip 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.

S’applique à

Voir aussi