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 die Formatvorlage 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 die Darstellung der übergeordneten Knoten im TreeView Steuerelement gesteuert wird, indem die Formateigenschaften des TreeNodeStyle Objekts festgelegt werden, 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 Eigenschaften des Knotenstils des TreeView Steuerelements festlegen, werden sie in der folgenden Reihenfolge angewendet:
RootNodeStyle, ParentNodeStyleoder LeafNodeStyle, je nach Knotentyp.
Die TreeNodeStyle Klasse erbt die meisten member von der Style Klasse. Sie erweitert die Style Klasse, indem Eigenschaften bereitgestellt werden, die den Abstand um den Text in einem Knoten sowie den Abstand zwischen benachbarten Knoten steuern. Verwenden Sie die HorizontalPadding Eigenschaft, um den Abstand links und rechts vom Text in einem Knoten zu steuern. Entsprechend 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 der TreeNodeStyle Knoten angewendet wird, und den angrenzenden Knoten, indem Sie die NodeSpacing Eigenschaft festlegen. Verwenden Sie die ChildNodesPadding Eigenschaft, um den Abstand zwischen einem übergeordneten Knoten und einem untergeordneten Knoten zu steuern.
Weitere Informationen zu den geerbten Formatvorlageneinstellungen finden Sie unter Style.
Konstruktoren
| Name | Beschreibung |
|---|---|
| TreeNodeStyle() |
Initialisiert eine neue Instanz der TreeNodeStyle-Klasse. |
| TreeNodeStyle(StateBag) |
Initialisiert eine neue Instanz der TreeNodeStyle Klasse mit den angegebenen StateBag Objektinformationen. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| BackColor |
Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von Style) |
| BorderColor |
Ruft die Rahmenfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style) |
| BorderStyle |
Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (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 Klasse angewendet wird, oder legt diesen TreeNodeStyle fest. |
| Container |
Ruft das, das IContainer die Component. (Geerbt von Component) |
| CssClass |
Ruft die css-Klasse (Cascading Stylesheet) ab, die vom Webserversteuerelement auf dem Client gerendert wird, oder legt sie fest. (Geerbt von Style) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet. (Geerbt von Component) |
| Events |
Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von Style) |
| ForeColor |
Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest. (Geerbt von Style) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von Style) |
| HorizontalPadding |
Ruft den Abstand links und rechts vom Text im Knoten ab oder legt diesen fest. |
| ImageUrl |
Dient zum Abrufen oder Festlegen der URL auf ein Bild, das neben dem Knoten angezeigt wird. |
| IsEmpty |
Eine geschützte Eigenschaft. Ruft einen Wert ab, der angibt, ob Stilelemente im Zustandsbehälter definiert wurden. (Geerbt von Style) |
| IsTrackingViewState |
Gibt einen Wert zurück, der angibt, ob elemente im Zustandsbehälter definiert wurden. (Geerbt von Style) |
| NodeSpacing |
Dient zum Abrufen oder Festlegen des vertikalen Abstands zwischen dem Knoten, auf den das TreeNodeStyle Objekt angewendet wird, und seinen angrenzenden Knoten. |
| RegisteredCssClass |
Ruft die Css-Klasse (Cascading Stylesheet) ab, die beim Steuerelement registriert ist. (Geerbt von Style) |
| Site |
Dient zum ISite Abrufen oder Festlegen des Werts des Component. (Geerbt von Component) |
| VerticalPadding |
Ruft den Abstand über und unterhalb des Texts für einen Knoten ab oder legt diese fest. |
| ViewState |
Ruft den Zustandsbehälter ab, der die Formatvorlagenelemente enthält. (Geerbt von Style) |
| Width |
Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von Style) |
Methoden
| Name | Beschreibung |
|---|---|
| AddAttributesToRender(HtmlTextWriter, WebControl) |
Fügt HTML-Attribute und -Formatvorlagen hinzu, die dem angegebenen HtmlTextWriter und Webserversteuerelement gerendert werden müssen. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von Style) |
| AddAttributesToRender(HtmlTextWriter) |
Fügt HTML-Attribute und -Formatvorlagen hinzu, die dem angegebenen Element HtmlTextWritergerendert werden müssen. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von Style) |
| CopyFrom(Style) |
Kopiert die Formateigenschaften des angegebenen Style Objekts in das aktuelle TreeNodeStyle Objekt. |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| Dispose() |
Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FillStyleAttributes(CssStyleCollection, IUrlResolutionService) |
Fügt die Formateigenschaften des angegebenen Objekts zu einem CssStyleCollection Objekt hinzu. (Geerbt von Style) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetService(Type) |
Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component) |
| GetStyleAttributes(IUrlResolutionService) |
Ruft das CssStyleCollection Objekt für das angegebene IUrlResolutionServiceimplementierte Objekt ab. (Geerbt von Style) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| LoadViewState(Object) |
Lädt den zuvor gespeicherten Zustand. (Geerbt von Style) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| MergeWith(Style) |
Kombiniert die Formateigenschaften des angegebenen Style Objekts mit den Formateigenschaften des aktuellen TreeNodeStyle Objekts. |
| Reset() |
Gibt das TreeNodeStyle Objekt in den ursprünglichen Zustand zurück. |
| SaveViewState() |
Eine geschützte Methode. Speichert alle Status, die geändert wurden, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von Style) |
| SetBit(Int32) |
Eine geschützte interne Methode. Legt ein internes Bitmaskenfeld fest, das die Formateigenschaften angibt, die im Zustandsbehälter gespeichert sind. (Geerbt von Style) |
| SetDirty() |
Kennzeichnet den Style Zustand so, dass sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Style) |
| TrackViewState() |
Eine geschützte Methode. Markiert den Anfang für die Nachverfolgung von Zustandsänderungen für das Steuerelement. Alle Änderungen, die nach dem Nachverfolgen vorgenommen wurden, werden im Rahmen des Ansichtszustands des Steuerelements nachverfolgt und gespeichert. (Geerbt von Style) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IStateManager.IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob ein Serversteuerelement seine Ansichtszustandsänderungen 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() |
Beginnt mit der Nachverfolgung von Zustandsänderungen. (Geerbt von Style) |