TreeNodeStyle.NodeSpacing 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 cantidad de espaciado vertical entre el nodo al que se aplica el objeto TreeNodeStyle y sus nodos adyacentes.
public:
property System::Web::UI::WebControls::Unit NodeSpacing { System::Web::UI::WebControls::Unit get(); void set(System::Web::UI::WebControls::Unit value); };
public System.Web.UI.WebControls.Unit NodeSpacing { get; set; }
member this.NodeSpacing : System.Web.UI.WebControls.Unit with get, set
Public Property NodeSpacing As Unit
Valor de propiedad
La cantidad de espacio vertical, en píxeles, entre el nodo al que se aplica TreeNodeStyle y sus nodos adyacentes en el mismo nivel. El valor predeterminado es 0 píxeles.
Excepciones
El valor seleccionado es de tipo Percentage o menor que 0
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la NodeSpacing propiedad para especificar el espaciado vertical entre un nodo y sus nodos adyacentes en el mismo nivel del árbol.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void HorizontalPadding_Changed(Object sender, EventArgs e)
{
// Programmatically set the HorizontalPadding property based on the
// user's selection.
ItemsTreeView.ParentNodeStyle.HorizontalPadding = Convert.ToInt32(HorizontalPaddingList.SelectedItem.Text);
}
void VerticalPadding_Changed(Object sender, EventArgs e)
{
// Programmatically set the VerticalPadding property based on the
// user's selection.
ItemsTreeView.ParentNodeStyle.VerticalPadding = Convert.ToInt32(VerticalPaddingList.SelectedItem.Text);
}
void NodeSpacing_Changed(Object sender, EventArgs e)
{
// Programmatically set the NodeSpacing property based on the
// user's selection.
ItemsTreeView.ParentNodeStyle.NodeSpacing = Convert.ToInt32(NodeSpacingList.SelectedItem.Text);
}
void ChildNodePadding_Changed(Object sender, EventArgs e)
{
// Programmatically set the ChildNodesPadding property based on the
// user's selection.
ItemsTreeView.ParentNodeStyle.ChildNodesPadding = Convert.ToInt32(ChildNodesPaddingList.SelectedItem.Text);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNodeStyle Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeStyle Example</h3>
<!-- Set the styles for the leaf nodes declaratively. -->
<asp:TreeView id="ItemsTreeView"
Font-Names= "Arial"
ForeColor="Blue"
ParentNodeStyle-ForeColor="Green"
ParentNodeStyle-HorizontalPadding="5"
ParentNodeStyle-VerticalPadding="5"
ParentNodeStyle-NodeSpacing="5"
ParentNodeStyle-ChildNodesPadding="5"
ExpandDepth="4"
runat="server">
<Nodes>
<asp:TreeNode Text="Table of Contents"
SelectAction="None">
<asp:TreeNode Text="Chapter One">
<asp:TreeNode Text="Section 1.0">
<asp:TreeNode Text="Topic 1.0.1"/>
<asp:TreeNode Text="Topic 1.0.2"/>
<asp:TreeNode Text="Topic 1.0.3"/>
</asp:TreeNode>
<asp:TreeNode Text="Section 1.1">
<asp:TreeNode Text="Topic 1.1.1"/>
<asp:TreeNode Text="Topic 1.1.2"/>
<asp:TreeNode Text="Topic 1.1.3"/>
<asp:TreeNode Text="Topic 1.1.4"/>
</asp:TreeNode>
</asp:TreeNode>
</asp:TreeNode>
</Nodes>
</asp:TreeView>
<hr />
<h5>Select the style settings for the parent nodes.</h5>
<table cellpadding="5">
<tr align="right">
<td>
Horizontal Padding:
<asp:DropDownList id="HorizontalPaddingList"
AutoPostBack="true"
OnSelectedIndexChanged="HorizontalPadding_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
<td>
Vertical Padding:
<asp:DropDownList id="VerticalPaddingList"
AutoPostBack="true"
OnSelectedIndexChanged="VerticalPadding_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
<tr align="right">
<td>
Node Spacing:
<asp:DropDownList id="NodeSpacingList"
AutoPostBack="true"
OnSelectedIndexChanged="NodeSpacing_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
<td>
Child Nodes Padding:
<asp:DropDownList id="ChildNodesPaddingList"
AutoPostBack="true"
OnSelectedIndexChanged="ChildNodePadding_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</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">
<script runat="server">
Sub HorizontalPadding_Changed(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically set the HorizontalPadding property based on the
' user's selection.
ItemsTreeView.ParentNodeStyle.HorizontalPadding = Convert.ToInt32(HorizontalPaddingList.SelectedItem.Text)
End Sub
Sub VerticalPadding_Changed(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically set the VerticalPadding property based on the
' user's selection.
ItemsTreeView.ParentNodeStyle.VerticalPadding = Convert.ToInt32(VerticalPaddingList.SelectedItem.Text)
End Sub
Sub NodeSpacing_Changed(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically set the NodeSpacing property based on the
' user's selection.
ItemsTreeView.ParentNodeStyle.NodeSpacing = Convert.ToInt32(NodeSpacingList.SelectedItem.Text)
End Sub
Sub ChildNodePadding_Changed(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically set the ChildNodesPadding property based on the
' user's selection.
ItemsTreeView.ParentNodeStyle.ChildNodesPadding = Convert.ToInt32(ChildNodesPaddingList.SelectedItem.Text)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNodeStyle Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeStyle Example</h3>
<!-- Set the styles for the leaf nodes declaratively. -->
<asp:TreeView id="ItemsTreeView"
Font-Names= "Arial"
ForeColor="Blue"
ParentNodeStyle-ForeColor="Green"
ParentNodeStyle-HorizontalPadding="5"
ParentNodeStyle-VerticalPadding="5"
ParentNodeStyle-NodeSpacing="5"
ParentNodeStyle-ChildNodesPadding="5"
ExpandDepth="4"
runat="server">
<Nodes>
<asp:TreeNode Text="Table of Contents"
SelectAction="None">
<asp:TreeNode Text="Chapter One">
<asp:TreeNode Text="Section 1.0">
<asp:TreeNode Text="Topic 1.0.1"/>
<asp:TreeNode Text="Topic 1.0.2"/>
<asp:TreeNode Text="Topic 1.0.3"/>
</asp:TreeNode>
<asp:TreeNode Text="Section 1.1">
<asp:TreeNode Text="Topic 1.1.1"/>
<asp:TreeNode Text="Topic 1.1.2"/>
<asp:TreeNode Text="Topic 1.1.3"/>
<asp:TreeNode Text="Topic 1.1.4"/>
</asp:TreeNode>
</asp:TreeNode>
</asp:TreeNode>
</Nodes>
</asp:TreeView>
<hr />
<h5>Select the style settings for the parent nodes.</h5>
<table cellpadding="5">
<tr align="right">
<td>
Horizontal Padding:
<asp:DropDownList id="HorizontalPaddingList"
AutoPostBack="true"
OnSelectedIndexChanged="HorizontalPadding_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
<td>
Vertical Padding:
<asp:DropDownList id="VerticalPaddingList"
AutoPostBack="true"
OnSelectedIndexChanged="VerticalPadding_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
<tr align="right">
<td>
Node Spacing:
<asp:DropDownList id="NodeSpacingList"
AutoPostBack="true"
OnSelectedIndexChanged="NodeSpacing_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
<td>
Child Nodes Padding:
<asp:DropDownList id="ChildNodesPaddingList"
AutoPostBack="true"
OnSelectedIndexChanged="ChildNodePadding_Changed"
runat="server">
<asp:ListItem>0</asp:ListItem>
<asp:ListItem Selected="true">5</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
Comentarios
Utilice la NodeSpacing propiedad para controlar la cantidad de espaciado vertical entre un nodo al que TreeNodeStyle se aplica y sus nodos adyacentes en el mismo nivel. Este espacio se inserta entre el borde superior del nodo actual y el borde inferior del nodo anterior, así como entre el borde inferior del nodo actual y el borde superior del nodo siguiente. El espacio superior no se representa para el primer nodo del TreeView control, ya que esto dejaría un espacio innecesario en la parte superior del control.
Las NodeSpacing propiedades y ChildNodesPadding se aplican de forma independiente. Si el nodo se expande o no no afecta al espaciado del nodo.
El valor de esta propiedad se almacena en estado de vista.