TreeView.CheckedNodes プロパティ
メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。 選択したチェック ボックスを表示する TreeView コントロール内のノードを表す TreeNode オブジェクトのコレクションを取得します。 名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文 プロパティ値
選択したチェック ボックスを表示する TreeView 内のノードを格納する TreeNodeCollection。
選択したチェック ボックスを表示する TreeView 内のノードを格納する TreeNodeCollection。
解説ShowCheckBoxes プロパティを TreeNodeType.None 以外の値に設定することにより、TreeView コントロールにチェック ボックスが表示されている場合は、CheckedNodes プロパティを使用して、選択したチェック ボックスを表示するノードを確認します。通常、このコレクションは、選択されたチェック ボックスがツリー内にあるすべてのノードに対して反復処理をするために使用されます。
TreeView コントロールのチェック ボックスの状態がサーバーへの各ポストの間に変更されたときに、TreeNodeCheckChanged イベントが発生します。これにより、このイベントが発生したときに、データベースまたは表示内容の更新などのカスタム ルーチンを実行するイベント処理メソッドを提供できます。
.gif) メモ |
|---|
| CheckedNodes コレクションは、ツリー構造の深さ優先走査を使用して設定されます。次の親ノードにデータが設定される前に、各親ノードはその子のノードの処理に進みます。 |
使用例CheckedNodes プロパティを使用して、TreeView コントロール内に選択されたチェック ボックスがあるノードを確認する方法を次のコード例に示します。
<%@ Page Language="VB" %> <script runat="server"> Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) If LinksTreeView.CheckedNodes.Count > 0 Then ' Clear the message label. Message.Text = "You selected: <br><br>" ' Iterate through the CheckedNodes collection and display the selected nodes. Dim node As TreeNode For Each node In LinksTreeView.CheckedNodes Message.Text &= node.Text & "<br>" Next Else Message.Text = "No items selected." End If End Sub </script> <html> <body> <form runat="server"> <h3>TreeView ShowCheckBoxes Example</h3> <!-- Set the ShowCheckBoxes property declaratively. --> <!-- Because the ShowCheckBoxes property uses a flag --> <!-- enumeration, you can combine multiple values by --> <!-- using the bitwise OR operator. In declarative --> <!-- syntax, this is done using a comma separated --> <!-- list. --> <asp:TreeView id="LinksTreeView" Font-Name= "Arial" ForeColor="Blue" InitialExpandDepth="2" ShowCheckBoxes="Parent,Leaf" 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:Button id="Submit" Text="Select Items" OnClick="Button_Click" runat="server"/> <br><br> <asp:Label id="Message" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" %> <script runat="server"> void Button_Click(Object sender, EventArgs e) { if(LinksTreeView.CheckedNodes.Count > 0) { // Clear the message label. Message.Text = "You selected: <br><br>"; // Iterate through the CheckedNodes collection and display the selected nodes. foreach (TreeNode node in LinksTreeView.CheckedNodes) { Message.Text += node.Text + "<br>"; } } else { Message.Text = "No items selected."; } } </script> <html> <body> <form runat="server"> <h3>TreeView ShowCheckBoxes Example</h3> <!-- Set the ShowCheckBoxes property declaratively. --> <!-- Because the ShowCheckBoxes property uses a flag --> <!-- enumeration, you can combine multiple values by --> <!-- using the bitwise OR operator. In declarative --> <!-- syntax, this is done using a comma separated --> <!-- list. --> <asp:TreeView id="LinksTreeView" Font-Name= "Arial" ForeColor="Blue" InitialExpandDepth="2" ShowCheckBoxes="Parent,Leaf" 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:Button id="Submit" Text="Select Items" OnClick="Button_Click" runat="server"/> <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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- TreeView.CheckedNodes プロパティのページへのリンク
