TreeNodeStyle Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa o estilo de um nó no controle TreeView.

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

Herança: Object

MarshalByRefObject

Component

Style
TreeNodeStyle

Exemplos

O exemplo de código a seguir demonstra como controlar a aparência dos nós pai no TreeView controle definindo as propriedades de estilo do TreeNodeStyle objeto que é retornado da ParentNodeStyle propriedade.


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

Comentários

Use a TreeNodeStyle classe para representar o estilo de um nó no TreeView controle. O TreeView controle permite que você especifique diferentes características de estilo (como tamanho e cor da fonte) para cada um dos diferentes tipos de nó.

A tabela a seguir lista os estilos de nó compatíveis com a TreeNodeStyle classe.

Propriedade de estilo de nó	Descrição
HoverNodeStyle	As configurações de estilo de um nó quando o ponteiro do mouse é posicionado sobre ele.
LeafNodeStyle	As configurações de estilo para os nós folha.
NodeStyle	As configurações de estilo padrão para um nó.
ParentNodeStyle	As configurações de estilo para os nós pai.
RootNodeStyle	As configurações de estilo do nó raiz.
SelectedNodeStyle	As configurações de estilo de um nó selecionado.

Quando você define as propriedades de estilo de nó do TreeView controle, elas são aplicadas na seguinte ordem:

NodeStyle.
RootNodeStyle, ParentNodeStyleou LeafNodeStyle, dependendo do tipo de nó.
LevelStyles.
SelectedNodeStyle.
HoverNodeStyle.

A TreeNodeStyle classe herda a maioria de seus membros da Style classe. Ele estende a Style classe fornecendo propriedades que controlam a quantidade de espaço ao redor do texto em um nó, bem como o espaço entre nós adjacentes. Use a HorizontalPadding propriedade para controlar a quantidade de espaço à esquerda e à direita do texto em um nó. Da mesma forma, a VerticalPadding propriedade controla a quantidade de espaço acima e abaixo do texto em um nó. Você pode controlar a quantidade de espaçamento entre o nó ao qual o TreeNodeStyle nó é aplicado e seus nós adjacentes definindo a NodeSpacing propriedade. Para controlar a quantidade de espaçamento entre um nó pai e um nó filho, use a ChildNodesPadding propriedade.

Para obter mais informações sobre as configurações de estilo herdadas, consulte Style.

Construtores

TreeNodeStyle()	Inicializa uma nova instância da classe TreeNodeStyle.
TreeNodeStyle(StateBag)	Inicializa uma nova instância da classe TreeNodeStyle com as informações do objeto StateBag especificado.

Propriedades

BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de Style)
BorderColor	Obtém ou define a cor de borda do controle de servidor Web. (Herdado de Style)
BorderStyle	Obtém ou define o estilo de borda do controle de servidor Web. (Herdado de Style)
BorderWidth	Obtém ou define a largura da borda do controle de servidor Web. (Herdado de Style)
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
ChildNodesPadding	Obtém ou define a quantidade de espaço entre um nó pai e um nó filho para o qual o TreeNodeStyle classe é aplicada.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
CssClass	Obtém ou define a classe CSS (folha de estilos em cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de Style)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de Style)
ForeColor	Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de Style)
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de Style)
HorizontalPadding	Obtém ou define a quantidade de espaço à esquerda e à direita do texto no nó.
ImageUrl	Obtém ou define a URL para uma imagem exibida ao lado do nó.
IsEmpty	Uma propriedade protegida. Obtém um valor que indica se algum elemento de estilo foi definido no recipiente de estados. (Herdado de Style)
IsTrackingViewState	Retorna um valor que indica se algum elemento de estilo foi definido no recipiente de estados. (Herdado de Style)
NodeSpacing	Obtém ou define a quantidade de espaçamento vertical entre o nó ao qual o objeto TreeNodeStyle será aplicado e seus nós adjacentes.
RegisteredCssClass	Obtém a classe CSS (folha de estilos em cascata) que está registrada com o controle. (Herdado de Style)
Site	Obtém ou define o ISite do Component. (Herdado de Component)
VerticalPadding	Obtém ou define a quantidade de espaço acima e abaixo do texto de um nó.
ViewState	Obtém o recipiente de estados que contém os elementos de estilo. (Herdado de Style)
Width	Obtém ou define a largura do controle de servidor Web. (Herdado de Style)

Métodos

AddAttributesToRender(HtmlTextWriter)	Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriter especificado. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de Style)
AddAttributesToRender(HtmlTextWriter, WebControl)	Adiciona atributos HTML e estilos que precisam ser renderizados ao controle de servidor Web HtmlTextWriter especificado. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de Style)
CopyFrom(Style)	Copia as propriedades de estilo do Style objeto atual TreeNodeStyle objeto.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	Adiciona as propriedades de estilo do objeto especificado a um objeto CssStyleCollection. (Herdado de Style)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetStyleAttributes(IUrlResolutionService)	Recupera o objeto CssStyleCollection especificado objeto implementado por IUrlResolutionService. (Herdado de Style)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
LoadViewState(Object)	Carrega o estado salvo anteriormente. (Herdado de Style)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MergeWith(Style)	Combina as propriedades de estilo do Style objeto com as propriedades de estilo do atual TreeNodeStyle objeto.
Reset()	Retorna o TreeNodeStyle objeto ao seu estado original.
SaveViewState()	Um método protegido. Salva qualquer estado que tenha sido modificado depois que o método TrackViewState() foi invocado. (Herdado de Style)
SetBit(Int32)	Um método interno protegido. Define um campo interno de máscara de bits que indica as propriedades de estilo que estão armazenadas no recipiente de estados. (Herdado de Style)
SetDirty()	Marca o Style de maneira que seu estado seja registrado na exibição de estado. (Herdado de Style)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Style)
TrackViewState()	Um método protegido. Marca o início para controlar alterações de estado no controle. Todas as alterações feitas após o início do acompanhamento serão acompanhadas e salvas como parte do estado de exibição do controle. (Herdado de Style)

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().

(Herdado de Component)

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Obtém um valor que indica se um controle de servidor está acompanhando as alterações de estado de exibição. (Herdado de Style)
IStateManager.LoadViewState(Object)	Carrega o estado salvo anteriormente. (Herdado de Style)
IStateManager.SaveViewState()	Retorna o objeto que contém as alterações de estado. (Herdado de Style)
IStateManager.TrackViewState()	Inicia o controle de alterações de estado. (Herdado de Style)

Aplica-se a

Partilhar via