Export (0) Print
Expand All

TreeView.Scrollable Property

Gets or sets a value indicating whether the tree view control displays scroll bars when they are needed.

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

public bool Scrollable { get; set; }
/** @property */
public boolean get_Scrollable ()

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

public function get Scrollable () : boolean

public function set Scrollable (value : boolean)

Property Value

true if the tree view control displays scroll bars when they are needed; otherwise, false. The default is true.

If this property is set to true, scroll bars are displayed on the TreeView when any TreeNode is located outside the control's client region.

NoteNote

When setting the Scrollable property at run time, the TreeView handle is recreated (see Control.RecreateHandle) to update the control's appearance. This causes all tree nodes to be collapsed, with the exception of the selected TreeNode.

The following code example demonstrates how to use the BorderStyle enumeration and the BorderStyle, ShowLines, Scrollable, HideSelection and ShowRootLines properties. To run this example, paste the following code in a form and call the InitializeTreeView method in the form's constructor or Load method.


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

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

    // Create a new TreeView control and set the location and size.
    this.TreeView1 = new System.Windows.Forms.TreeView();
    this.TreeView1.Location = new System.Drawing.Point(72, 48);
    this.TreeView1.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.TreeView1.BorderStyle = BorderStyle.None;
    this.TreeView1.BackColor = this.BackColor;
    this.TreeView1.Scrollable = false;

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

    // Set the ShowRootLines and ShowLines properties to false to 
    // give the TreeView a list-like appearance.
    this.TreeView1.ShowRootLines = false;
    this.TreeView1.ShowLines = false;

    // Add the nodes.
    this.TreeView1.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.TreeView1.TabIndex = 0;
    this.Controls.Add(this.TreeView1);
}

// Declare the TreeView control.
System.Windows.Forms.TreeView treeView1;

// Initialize the TreeView to blend with the form, giving it the 
// same color as the form and no border.
private void InitializeTreeView()
{
    // Create a new TreeView control and set the location and size.
    this.treeView1 = new System.Windows.Forms.TreeView();
    this.treeView1.set_Location(new System.Drawing.Point(72, 48));
    this.treeView1.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.treeView1.set_BorderStyle(BorderStyle.None);
    this.treeView1.set_BackColor(this.get_BackColor());
    this.treeView1.set_Scrollable(false);
    // Set the HideSelection property to false to keep the 
    // selection highlighted when the user leaves the control. 
    // This helps it blend with form.
    this.treeView1.set_HideSelection(false);
    // Set the ShowRootLines and ShowLines properties to false to 
    // give the TreeView a list-like appearance.
    this.treeView1.set_ShowRootLines(false);
    this.treeView1.set_ShowLines(false);
    // Add the nodes.
    this.treeView1.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.treeView1.set_TabIndex(0);
    this.get_Controls().Add(this.treeView1);
} //InitializeTreeView

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft