TreeView.HideSelection Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o nó de árvore selecionado permanece realçado mesmo quando o modo de exibição de árvore perde o foco.

public:
 property bool HideSelection { bool get(); void set(bool value); };

public bool HideSelection { get; set; }

member this.HideSelection : bool with get, set

Public Property HideSelection As Boolean

Valor da propriedade

Boolean

true se o nó de árvore selecionado não ficar realçado quando o modo de exibição de árvore perder o foco; caso contrário, false. O padrão é true.

Exemplos

O exemplo de código a seguir demonstra como usar a HideSelection propriedade . Para executar este exemplo, cole o código a seguir em um formulário e chame o InitializeSelectedTreeView método no construtor ou Load manipulador de eventos do formulário.

System::Windows::Forms::TreeView^ TreeView2;

// Initialize the TreeView to blend with the form, giving it the 
// same color as the form and no border.
void InitializeSelectedTreeView()
{
   
   // Create a new TreeView control and set the location and size.
   this->TreeView2 = gcnew System::Windows::Forms::TreeView;
   this->TreeView2->Location = System::Drawing::Point( 72, 48 );
   this->TreeView2->Size = System::Drawing::Size( 200, 200 );
   this->TreeView2->BorderStyle = BorderStyle::Fixed3D;
   
   // Set the HideSelection property to false to keep the 
   // selection highlighted when the user leaves the control. 
   this->TreeView1->HideSelection = false;
   
   // Add the nodes.
   array<TreeNode^>^temp0 = {gcnew TreeNode( "Full Color" ),gcnew TreeNode( "Project Wizards" ),gcnew TreeNode( "Visual C# and Visual Basic Support" )};
   array<TreeNode^>^temp1 = {gcnew TreeNode( "Pentium 133 MHz or faster processor " ),gcnew TreeNode( "Windows 98 or later" ),gcnew TreeNode( "100 MB Disk space" )};
   array<TreeNode^>^temp2 = {gcnew TreeNode( "Features",temp0 ),gcnew TreeNode( "System Requirements",temp1 )};
   this->TreeView1->Nodes->AddRange( temp2 );
   
   // Set the tab index and add the TreeView to the form.
   this->TreeView1->TabIndex = 0;
   this->Controls->Add( this->TreeView1 );
}

// Declare the TreeView control.
internal System.Windows.Forms.TreeView TreeView2;

// Initialize the TreeView to blend with the form, giving it the 
// same color as the form and no border.
private void InitializeSelectedTreeView()
{

    // Create a new TreeView control and set the location and size.
    this.TreeView2 = new System.Windows.Forms.TreeView();
    this.TreeView2.Location = new System.Drawing.Point(72, 48);
    this.TreeView2.Size = new System.Drawing.Size(200, 200);

    this.TreeView2.BorderStyle = BorderStyle.Fixed3D;
    
    // Set the HideSelection property to false to keep the 
    // selection highlighted when the user leaves the control. 
    // This helps it blend with form.
    this.TreeView2.HideSelection = false;

    // Add the nodes.
    this.TreeView2.Nodes.AddRange(new TreeNode[]
        {new TreeNode("Features", 
            new TreeNode[]{
            new TreeNode("Full Color"), 
            new TreeNode("Project Wizards"), 
            new TreeNode("Visual C# and Visual Basic Support")}), 
            new TreeNode("System Requirements", 
            new TreeNode[]{
                new TreeNode("Pentium 133 MHz or faster processor "),
                new TreeNode("Windows 98 or later"), 
                new TreeNode("100 MB Disk space")})
        });

    // Set the tab index and add the TreeView to the form.
    this.TreeView2.TabIndex = 0;
    this.Controls.Add(this.TreeView2);
}

' Declare the TreeView control.
Friend WithEvents TreeView2 As System.Windows.Forms.TreeView

' Initialize the TreeView to blend with the form, giving it the 
' same color as the form and no border.
Private Sub InitializeSelectedTreeView()

    ' Create a new TreeView control and set the location and size.
    Me.TreeView2 = New System.Windows.Forms.TreeView
    Me.TreeView2.Location = New System.Drawing.Point(72, 48)
    Me.TreeView2.Size = New System.Drawing.Size(200, 200)
    Me.TreeView2.BorderStyle = BorderStyle.Fixed3D
   
    ' Set the HideSelection property to false to keep the 
    ' selection highlighted when the user leaves the control. 
    Me.TreeView2.HideSelection = False

    ' Add the nodes.
    Me.TreeView2.Nodes.AddRange(New System.Windows.Forms.TreeNode() _
        {New System.Windows.Forms.TreeNode("Features", _
        New System.Windows.Forms.TreeNode() _
        {New System.Windows.Forms.TreeNode("Full Color"), _
        New System.Windows.Forms.TreeNode("Project Wizards"), _
        New System.Windows.Forms.TreeNode("Visual C# and Visual Basic Support")}), _
        New System.Windows.Forms.TreeNode("System Requirements", _
        New System.Windows.Forms.TreeNode() _
        {New System.Windows.Forms.TreeNode _
        ("Pentium 133 MHz or faster processor "), _
        New System.Windows.Forms.TreeNode("Windows 98 or later"), _
        New System.Windows.Forms.TreeNode("100 MB Disk space")})})

    ' Set the tab index and add the TreeView to the form.
    Me.TreeView2.TabIndex = 0
    Me.Controls.Add(Me.TreeView2)
End Sub

Comentários

Quando essa propriedade é definida falsecomo , os TreeView nós selecionados no controle permanecem realçados em uma cor diferente da cor de seleção atual quando o controle perde o TreeView foco. Você pode usar essa propriedade para manter os itens selecionados pelo usuário visíveis quando o usuário clica em um controle diferente no formulário ou se move para uma janela diferente.

Observação

Se você estiver preocupado com a acessibilidade de seus aplicativos, é recomendável definir a HideSelection propriedade falsecomo .

Confira também

• SelectedNode