TreeNodeStyle Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente le style d’un nœud dans le contrôle 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

Héritage: Object

MarshalByRefObject

Component

Style
TreeNodeStyle

Exemples

L’exemple de code suivant montre comment contrôler l’apparence des nœuds parents dans le TreeView contrôle en définissant les propriétés de style de l’objet TreeNodeStyle retourné par la ParentNodeStyle propriété.


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

Remarques

Utilisez la TreeNodeStyle classe pour représenter le style d’un nœud dans le TreeView contrôle. Le TreeView contrôle vous permet de spécifier différentes caractéristiques de style (telles que la taille et la couleur de police) pour chacun des différents types de nœuds.

Le tableau suivant répertorie les styles de nœud pris en charge par la TreeNodeStyle classe.

Propriété de style de nœud	Description
HoverNodeStyle	Paramètres de style d’un nœud lorsque le pointeur de la souris est positionné sur celui-ci.
LeafNodeStyle	Paramètres de style pour les nœuds feuilles.
NodeStyle	Paramètres de style par défaut d’un nœud.
ParentNodeStyle	Paramètres de style pour les nœuds parents.
RootNodeStyle	Paramètres de style du nœud racine.
SelectedNodeStyle	Paramètres de style d’un nœud sélectionné.

Lorsque vous définissez les propriétés de style de nœud du TreeView contrôle, elles sont appliquées dans l’ordre suivant :

NodeStyle.
RootNodeStyle, ou ParentNodeStyle, en LeafNodeStylefonction du type de nœud.
LevelStyles.
SelectedNodeStyle.
HoverNodeStyle.

La TreeNodeStyle classe hérite de la plupart de ses membres de la Style classe. Il étend la Style classe en fournissant des propriétés qui contrôlent la quantité d’espace autour du texte dans un nœud, ainsi que l’espace entre les nœuds adjacents. Utilisez la HorizontalPadding propriété pour contrôler la quantité d’espace à gauche et à droite du texte dans un nœud. De même, la VerticalPadding propriété contrôle la quantité d’espace ci-dessus et sous le texte d’un nœud. Vous pouvez contrôler la quantité d’espacement entre le nœud auquel le TreeNodeStyle nœud est appliqué et ses nœuds adjacents en définissant la NodeSpacing propriété. Pour contrôler la quantité d’espacement entre un nœud parent et un nœud enfant, utilisez la ChildNodesPadding propriété.

Pour plus d’informations sur les paramètres de style hérités, consultez Style.

Constructeurs

TreeNodeStyle()	Initialise une nouvelle instance de la classe TreeNodeStyle.
TreeNodeStyle(StateBag)	Initialise une nouvelle instance de la classe TreeNodeStyle à l'aide des informations de l'objet StateBag.

Propriétés

BackColor	Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de Style)
BorderColor	Obtient ou définit la couleur de bordure du contrôle serveur Web. (Hérité de Style)
BorderStyle	Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de Style)
BorderWidth	Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de Style)
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
ChildNodesPadding	Obtient ou définit l'espace entre un nœud parent et un nœud enfant auquel la classe TreeNodeStyle est appliquée.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
CssClass	Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de Style)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de Style)
ForeColor	Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de Style)
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de Style)
HorizontalPadding	Obtient ou définit l'espace à gauche et droite du texte de l'élément du nœud.
ImageUrl	Obtient ou définit l'URL vers une image qui est affichée en regard du nœud.
IsEmpty	Propriété protégée. Récupère une valeur indiquant si des éléments de style ont été définis dans le sac d'états. (Hérité de Style)
IsTrackingViewState	Retourne une valeur indiquant si des éléments de style ont été définis dans le sac d'états. (Hérité de Style)
NodeSpacing	Obtient ou définit l'espacement vertical entre le nœud auquel l'objet TreeNodeStyle est appliqué et ses nœuds adjacents.
RegisteredCssClass	Obtient la classe de feuille de style en cascade (CSS, Cascading Style Sheet) qui est enregistrée avec le contrôle. (Hérité de Style)
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
VerticalPadding	Obtient ou définit l'espace au-dessus et en dessous du texte d'un nœud.
ViewState	Obtient le sac d'états qui contient les éléments de style. (Hérité de Style)
Width	Obtient ou définit la largeur du contrôle serveur web. (Hérité de Style)

Méthodes

AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriter spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de Style)
AddAttributesToRender(HtmlTextWriter, WebControl)	Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriter et au contrôle serveur Web spécifiés. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de Style)
CopyFrom(Style)	Copie les propriétés de style de l'objet Style spécifié dans l'objet TreeNodeStyle actuel.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	Ajoute les propriétés de style de l'objet spécifié à un objet CssStyleCollection. (Hérité de Style)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetStyleAttributes(IUrlResolutionService)	Récupère l'objet CssStyleCollection pour l'objet implémentant IUrlResolutionService spécifié. (Hérité de Style)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
LoadViewState(Object)	Charge l'état enregistré précédemment. (Hérité de Style)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
MergeWith(Style)	Combine les propriétés de style de l'objet Style spécifié avec les propriétés de style de l'objet TreeNodeStyle actuel.
Reset()	Retourne l'état d'origine de l'objet TreeNodeStyle.
SaveViewState()	Méthode protégée. Enregistre les états qui ont été modifiés après l'appel de la méthode TrackViewState(). (Hérité de Style)
SetBit(Int32)	Méthode interne protégée. Définit un champ de masque de bits interne qui indique les propriétés de style stockées dans le sac d'états. (Hérité de Style)
SetDirty()	Marque le Style afin que son état soit enregistré dans l'état d'affichage. (Hérité de Style)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Style)
TrackViewState()	Méthode protégée. Marque le début du suivi des modifications d'état sur le contrôle. Toutes les modifications effectuées une fois que le traçage a commencé seront suivies et enregistrées dans le cadre de l'état d'affichage du contrôle. (Hérité de Style)

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState	Obtient une valeur qui indique si un contrôle serveur effectue le suivi des modifications apportées à son état d'affichage. (Hérité de Style)
IStateManager.LoadViewState(Object)	Charge l'état enregistré précédemment. (Hérité de Style)
IStateManager.SaveViewState()	Retourne l'objet contenant les modifications de l'état. (Hérité de Style)
IStateManager.TrackViewState()	Commence à suivre les modifications d'état. (Hérité de Style)

S’applique à