TreeView.ShowCheckBoxes Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, które typy węzłów będą wyświetlać pole wyboru w TreeView kontrolce.Gets or sets a value indicating which node types will display a check box in the TreeView control.

public:
 property System::Web::UI::WebControls::TreeNodeTypes ShowCheckBoxes { System::Web::UI::WebControls::TreeNodeTypes get(); void set(System::Web::UI::WebControls::TreeNodeTypes value); };
public System.Web.UI.WebControls.TreeNodeTypes ShowCheckBoxes { get; set; }
member this.ShowCheckBoxes : System.Web.UI.WebControls.TreeNodeTypes with get, set
Public Property ShowCheckBoxes As TreeNodeTypes

Wartość właściwości

TreeNodeTypes

Bitowa kombinacja TreeNodeTypes wartości.A bitwise combination of the TreeNodeTypes values. Wartość domyślna to TreeNodeType.None.The default is TreeNodeType.None.

Wyjątki

Wartość kombinacji bitowej jest spoza zakresu TreeNodeTypes wyliczenia.The bitwise combination value is outside the range of the TreeNodeTypes enumeration.

Przykłady

Poniższy przykład kodu demonstruje, jak użyć właściwości, ShowCheckBoxes Aby pokazać i ukryć pola wyboru dla różnych typów węzłów.The following code example demonstrates how to use the ShowCheckBoxes property to show and hide the check boxes for the different node types.


<%@ 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 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView ShowCheckBoxes Example</title>
</head>
<body>
    <form id="form1" 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-Names= "Arial"
        ForeColor="Blue"
        ExpandDepth="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="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 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView ShowCheckBoxes Example</title>
</head>
<body>
    <form id="form1" 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-Names= "Arial"
        ForeColor="Blue"
        ExpandDepth="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>

Uwagi

Aby zapewnić obsługę wyboru przez wiele węzłów w TreeView formancie, można wyświetlić pola wyboru obok obrazu dla węzła.To provide multi-node selection support in the TreeView control, you can display check boxes next to the image for a node. Użyj ShowCheckBoxes właściwości, aby określić, które typy węzłów będą wyświetlane pole wyboru.Use the ShowCheckBoxes property to specify which node types will display a check box. Na przykład, jeśli ta właściwość jest ustawiona na TreeNodeType.Parent , pola wyboru są wyświetlane dla każdego węzła nadrzędnego w drzewie.For example, if this property is set to TreeNodeType.Parent, check boxes are displayed for each parent node in the tree. Poniższa tabela zawiera listę prawidłowych wartości dla tej właściwości.The following table lists the valid values for this property.

Typ węzłaNode type OpisDescription
TreeNodeType.All Pola wyboru są wyświetlane dla wszystkich węzłów.Check boxes are displayed for all nodes.
TreeNodeType.Leaf Pola wyboru są wyświetlane dla wszystkich węzłów liścia.Check boxes are displayed for all leaf nodes.
TreeNodeType.None Nie są wyświetlane pola wyboru.Check boxes are not displayed.
TreeNodeType.Parent Pola wyboru są wyświetlane dla wszystkich węzłów nadrzędnych.Check boxes are displayed for all parent nodes.
TreeNodeType.Root Pola wyboru są wyświetlane dla wszystkich węzłów głównych.Check boxes are displayed for all root nodes.

Typ wyliczenia, który jest używany dla ShowCheckBoxes właściwości jest wyliczeniem flagi, które umożliwia łączenie wartości za pomocą operacji bitowych.The enumeration type that is used for the ShowCheckBoxes property is a flag enumeration, which allows you to combine values through bitwise operations. Na przykład aby wyświetlić pola wyboru dla węzłów nadrzędnych i liściowych, użyj operatora bitowego or, aby połączyć TreeNodeType.Parent wartości i TreeNodeType.Leaf .For example, to display check boxes for the parent and leaf nodes, use the bitwise OR operator to combine the TreeNodeType.Parent and TreeNodeType.Leaf values.

Aby określić, które węzły mają zaznaczone pole wyboru, wykonaj iterację w węzłach CheckedNodes kolekcji.To determine which nodes have their check box selected, iterate through the nodes of the CheckedNodes collection.

Uwaga

Ustawienie można zastąpić ShowCheckBoxes przez ustawienie ShowCheckBox właściwości dla każdego węzła.You can override the ShowCheckBoxes setting by setting the ShowCheckBox property for each node.

Jeśli musisz zapewnić obsługę tylko jednego wyboru, rozważ użycie SelectedNode właściwości.If you need to provide only single-selection support, consider using the SelectedNode property.

Wartość tej właściwości jest przechowywana w stanie widoku.The value of this property is stored in view state.

Dotyczy

Zobacz też