TreeView.HideSelection 属性

定义

获取或设置一个值,用以指示选定的树节点是否即使在树视图已失去焦点时仍会保持突出显示。Gets or sets a value indicating whether the selected tree node remains highlighted even when the tree view has lost the focus.

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

属性值

如果选定的树节点在树视图已失去焦点时不突出显示,则为 true;否则为 falsetrue if the selected tree node is not highlighted when the tree view has lost the focus; otherwise, false. 默认为 trueThe default is true.

示例

下面的代码示例演示如何使用 HideSelection 属性。The following code example demonstrates how to use the HideSelection property. 若要运行此示例,请将以下代码粘贴到窗体中,并在窗体的构造函数或 Load 事件处理程序中调用 InitializeSelectedTreeView 方法。To run this example, paste the following code in a form and call the InitializeSelectedTreeView method in the form's constructor or Load event handler.

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

注解

如果将此属性设置为 false,在 TreeView 控件失去焦点时,TreeView 控件中的选定节点将保持突出显示,而不是当前选择的颜色。When this property is set to false, selected nodes in the TreeView control remain highlighted in a different color than the current selection color when the TreeView control loses focus. 当用户单击窗体上的其他控件或移到另一个窗口时,可以使用此属性来保留用户选择的项。You can use this property to keep items that are selected by the user visible when the user clicks a different control on the form or moves to a different window.

备注

如果你担心应用程序的可访问性,建议将 HideSelection 属性设置为 falseIf you are concerned with the accessibility of your applications, it is recommended that you set the HideSelection property to false.

适用于

另请参阅