TreeView.ExpandImageUrl Property

Definition

Ottiene o imposta l'URL di un'immagine personalizzata per l'indicatore di nodi espandibili.Gets or sets the URL to a custom image for the expandable node indicator.

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

Property Value

String

URL di un'immagine personalizzata per visualizzare i nodi espandibili.The URL to a custom image to display for expandable nodes. Il valore predefinito è una stringa vuota ("") che visualizza l'immagine predefinita del segno più (+).The default is an empty string (""), which displays the default plus sign (+) image.

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà ExpandImageUrl per specificare un'immagine personalizzata per l'indicatore di nodi espandibili.The following code example demonstrates how to use the ExpandImageUrl property to specify a custom image for the expandable node indicator. Per visualizzare l'esempio di codice e l'immagine da visualizzare nel controllo, è necessario fornire un'immagine personalizzata e la proprietà ImageSet deve essere impostata su TreeNodeImageSet.Custom.For the code example to display and the image to appear in the control, you must provide your own image and the ImageSet property must be set to 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>

Remarks

Utilizzare la proprietà ExpandImageUrl per specificare un'immagine personalizzata per l'indicatore di nodi espandibili.Use the ExpandImageUrl property to specify a custom image for the expandable node indicator. Questa immagine viene visualizzata accanto a un nodo espandibile ed è in genere un segno più (+).This image is displayed next to an expandable node and is usually a plus sign (+).

Quando la proprietà ShowExpandCollapse è impostata su true, il controllo TreeView Visualizza un segno più (+) o un segno meno (-) o un'immagine segnaposto accanto a un nodo per indicare se il nodo è espandibile, comprimibile o non espandibile, rispettivamente.When the ShowExpandCollapse property is set to true, the TreeView control displays a plus sign (+) or minus sign (-) or a placeholder image next to a node to indicate whether the node is expandable, collapsible, or non-expandable, respectively. È possibile specificare immagini personalizzate impostando prima la proprietà ImageSet su TreeViewImageSet.Custome quindi impostando le proprietà NoExpandImageUrl, ExpandImageUrle CollapseImageUrl sugli URL per le immagini personalizzate.You can specify custom images by first setting the ImageSet property to TreeViewImageSet.Custom, and then setting the NoExpandImageUrl, ExpandImageUrl, and CollapseImageUrl properties to the URLs for the custom images. Se non viene specificata alcuna immagine, vengono utilizzate le immagini predefinite.If no images are specified, the default images are used. Per nascondere gli indicatori del nodo di espansione, impostare la proprietà ShowExpandCollapse su false.To hide the expansion node indicators, set the ShowExpandCollapse property to false.

Note

Per assicurarsi che i nodi siano allineati correttamente nel controllo TreeView quando si utilizzano immagini personalizzate, assicurarsi che tutte le immagini specificate dalle proprietà NoExpandImageUrl, ExpandImageUrle CollapseImageUrl abbiano le stesse dimensioni.To ensure that nodes align correctly in the TreeView control when using custom images, make sure that all the images that are specified by the NoExpandImageUrl, ExpandImageUrl, and CollapseImageUrl properties have the same dimensions.

Per visualizzare correttamente un'immagine personalizzata, potrebbe essere necessario impostare ShowLines su false.To display a custom image correctly, you may need to set ShowLines to false.

Quando si utilizza un'immagine personalizzata per l'indicatore di nodi espandibili, è consigliabile impostare anche la proprietà ExpandImageToolTip per specificare una descrizione comando per l'immagine.When using a custom image for the expandable node indicator, you should also consider setting the ExpandImageToolTip property to specify a ToolTip for the image.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Applies to

See also