TreeView.CollapseImageUrl Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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é

String

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 truesur , 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.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.

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.

S’applique à