TreeNode.ShowCheckBox Propriedade

Definição

Obtém ou define um valor que indica se uma caixa de seleção é exibida ao lado do nó.Gets or sets a value that indicates whether a check box is displayed next to the node.

public:
 property Nullable<bool> ShowCheckBox { Nullable<bool> get(); void set(Nullable<bool> value); };
public bool? ShowCheckBox { get; set; }
member this.ShowCheckBox : Nullable<bool> with get, set
Public Property ShowCheckBox As Nullable(Of Boolean)

Valor da propriedade

Nullable<Boolean>

true para exibir a caixa de seleção; caso contrário, false.true to display the check box; otherwise, false.

Exemplos

O exemplo de código a seguir demonstra como usar a ShowCheckBox propriedade para mostrar e ocultar programaticamente a caixa de seleção de um nó no TreeView controle.The following code example demonstrates how to use the ShowCheckBox property to programmatically show and hide the check box for a node in the TreeView control. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo para um arquivo chamado Book.xml.For this example to work correctly, you must copy the sample XML data below to a file named Book.xml.


<%@ 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 Data_Bound(Object sender, TreeNodeEventArgs e)
  {

    // Determine the depth of a node as it is bound to data.
    // If the depth is 1, show a check box.
    if(e.Node.Depth == 1)
    {

      e.Node.ShowCheckBox = true;

    }
    else
    {

      e.Node.ShowCheckBox = false;

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNode ShowCheckBox Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNode ShowCheckBox Example</h3>
    
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         OnTreeNodeDataBound="Data_Bound"
         ShowCheckBoxes="None"
         ExpandDepth="2"  
         runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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 Data_Bound(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    ' Determine the depth of a node as it is bound to data.
    ' If the depth is 1, show a check box.
    If e.Node.Depth = 1 Then

      e.Node.ShowCheckBox = True

    Else

      e.Node.ShowCheckBox = False

    End If

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNode ShowCheckBox Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNode ShowCheckBox Example</h3>
    
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         OnTreeNodeDataBound="Data_Bound"
         ShowCheckBoxes="None"
         ExpandDepth="2"  
         runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

O código a seguir é um exemplo de dados XML para o exemplo anterior.The following code is sample XML data for the previous example.

<Book Title="Book Title">  
    <Chapter Heading="Chapter 1">  
        <Section Heading="Section 1">  
        </Section>  
        <Section Heading="Section 2">  
        </Section>  
    </Chapter>  
    <Chapter Heading="Chapter 2">  
        <Section Heading="Section 1">  
        </Section>  
    </Chapter>  
</Book>  

Comentários

O TreeView controle permite que você exiba uma caixa de seleção ao lado da imagem de um nó.The TreeView control allows you to display a check box next to a node's image. Use a ShowCheckBox propriedade para mostrar ou ocultar a caixa de seleção do nó atual.Use the ShowCheckBox property to show or hide the check box for the current node.

Embora a ShowCheckBox Propriedade possa ser usada para exibir caixas de seleção, é mais comum usar a TreeView.ShowCheckBoxes Propriedade do TreeView controle.Although the ShowCheckBox property can be used to display check boxes, it is more common to use the TreeView.ShowCheckBoxes property of the TreeView control. A TreeView.ShowCheckBoxes propriedade, no entanto, afeta cada tipo de nó especificado pela propriedade; portanto, a TreeNode.ShowCheckBox propriedade é geralmente usada para substituir essa configuração para um nó individual.The TreeView.ShowCheckBoxes property, however, affects every node type specified by the property; therefore, the TreeNode.ShowCheckBox property is often used to override that setting for an individual node.

Como a TreeView.ShowCheckBoxes propriedade é de três Estados, o seguinte trecho de código C# causa um erro de compilação:Since the TreeView.ShowCheckBoxes property is a tri-state property, the following C# code snippet causes a compile error:

protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)  
{  
if (TreeView1.Nodes[0].Expanded)  
{  
// some work here   
}  
}  

Embora o VB.Net converta implicitamente o Boolean valor em a NullableBoolean , o C# não faz isso.While VB.Net implicitly casts the Boolean value to a NullableBoolean, C# does not. Portanto, é uma prática recomendada verificar explicitamente o estado da propriedade.Therefore, it is a best practice to explicitly check the state of the property. Por exemplo, os exemplos de código a seguir em Visual Basic e C# testam explicitamente o valor da Expanded propriedade.For example, the following code examples in Visual Basic and C# explicitly test the value of the Expanded property.

O exemplo de código a seguir Visual Basic testa explicitamente o valor da Expanded propriedade.The following Visual Basic code example explicitly tests the value of the Expanded property. Este exemplo testa se a Expanded propriedade é definida como True ; portanto, Nothing e False percorrem a If instrução.This example tests if the Expanded property is set to True; therefore Nothing and False fall through the If statement.

If TreeView1.Nodes(0).Expanded = True Then 'some work hereEnd IF  

Este exemplo de código C# testa explicitamente o valor da Expanded propriedade.This C# code example explicitly tests the value of the Expanded property. Este exemplo testa se a Expanded propriedade é definida como True ; portanto, Null e False percorrem a If instrução.This example tests if the Expanded property is set to True; therefore Null and False fall through the If statement.

if( TreeView1.Nodes[0].Expanded == true ) { //some work here}  

O valor dessa propriedade é armazenado em estado de exibição.The value of this property is stored in view state.

Aplica-se a

Confira também