TreeView.ExpandImageUrl Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la dirección URL a una imagen personalizada para el indicador de nodo expansible.
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
Valor de propiedad
La dirección URL a una imagen personalizada para mostrar para los nodos expansibles. El valor predeterminado es una cadena vacía (""), que muestra la imagen predeterminada del signo más (+).
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ExpandImageUrl propiedad para especificar una imagen personalizada para el indicador de nodo expandible. Para que el ejemplo de código se muestre y la imagen que aparezca en el control , debe proporcionar su propia imagen y la ImageSet propiedad debe establecerse TreeNodeImageSet.Custom
en .
<%@ 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>
Comentarios
Utilice la ExpandImageUrl propiedad para especificar una imagen personalizada para el indicador de nodo expandible. Esta imagen se muestra junto a un nodo expandible y suele ser un signo más (+).
Cuando la ShowExpandCollapse propiedad se establece true
en , el TreeView control muestra un signo más (+) o un signo menos (-) o una imagen de marcador de posición junto a un nodo para indicar si el nodo es expandible, contraíble o no expandible, respectivamente. Puede especificar imágenes personalizadas estableciendo primero la ImageSet propiedad TreeViewImageSet.Custom
en y, a continuación, estableciendo las NoExpandImageUrlpropiedades , ExpandImageUrly CollapseImageUrl en las direcciones URL de las imágenes personalizadas. Si no se especifica ninguna imagen, se usan las imágenes predeterminadas. Para ocultar los indicadores del nodo de expansión, establezca la ShowExpandCollapse propiedad en false
.
Nota
Para asegurarse de que los nodos se alinean correctamente en el TreeView control al usar imágenes personalizadas, asegúrese de que todas las imágenes especificadas por las NoExpandImageUrlpropiedades , ExpandImageUrly CollapseImageUrl tienen las mismas dimensiones.
Para mostrar correctamente una imagen personalizada, es posible que tenga que establecer en ShowLinesfalse
.
Al usar una imagen personalizada para el indicador de nodo expandible, también debe considerar la posibilidad de establecer la ExpandImageToolTip propiedad para especificar una información sobre herramientas para la imagen.
El valor de esta propiedad se almacena en estado de vista.