TreeView.ExpandImageUrl Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'URL di un'immagine personalizzata per l'indicatore di nodi espandibili.
public:
property System::String ^ ExpandImageUrl { System::String ^ get(); void set(System::String ^ value); };public string ExpandImageUrl { get; set; }member this.ExpandImageUrl : string with get, setPublic Property ExpandImageUrl As StringValore della proprietà
URL di un'immagine personalizzata per visualizzare i nodi espandibili. Il valore predefinito è una stringa vuota ("") che visualizza l'immagine predefinita del segno più (+).
Esempio
Nell'esempio di codice seguente viene illustrato come usare la ExpandImageUrl proprietà per specificare un'immagine personalizzata per l'indicatore del nodo espandibile. Per visualizzare l'esempio di codice e l'immagine da visualizzare nel controllo, è necessario specificare l'immagine personalizzata e la ImageSet proprietà deve essere impostata su 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>
Commenti
Utilizzare la ExpandImageUrl proprietà per specificare un'immagine personalizzata per l'indicatore del nodo espandibile. Questa immagine viene visualizzata accanto a un nodo espandibile ed è in genere un segno più (+).
Quando la ShowExpandCollapse proprietà è impostata su true, il TreeView controllo visualizza rispettivamente 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. È possibile specificare immagini personalizzate impostando prima la ImageSet proprietà su TreeViewImageSet.Custome quindi impostando le NoExpandImageUrlproprietà , ExpandImageUrle CollapseImageUrl sugli URL per le immagini personalizzate. Se non vengono specificate immagini, vengono usate le immagini predefinite. Per nascondere gli indicatori del nodo di espansione, impostare la ShowExpandCollapse proprietà su false.
Nota
Per assicurarsi che i nodi siano allineati correttamente nel TreeView controllo quando si usano immagini personalizzate, assicurarsi che tutte le immagini specificate dalle NoExpandImageUrlproprietà , ExpandImageUrle CollapseImageUrl abbiano le stesse dimensioni.
Per visualizzare correttamente un'immagine personalizzata, potrebbe essere necessario impostare ShowLines su false.
Quando si usa un'immagine personalizzata per l'indicatore del nodo espandibile, è anche consigliabile impostare la ExpandImageToolTip proprietà per specificare una descrizione comando per l'immagine.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
