TreeView.HideSelection Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se o nó da árvore selecionado permanece destacado mesmo quando a vista em árvore perdeu 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 de Propriedade
true se o nó da árvore selecionado não for destacado quando a vista da árvore perdeu o foco; caso contrário, false. A predefinição é true.
Exemplos
O exemplo de código seguinte demonstra como usar a HideSelection propriedade. Para executar este exemplo, cole o código seguinte num formulário e chame o InitializeSelectedTreeView método no construtor ou Load handler 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
Observações
Quando esta propriedade é definida para false, os nós selecionados no TreeView controlo permanecem destacados numa cor diferente da cor atual quando o TreeView controlo perde o foco. Pode usar esta propriedade para manter os itens selecionados pelo utilizador visíveis quando este clica num controlo diferente no formulário ou se move para outra janela.
Note
Se estiver preocupado com a acessibilidade das suas aplicações, recomenda-se que defina a HideSelection propriedade para false.