TreeView.HoverNodeStyle プロパティ

.NET Framework クラス ライブラリ リファレンス

TreeView.HoverNodeStyle プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

マウス ポインタが上に置かれているときのノードの外観を設定できる、TreeNodeStyle オブジェクトへの参照を取得します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 HoverNodeStyle As Style

Visual Basic (使用法)

Dim instance As TreeView
Dim value As Style

value = instance.HoverNodeStyle

C#

public Style HoverNodeStyle { get; }

C++

public:
property Style^ HoverNodeStyle {
    Style^ get ();
}

J#

/** @property */
public Style get_HoverNodeStyle ()

JScript

public function get HoverNodeStyle
 () : Style

プロパティ値
マウス ポインタが上に置かれているときのノードのスタイルを表す TreeNodeStyle への参照。

解説

マウス ポインタが上に置かれているときのノードの外観を制御するには、HoverNodeStyle プロパティを使用します。このプロパティは読み取り専用です。ただし、このプロパティが返す TreeNodeStyle オブジェクトのプロパティを設定することはできます。このプロパティは、Property-Subproperty の形式で、宣言によって設定できます。Subproperty には、TreeNodeStyle オブジェクトのプロパティを指定します (例 : HoverNodeStyle-ForeColor)。Property.Subproperty の形式で、プロパティをプログラムによって設定することもできます (例 : HoverNodeStyle.ForeColor)。この機能は、スクリプト対応のクライアントでのみサポートされています。

メモ
HoverNodeStyle プロパティを使用するには、runat="server" 属性を持つ <head> 要素を含める必要があります。

通常、共通設定にはカスタムの背景色、前景色、フォントのプロパティ、およびノードのスペーシングが含まれます。スタイル プロパティは、次の順序に従って適用されます。

1. NodeStyle.

2. ノード型に応じて、RootNodeStyle、ParentNodeStyle、または LeafNodeStyle。LevelStyles コレクションが定義されている場合は、この時点で適用され、他のノード スタイル プロパティをオーバーライドします。

3. SelectedNodeStyle.

4. HoverNodeStyle.

メモ
HoverNodeStyle プロパティのスタイル設定は、NodeStyle、RootNodeStyle、ParentNodeStyle、LeafNodeStyle、または SelectedNodeStyle の各プロパティ内にある対応する任意のノード スタイル設定をオーバーライドします。

HoverNodeStyle プロパティは、SelectAction プロパティが TreeNodeSelectAction.None に設定されているノードでは表示されません。

TreeNodeStyle オブジェクトである ParentNodeStyle プロパティおよび LeafNodeStyle プロパティとは異なり、HoverNodeStyle プロパティは Style オブジェクトです。

使用例

HoverNodeStyle プロパティを使用して、マウス ポインタが上に置かれているときのノードの外観を制御する方法を次のコード例に示します。この例を正常に動作させるには、runat="server" 属性を持つ <head> 要素を含める必要があります。

Visual Basic

<%@ Page Language="VB" %>

<html>

  <!-- The HoverNodeStyle property needs this head element
 to work. -->
  <head runat="server">

  </head>

  <body>
    <form runat="server">
    
      <h3>TreeView HoverNodeStyle Example</h3>
      
      <!-- Declaratively set the HoverNodeStyle settings. -->
 
      <asp:TreeView id="LinksTreeView"
        HoverNodeStyle-ForeColor="Green"
        HoverNodeStyle-VerticalPadding="0"  
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>

C#

<%@ Page Language="C#" %>

<html>

  <!-- The HoverNodeStyle property needs this head element
 to work. -->
  <head runat="server">

  </head>

  <body>
    <form runat="server">
    
      <h3>TreeView HoverNodeStyle Example</h3>
      
      <!-- Declaratively set the HoverNodeStyle settings. -->
 
      <asp:TreeView id="LinksTreeView"
        HoverNodeStyle-ForeColor="Green"
        HoverNodeStyle-VerticalPadding="0"  
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TreeView クラス
TreeView メンバ
System.Web.UI.WebControls 名前空間
TreeNodeStyle クラス
LeafNodeStyle
NodeStyle
ParentNodeStyle
RootNodeStyle
SelectedNodeStyle
LevelStyles