TreeView.SelectedNodeChanged イベント

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

TreeView.SelectedNodeChanged イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

TreeView コントロールのノードが選択されたときに発生します。

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

Visual Basic (宣言)

Public Event SelectedNodeChanged As
 EventHandler

Visual Basic (使用法)

Dim instance As TreeView
Dim handler As EventHandler

AddHandler instance.SelectedNodeChanged, handler

C#

public event EventHandler SelectedNodeChanged

C++

public:
event EventHandler^ SelectedNodeChanged {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

J#

/** @event */
public void add_SelectedNodeChanged (EventHandler
 value)

/** @event */
public void remove_SelectedNodeChanged (EventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

SelectedNodeChanged イベントは、TreeView コントロールのノードが選択されたときに発生します。これにより、このイベントが発生するたびにカスタム ルーチン (表示内容の更新など) を実行するイベント処理メソッドを提供できます。

オプションでノードの SelectAction プロパティを設定して、そのノードが選択されたときに発生するイベントを指定することもできます。利用可能なオプションの一覧を次の表に示します。

選択アクション	説明
Expand	ノードを展開した状態または折りたたんだ状態に切り替えます。TreeNodeExpanded イベントまたは TreeNodeCollapsed イベントを適宜発生させます。
None	ノードの選択時にイベントは発生しません。
Select	ノードの選択時に SelectedNodeChanged イベントを発生させます。
SelectExpand	ノードの選択時に SelectedNodeChanged イベントと TreeNodeExpanded イベントの両方を発生させます。ノードを展開することはできますが、折りたたむことはできません。

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

SelectedNodeChanged イベントは、ユーザーがノードをクリックしたときにポストバックでのみ発生します。SelectedNode プロパティがプログラムによって変更された場合、イベントは発生しません。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

SelectedNodeChanged イベントを使用して、TreeView コントロールのノードが選択されたときに Label コントロールを更新する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" %>

<script runat="server">

    Sub Select_Change(ByVal sender As
 Object, ByVal e As EventArgs)

        Message.Text = "You selected: " & LinksTreeView.SelectedNode.Text

    End Sub

</script>

<html>

    <body>
        <form runat="server">
        
            <h3>TreeView SelectedNodeStyle Example</h3>
            
            <asp:TreeView id="LinksTreeView"
                Font-Name= "Arial"
                ForeColor="Blue"
                SelectedNodeStyle-ForeColor="Green"
                SelectedNodeStyle-VerticalPadding="0"
                OnSelectedNodeChanged="Select_Change"
   
                runat="server">
                 
                <LevelStyles>
                
                    <asp:TreeNodeStyle ChildNodesPadding="10"
 
                        Font-Bold="true" 
                        Font-Size="12pt" 
                        ForeColor="DarkGreen"/>
                    <asp:TreeNodeStyle ChildNodesPadding="5"
 
                        Font-Bold="true" 
                        Font-Size="10pt"/>
                    <asp:TreeNodeStyle ChildNodesPadding="5"
 
                        Font-UnderLine="true" 
                        Font-Size="10pt"/>
                    <asp:TreeNodeStyle ChildNodesPadding="10"
 
                        Font-Size="8pt"/>
                         
                </LevelStyles>
                 
                <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 Text="Chapter Two">
                        
                            <asp:TreeNode Text="Section 2.0">
                            
                                <asp:TreeNode Text="Topic 2.0.1"/>
                                <asp:TreeNode Text="Topic 2.0.2"/>
                            
                            </asp:TreeNode>
                        
                        </asp:TreeNode>
                        
                    </asp:TreeNode>
                    <asp:TreeNode Text="Appendix A"
 />
                    <asp:TreeNode Text="Appendix B"
 />
                    <asp:TreeNode Text="Appendix C"
 />
                
                </Nodes>
                
            </asp:TreeView>
            
            <br><br>
            
            <asp:Label id="Message" runat="server"/>
            
        </form>
    </body>
</html>

C#

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

<script runat="server">

    void Select_Change(Object sender, EventArgs e)
    {

        Message.Text = "You selected: " + LinksTreeView.SelectedNode.Text;

    }

</script>

<html>

    <body>
        <form runat="server">
        
            <h3>TreeView SelectedNodeStyle Example</h3>

            <asp:TreeView id="LinksTreeView"
                Font-Name= "Arial"
                ForeColor="Blue"
                SelectedNodeStyle-ForeColor="Green"
                SelectedNodeStyle-VerticalPadding="0"
                OnSelectedNodeChanged="Select_Change"   
                runat="server">
                 
                <LevelStyles>
                
                    <asp:TreeNodeStyle ChildNodesPadding="10" 
                        Font-Bold="true" 
                        Font-Size="12pt" 
                        ForeColor="DarkGreen"/>
                    <asp:TreeNodeStyle ChildNodesPadding="5" 
                        Font-Bold="true" 
                        Font-Size="10pt"/>
                    <asp:TreeNodeStyle ChildNodesPadding="5" 
                        Font-UnderLine="true" 
                        Font-Size="10pt"/>
                    <asp:TreeNodeStyle ChildNodesPadding="10" 
                        Font-Size="8pt"/>
                         
                </LevelStyles>
                 
                <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 Text="Chapter Two">
                        
                            <asp:TreeNode Text="Section 2.0">
                            
                                <asp:TreeNode Text="Topic 2.0.1"/>
                                <asp:TreeNode Text="Topic 2.0.2"/>
                            
                            </asp:TreeNode>
                        
                        </asp:TreeNode>
                        
                    </asp:TreeNode>
                    <asp:TreeNode Text="Appendix A" />
                    <asp:TreeNode Text="Appendix B" />
                    <asp:TreeNode Text="Appendix C" />
                
                </Nodes>
                
            </asp:TreeView>
            
            <br><br>
            
            <asp:Label id="Message" runat="server"/>
            
        </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 名前空間
OnSelectedNodeChanged
その他の技術情報
イベントの利用