TreeNodeStyle Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt den Stil eines Knotens im TreeView-Steuerelement dar.

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

Vererbung: Object

MarshalByRefObject

Component

Style
TreeNodeStyle

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Darstellung der übergeordneten Knoten im TreeView Steuerelement steuern, indem Sie die Formateigenschaften des TreeNodeStyle Objekts festlegen, das von der ParentNodeStyle Eigenschaft zurückgegeben wird.


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

Hinweise

Verwenden Sie die TreeNodeStyle Klasse, um die Formatvorlage eines Knotens TreeView im Steuerelement darzustellen. Mit dem TreeView Steuerelement können Sie für jeden der verschiedenen Knotentypen unterschiedliche Formateigenschaften (z. B. Schriftgrad und Farbe) angeben.

In der folgenden Tabelle sind die Knotenformatvorlagen aufgeführt, die von der TreeNodeStyle Klasse unterstützt werden.

Node Style-Eigenschaft	BESCHREIBUNG
HoverNodeStyle	Die Formatvorlageneinstellungen für einen Knoten, wenn der Mauszeiger darüber positioniert wird.
LeafNodeStyle	Die Formatvorlageneinstellungen für die Blattknoten.
NodeStyle	Die Standardformateinstellungen für einen Knoten.
ParentNodeStyle	Die Formatvorlageneinstellungen für die übergeordneten Knoten.
RootNodeStyle	Die Formatvorlageneinstellungen für den Stammknoten.
SelectedNodeStyle	Die Formatvorlageneinstellungen für einen ausgewählten Knoten.

Wenn Sie die Knotenformateigenschaften des TreeView Steuerelements festlegen, werden sie in der folgenden Reihenfolge angewendet:

NodeStyle.
RootNodeStyle, ParentNodeStyleoder LeafNodeStyle, je nach Knotentyp.
LevelStyles.
SelectedNodeStyle.
HoverNodeStyle.

Die TreeNodeStyle Klasse erbt die meisten mitglieder der Style Klasse. Die Klasse wird erweitert Style , indem Eigenschaften bereitgestellt werden, die den Abstand um den Text in einem Knoten sowie den Abstand zwischen angrenzenden Knoten steuern. Verwenden Sie die HorizontalPadding Eigenschaft, um den Abstand links und rechts vom Text in einem Knoten zu steuern. Ebenso steuert die VerticalPadding Eigenschaft den Abstand über und unterhalb des Texts in einem Knoten. Sie können den Abstand zwischen dem Knoten steuern, auf den die TreeNodeStyle Knoten angewendet wird, und die angrenzenden Knoten, indem Sie die NodeSpacing Eigenschaft festlegen. Um den Abstand zwischen einem übergeordneten Knoten und einem untergeordneten Knoten zu steuern, verwenden Sie die ChildNodesPadding Eigenschaft.

Weitere Informationen zu den geerbten Formatvorlageneinstellungen finden Sie unter Style.

Konstruktoren

TreeNodeStyle()	Initialisiert eine neue Instanz der TreeNodeStyle-Klasse.
TreeNodeStyle(StateBag)	Initialisiert eine neue Instanz der TreeNodeStyle-Klasse mit den angegebenen Informationen für das StateBag-Objekt.

Eigenschaften

BackColor	Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
BorderColor	Ruft die Rahmenfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
BorderStyle	Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
BorderWidth	Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
ChildNodesPadding	Ruft den Abstand zwischen einem übergeordneten Knoten und einem untergeordneten Knoten ab, auf den die TreeNodeStyle-Klasse angewendet wird.
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
CssClass	Ruft die vom Webserver-Steuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Geerbt von Style)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
Font	Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von Style)
ForeColor	Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Geerbt von Style)
Height	Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
HorizontalPadding	Ruft den Abstand links und rechts vom Text des Knotens ab oder legt diesen fest.
ImageUrl	Ruft die URL zu einem Bild ab, das neben dem Knoten angezeigt wird, oder legt diese URL fest.
IsEmpty	Eine geschützte Eigenschaft. Ruft einen Wert ab, der angibt, ob in der Datenauflistung Stilelemente definiert wurden. (Geerbt von Style)
IsTrackingViewState	Gibt einen Wert zurück, der angibt, ob in der Datenauflistung Stilelemente definiert wurden. (Geerbt von Style)
NodeSpacing	Ruft den vertikalen Abstand zwischen dem Knoten, auf den das TreeNodeStyle-Objekt angewendet wird, und den benachbarten Knoten ab oder legt diesen Abstand fest.
RegisteredCssClass	Ruft die für das Steuerelement registrierte CSS-Klasse (Cascading Style Sheet) ab. (Geerbt von Style)
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
VerticalPadding	Ruft den Abstand oberhalb und unterhalb des Texts in einem Knoten ab oder legt diesen Abstand fest.
ViewState	Ruft die Datenauflistung ab, die die Stilelemente enthält. (Geerbt von Style)
Width	Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest. (Geerbt von Style)

Methoden

AddAttributesToRender(HtmlTextWriter)	Fügt dem angegebenen HtmlTextWriter die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von Style)
AddAttributesToRender(HtmlTextWriter, WebControl)	Fügt dem angegebenen HtmlTextWriter und dem Webserver-Steuerelement die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von Style)
CopyFrom(Style)	Kopiert die Stileigenschaften des angegebenen Style-Objekts in das aktuelle TreeNodeStyle-Objekt.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	Fügt einem CssStyleCollection-Objekt die Stileigenschaften des angegebenen Objekts hinzu. (Geerbt von Style)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetStyleAttributes(IUrlResolutionService)	Ruft das CssStyleCollection-Objekt für das angegebene, von IUrlResolutionService implementierte Objekt ab. (Geerbt von Style)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand. (Geerbt von Style)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
MergeWith(Style)	Kombiniert die Stileigenschaften des angegebenen Style-Objekts mit den Stileigenschaften des aktuellen TreeNodeStyle-Objekts.
Reset()	Setzt das TreeNodeStyle-Objekt auf den ursprünglichen Zustand zurück.
SaveViewState()	Eine geschützte Methode. Speichert jeden Zustand, der nach dem Aufruf der TrackViewState()-Methode geändert wurde. (Geerbt von Style)
SetBit(Int32)	Eine geschützte interne Methode. Legt ein internes Bitmaskenfeld fest, das die in der Datenauflistung gespeicherten Stileigenschaften angibt. (Geerbt von Style)
SetDirty()	Markiert den Style, damit sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Style)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Style)
TrackViewState()	Eine geschützte Methode. Markiert den Beginn der Verfolgung von Zustandsänderungen für das Steuerelement. Alle Änderungen nach Beginn der Nachverfolgung werden nachverfolgt und als Teil des Ansichtszustands des Steuerelements gespeichert. (Geerbt von Style)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob ein Serversteuerelement Änderungen des Ansichtszustands nachverfolgt. (Geerbt von Style)
IStateManager.LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand. (Geerbt von Style)
IStateManager.SaveViewState()	Gibt das Objekt zurück, das Zustandsänderungen enthält. (Geerbt von Style)
IStateManager.TrackViewState()	Startet das Verfolgen von Zustandsänderungen. (Geerbt von Style)

Gilt für