Freigeben über

TreeView.HideSelection-Eigenschaft

  • Artikel

Ruft einen Wert ab, der angibt, ob der ausgewählte Strukturknoten auch dann markiert bleibt, wenn die Strukturansicht den Fokus verliert, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property HideSelection As Boolean
'Usage
Dim instance As TreeView
Dim value As Boolean

value = instance.HideSelection

instance.HideSelection = value

public bool HideSelection { get; set; }

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

/** @property */
public boolean get_HideSelection ()

/** @property */
public void set_HideSelection (boolean value)

public function get HideSelection () : boolean

public function set HideSelection (value : boolean)

Eigenschaftenwert

true, wenn der ausgewählte Strukturknoten nicht markiert ist, wenn die Strukturansicht den Fokus verliert, andernfalls false. Der Standardwert ist true.

Hinweise

Wenn diese Eigenschaft auf false festgelegt ist und das TreeView-Steuerelement nicht mehr den Fokus besitzt, bleiben ausgewählte Knoten im TreeView-Steuerelement weiterhin mit einer anderen Farbe als der aktuellen Farbe für die Auswahl hervorgehoben. Mit dieser Eigenschaft können Sie vom Benutzer ausgewählte Elemente weiterhin sichtbar halten, wenn der Benutzer auf ein anderes Steuerelement im Formular klickt oder in ein anderes Fenster wechselt.

Hinweis

Wenn Sie Bedenken hinsichtlich der Zugreifbarkeit Ihrer Anwendungen haben, wird empfohlen, die HideSelection-Eigenschaft auf false festzulegen.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der HideSelection-Eigenschaft veranschaulicht. Zum Ausführen dieses Beispiels fügen Sie folgenden Code in ein Formular ein, und rufen Sie die InitializeSelectedTreeView-Methode im Konstruktor oder im Load-Ereignishandler des Formulars auf.

' 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

// 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.
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.set_Location(new System.Drawing.Point(72, 48));
    this.treeView2.set_Size(new System.Drawing.Size(200, 200));
    
    // Set the BorderStyle property to none, the BackColor property to
    // the form's backcolor, and the Scrollable property to false.  
    // This allows the TreeView to blend in form.
    this.treeView2.set_BorderStyle(BorderStyle.Fixed3D);
           
    // Set the HideSelection property to false to keep the 
    // selection highlighted when the user leaves the control. 
    this.treeView2.set_HideSelection(false);
   
    // Add the nodes.
    this.treeView2.get_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.set_TabIndex(0);
    this.get_Controls().Add(this.treeView2);
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TreeView-Klasse
TreeView-Member
System.Windows.Forms-Namespace
SelectedNode