TreeNodeStyle Clase

Definición

Representa el estilo de un nodo en el control TreeView.Represents the style of a node in the TreeView control.

public ref class TreeNodeStyle sealed : System::Web::UI::WebControls::Style
public sealed class TreeNodeStyle : System.Web.UI.WebControls.Style
type TreeNodeStyle = class
    inherit Style
Public NotInheritable Class TreeNodeStyle
Inherits Style
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo controlar la apariencia de los nodos primarios en el TreeView control estableciendo las propiedades de estilo del TreeNodeStyle objeto devuelto por la ParentNodeStyle propiedad.The following code example demonstrates how to control the appearance of the parent nodes in the TreeView control by setting the style properties of the TreeNodeStyle object that is returned from the ParentNodeStyle property.


<%@ 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

Use la TreeNodeStyle clase para representar el estilo de un nodo en el TreeView control.Use the TreeNodeStyle class to represent the style of a node in the TreeView control. El TreeView control permite especificar diferentes características de estilo (como el color y el tamaño de la fuente) para cada uno de los distintos tipos de nodo.The TreeView control allows you to specify different style characteristics (such as font size and color) for each of the different node types.

En la tabla siguiente se enumeran los estilos de nodo admitidos por la TreeNodeStyle clase.The following table lists the node styles that are supported by the TreeNodeStyle class.

Propiedad de estilo de nodoNode style property DescripciónDescription
HoverNodeStyle Configuración de estilo de un nodo cuando el puntero del mouse se coloca sobre él.The style settings for a node when the mouse pointer is positioned over it.
LeafNodeStyle La configuración de estilo de los nodos hoja.The style settings for the leaf nodes.
NodeStyle La configuración de estilo predeterminada para un nodo.The default style settings for a node.
ParentNodeStyle La configuración de estilo para los nodos primarios.The style settings for the parent nodes.
RootNodeStyle La configuración de estilo para el nodo raíz.The style settings for the root node.
SelectedNodeStyle La configuración de estilo para un nodo seleccionado.The style settings for a selected node.

Al establecer las propiedades de estilo de nodo del TreeView control, se aplican en el orden siguiente:When you set the node style properties of the TreeView control, they are applied in the following order:

  1. NodeStyle.NodeStyle.

  2. RootNodeStyle, ParentNodeStyle o LeafNodeStyle , dependiendo del tipo de nodo.RootNodeStyle, ParentNodeStyle, or LeafNodeStyle, depending on the node type.

  3. LevelStyles.LevelStyles.

  4. SelectedNodeStyle.SelectedNodeStyle.

  5. HoverNodeStyle.HoverNodeStyle.

La TreeNodeStyle clase hereda la mayoría de sus miembros de la Style clase.The TreeNodeStyle class inherits most of its members from the Style class. Extiende la Style clase proporcionando propiedades que controlan la cantidad de espacio alrededor del texto de un nodo, así como el espacio entre los nodos adyacentes.It extends the Style class by providing properties that control the amount of space around the text in a node, as well as the space between adjacent nodes. Utilice la HorizontalPadding propiedad para controlar la cantidad de espacio a la izquierda y a la derecha del texto de un nodo.Use the HorizontalPadding property to control the amount of space to the left and right of the text in a node. Del mismo modo, la VerticalPadding propiedad controla la cantidad de espacio por encima y por debajo del texto de un nodo.Similarly, the VerticalPadding property controls the amount of space above and below the text in a node. Puede controlar la cantidad de espacio entre el nodo TreeNodeStyle al que se aplica y sus nodos adyacentes estableciendo la NodeSpacing propiedad.You can control the amount of spacing between the node that the TreeNodeStyle is applied to and its adjacent nodes by setting the NodeSpacing property. Para controlar la cantidad de espacio entre un nodo primario y un nodo secundario, utilice la ChildNodesPadding propiedad.To control the amount of spacing between a parent node and a child node, use the ChildNodesPadding property.

Para obtener más información acerca de la configuración de estilo heredada, vea Style .For more information about the inherited style settings, see Style.

Constructores

TreeNodeStyle()

Inicializa una nueva instancia de la clase TreeNodeStyle.Initializes a new instance of the TreeNodeStyle class.

TreeNodeStyle(StateBag)

Inicializa una instancia nueva de la clase TreeNodeStyle con la información del objeto StateBag especificado.Initializes a new instance of the TreeNodeStyle class with the specified StateBag object information.

Propiedades

BackColor

Obtiene o establece el color de fondo del control de servidor web.Gets or sets the background color of the Web server control.

(Heredado de Style)
BorderColor

Obtiene o establece el color del borde del control de servidor Web.Gets or sets the border color of the Web server control.

(Heredado de Style)
BorderStyle

Obtiene o establece el estilo del borde del control de servidor web.Gets or sets the border style of the Web server control.

(Heredado de Style)
BorderWidth

Obtiene o establece el ancho del borde del control de servidor web.Gets or sets the border width of the Web server control.

(Heredado de Style)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
ChildNodesPadding

Obtiene o establece la cantidad de espacio entre un nodo primario y un nodo secundario a los que se aplica la clase TreeNodeStyle.Gets or sets the amount of space between a parent node and a child node to which the TreeNodeStyle class is applied.

Container

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Heredado de Component)
CssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) representada por el control de servidor Web en el cliente.Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client.

(Heredado de Style)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
Font

Obtiene las propiedades de fuente asociadas al control de servidor web.Gets the font properties associated with the Web server control.

(Heredado de Style)
ForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Heredado de Style)
Height

Obtiene o establece el alto del control de servidor Web.Gets or sets the height of the Web server control.

(Heredado de Style)
HorizontalPadding

Obtiene o establece la cantidad de espacio a la izquierda y derecha del texto del nodo.Gets or sets the amount of space to the left and right of the text in the node.

ImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra al lado del nodo.Gets or sets the URL to an image that is displayed next to the node.

IsEmpty

Propiedad protegida.A protected property. Obtiene un valor que indica si se han definido elementos de estilo en la bolsa de estados.Gets a value indicating whether any style elements have been defined in the state bag.

(Heredado de Style)
IsTrackingViewState

Devuelve un valor que indica si se han definido elementos de estilo en la bolsa de estados.Returns a value indicating whether any style elements have been defined in the state bag.

(Heredado de Style)
NodeSpacing

Obtiene o establece la cantidad de espaciado vertical entre el nodo al que se aplica el objeto TreeNodeStyle y sus nodos adyacentes.Gets or sets the amount of vertical spacing between the node to which the TreeNodeStyle object is applied and its adjacent nodes.

RegisteredCssClass

Obtiene la clase de hoja de estilos en cascada (CSS) que se registra con el control.Gets the cascading style sheet (CSS) class that is registered with the control.

(Heredado de Style)
Site

Obtiene o establece ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
VerticalPadding

Obtiene o establece la cantidad de espacio por encima y debajo del texto de un nodo.Gets or sets the amount of space above and below the text for a node.

ViewState

Obtiene la bolsa de estados que contiene los elementos de estilo.Gets the state bag that holds the style elements.

(Heredado de Style)
Width

Obtiene o establece el ancho del control de servidor web.Gets or sets the width of the Web server control.

(Heredado de Style)

Métodos

AddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriter especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter. Este método lo usan principalmente los programadores de controles.This method is primarily used by control developers.

(Heredado de Style)
AddAttributesToRender(HtmlTextWriter, WebControl)

Agrega al objeto HtmlTextWriter y al control de servidor Web especificados los atributos y estilos HTML que se deben representar.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter and Web server control. Este método lo usan principalmente los programadores de controles.This method is primarily used by control developers.

(Heredado de Style)
CopyFrom(Style)

Copia las propiedades de estilo del objeto Style especificado al objeto TreeNodeStyle actual.Copies the style properties of the specified Style object into the current TreeNodeStyle object.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)

Agrega las propiedades de estilo del objeto especificado a un objeto CssStyleCollection.Adds the specified object's style properties to a CssStyleCollection object.

(Heredado de Style)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()
Obsoleto.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetStyleAttributes(IUrlResolutionService)

Recupera el objeto CssStyleCollection para el objeto implementado por IUrlResolutionService especificado.Retrieves the CssStyleCollection object for the specified IUrlResolutionService-implemented object.

(Heredado de Style)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()
Obsoleto.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
LoadViewState(Object)

Carga el estado previamente guardado.Loads the previously saved state.

(Heredado de Style)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
MergeWith(Style)

Combina las propiedades de estilo del objeto Style especificado con las del objeto TreeNodeStyle actual.Combines the style properties of the specified Style object with the style properties of the current TreeNodeStyle object.

Reset()

Restablece el estado original del objeto TreeNodeStyle.Returns the TreeNodeStyle object to its original state.

SaveViewState()

Método protegido.A protected method. Guarda cualquier estado que se haya modificado después de que se invocara al método TrackViewState().Saves any state that has been modified after the TrackViewState() method was invoked.

(Heredado de Style)
SetBit(Int32)

Método interno protegido.A protected internal method. Establece un campo de máscara de bits interno que indica las propiedades de estilo almacenadas en la bolsa de estados.Sets an internal bitmask field that indicates the style properties that are stored in the state bag.

(Heredado de Style)
SetDirty()

Marca Style para que su estado se registre en el estado de vista.Marks the Style so that its state will be recorded in view state.

(Heredado de Style)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Style)
TrackViewState()

Método protegido.A protected method. Marca el comienzo del seguimiento de los cambios de estado en el control.Marks the beginning for tracking state changes on the control. Los cambios realizados una vez iniciado el seguimiento serán objeto de seguimiento y se guardarán como parte del estado de vista del control.Any changes made after tracking has begun will be tracked and saved as part of the control view state.

(Heredado de Style)

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

Obtiene un valor que indica si un control de servidor está realizando el seguimiento de los cambios en su estado de vista.Gets a value that indicates whether a server control is tracking its view state changes.

(Heredado de Style)
IStateManager.LoadViewState(Object)

Carga el estado previamente guardado.Loads the previously saved state.

(Heredado de Style)
IStateManager.SaveViewState()

Devuelve el objeto que contiene los cambios de estado.Returns the object containing state changes.

(Heredado de Style)
IStateManager.TrackViewState()

Inicia el seguimiento de los cambios de estado.Starts tracking state changes.

(Heredado de Style)

Se aplica a

Consulte también