TreeNodeStyle Klasse
Definition
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
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:
RootNodeStyle, ParentNodeStyleoder LeafNodeStyle, je nach Knotentyp.
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) |