TreeNodeStyle Класс

Определение

Представляет стиль узла в элементе управления TreeView.Represents the style of a node in the TreeView control.

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
Наследование

Примеры

В следующем примере кода показано, как управлять внешними узлами в TreeView элементе управления путем задания свойств TreeNodeStyle стиля объекта ParentNodeStyle , возвращаемого свойством.The following code example demonstrates how to control the appearance of the parent nodes in the TreeView control by setting the style properties of the TreeNodeStyle object that is returned from the ParentNodeStyle property.


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

Комментарии

Используйте класс для представления стиля узла TreeView в элементе управления. TreeNodeStyleUse the TreeNodeStyle class to represent the style of a node in the TreeView control. TreeView Элемент управления позволяет задавать различные характеристики стиля (например, размер и цвет шрифта) для каждого типа узла.The TreeView control allows you to specify different style characteristics (such as font size and color) for each of the different node types.

В следующей таблице перечислены стили узлов, поддерживаемые TreeNodeStyle классом.The following table lists the node styles that are supported by the TreeNodeStyle class.

Свойство стиля узлаNode style property ОписаниеDescription
HoverNodeStyle Параметры стиля для узла, когда на него наведен указатель мыши.The style settings for a node when the mouse pointer is positioned over it.
LeafNodeStyle Параметры стиля для конечных узлов.The style settings for the leaf nodes.
NodeStyle Параметры стиля по умолчанию для узла.The default style settings for a node.
ParentNodeStyle Параметры стиля для родительских узлов.The style settings for the parent nodes.
RootNodeStyle Параметры стиля для корневого узла.The style settings for the root node.
SelectedNodeStyle Параметры стиля для выбранного узла.The style settings for a selected node.

При задании свойств TreeView стиля узла элемента управления они применяются в следующем порядке:When you set the node style properties of the TreeView control, they are applied in the following order:

  1. NodeStyle.NodeStyle.

  2. RootNodeStyle, ParentNodeStyle илиLeafNodeStyle, в зависимости от типа узла.RootNodeStyle, ParentNodeStyle, or LeafNodeStyle, depending on the node type.

  3. LevelStyles.LevelStyles.

  4. SelectedNodeStyle.SelectedNodeStyle.

  5. HoverNodeStyle.HoverNodeStyle.

Класс наследует большинство его членов Style от класса. TreeNodeStyleThe TreeNodeStyle class inherits most of its members from the Style class. Он расширяет Style класс, предоставляя свойства, управляющие объемом пространства вокруг текста в узле, а также пространство между смежными узлами.It extends the Style class by providing properties that control the amount of space around the text in a node, as well as the space between adjacent nodes. HorizontalPadding Используйте свойство, чтобы управлять объемом пространства слева и справа от текста в узле.Use the HorizontalPadding property to control the amount of space to the left and right of the text in a node. Аналогично, VerticalPadding свойство управляет объемом пространства выше и ниже текста в узле.Similarly, the VerticalPadding property controls the amount of space above and below the text in a node. Можно управлять расстоянием между узлом, к которому применен объект TreeNodeStyle , и его соседними узлами, NodeSpacing задавая свойство.You can control the amount of spacing between the node that the TreeNodeStyle is applied to and its adjacent nodes by setting the NodeSpacing property. Чтобы управлять расстоянием между родительским и дочерним узлами, используйте ChildNodesPadding свойство.To control the amount of spacing between a parent node and a child node, use the ChildNodesPadding property.

Дополнительные сведения о наследуемых параметрах стиля см Style. в разделе.For more information about the inherited style settings, see Style.

Конструкторы

TreeNodeStyle()

Инициализирует новый экземпляр класса TreeNodeStyle.Initializes a new instance of the TreeNodeStyle class.

TreeNodeStyle(StateBag)

Инициализирует новый экземпляр класса TreeNodeStyle с заданными сведениями об объекте StateBag.Initializes a new instance of the TreeNodeStyle class with the specified StateBag object information.

Свойства

BackColor

Получает или задает цвет фона серверного веб-элемента управления.Gets or sets the background color of the Web server control.

(Унаследовано от Style)
BorderColor

Получает или задает цвет границы для серверного веб-элемента управления.Gets or sets the border color of the Web server control.

(Унаследовано от Style)
BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.Gets or sets the border style of the Web server control.

(Унаследовано от Style)
BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.Gets or sets the border width of the Web server control.

(Унаследовано от Style)
CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
ChildNodesPadding

Получает или задает пространство между родительским и дочерним узлом, к которым применяется класс TreeNodeStyle.Gets or sets the amount of space between a parent node and a child node to which the TreeNodeStyle class is applied.

Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
CssClass

Получает или задает класс каскадных таблицы стилей (CSS), отрисовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client.

(Унаследовано от Style)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.Gets the font properties associated with the Web server control.

(Унаследовано от Style)
ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Унаследовано от Style)
Height

Получает или задает высоту серверного веб-элемента управления.Gets or sets the height of the Web server control.

(Унаследовано от Style)
HorizontalPadding

Получает или задает число отступа справа и слева от текста в узле.Gets or sets the amount of space to the left and right of the text in the node.

ImageUrl

Получает или задает URL-адрес изображения для отображения рядом с текстом узла.Gets or sets the URL to an image that is displayed next to the node.

IsEmpty

Защищенное свойство.A protected property. Получает значение, которое указывает, были ли определены в наборе состояний какие-либо элементы стиля.Gets a value indicating whether any style elements have been defined in the state bag.

(Унаследовано от Style)
IsTrackingViewState

Получает значение, позволяющее определить, были ли определены в наборе состояний какие-либо элементы стиля.Returns a value indicating whether any style elements have been defined in the state bag.

(Унаследовано от Style)
NodeSpacing

Получает или задает вертикальный отступ между узлом, к которому применен объект TreeNodeStyle, а также его смежными узлами.Gets or sets the amount of vertical spacing between the node to which the TreeNodeStyle object is applied and its adjacent nodes.

RegisteredCssClass

Возвращает класс каскадных таблиц стилей (CSS), зарегистрированный с использованием элемента управления.Gets the cascading style sheet (CSS) class that is registered with the control.

(Унаследовано от Style)
Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
VerticalPadding

Получает или задает число отступа сверху и снизу от текста узла.Gets or sets the amount of space above and below the text for a node.

ViewState

Получает или задает набор состояний, в котором хранятся элементы стиля.Gets the state bag that holds the style elements.

(Унаследовано от Style)
Width

Получает или задает ширину серверного веб-элемента управления.Gets or sets the width of the Web server control.

(Унаследовано от Style)

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriter.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от Style)
AddAttributesToRender(HtmlTextWriter, WebControl)

Добавляет атрибуты и стили HTML, которые нужно обработать для просмотра в указанном элементе управления HtmlTextWriter, а также серверном веб-элементе управления.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter and Web server control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от Style)
CopyFrom(Style)

Копирует свойства стиля указанного объекта Style в текущий объект TreeNodeStyle.Copies the style properties of the specified Style object into the current TreeNodeStyle object.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Унаследовано от Component)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)

Добавляет свойства стиля указанного объекта в объект CssStyleCollection.Adds the specified object's style properties to a CssStyleCollection object.

(Унаследовано от Style)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetStyleAttributes(IUrlResolutionService)

Извлекает объект CssStyleCollection для заданного объекта, реализующего интерфейс IUrlResolutionService.Retrieves the CssStyleCollection object for the specified IUrlResolutionService-implemented object.

(Унаследовано от Style)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
LoadViewState(Object)

Загружает сохраненное ранее состояние.Loads the previously saved state.

(Унаследовано от Style)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
MergeWith(Style)

Совмещает свойства стиля указанного объекта Style со свойствами стиля текущего объекта TreeNodeStyle.Combines the style properties of the specified Style object with the style properties of the current TreeNodeStyle object.

Reset()

Возвращает объект TreeNodeStyle в исходное состояние.Returns the TreeNodeStyle object to its original state.

SaveViewState()

Защищенный метод.A protected method. Сохраняет все состояния, претерпевшие изменения после вызова метода TrackViewState().Saves any state that has been modified after the TrackViewState() method was invoked.

(Унаследовано от Style)
SetBit(Int32)

Защищенный внутренний метод.A protected internal method. Задает внутреннюю битовую маску, которая позволяет определить свойства стиля, сохраненные в наборе состояний.Sets an internal bitmask field that indicates the style properties that are stored in the state bag.

(Унаследовано от Style)
SetDirty()

Обозначает объект Style для записи его состояния в данные о состоянии представления.Marks the Style so that its state will be recorded in view state.

(Унаследовано от Style)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Style)
TrackViewState()

Защищенный метод.A protected method. Обозначает начало отслеживания изменений состояния в элементе управления.Marks the beginning for tracking state changes on the control. Любые изменения, внесенные с момента начала отслеживания, сохраняются в данных о состоянии представления элемента управления.Any changes made after tracking has begun will be tracked and saved as part of the control view state.

(Унаследовано от Style)

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

Явные реализации интерфейса

IStateManager.IsTrackingViewState

Получает значение, позволяющее определить, отслеживается ли изменение состояния представления серверного элемента управления.Gets a value that indicates whether a server control is tracking its view state changes.

(Унаследовано от Style)
IStateManager.LoadViewState(Object)

Загружает сохраненное ранее состояние.Loads the previously saved state.

(Унаследовано от Style)
IStateManager.SaveViewState()

Возвращает объект, содержащий данные об изменении состояния.Returns the object containing state changes.

(Унаследовано от Style)
IStateManager.TrackViewState()

Запускает отслеживание изменений состояния.Starts tracking state changes.

(Унаследовано от Style)

Применяется к

Дополнительно