TreeView::Scrollable Property
Gets or sets a value indicating whether the tree view control displays scroll bars when they are needed.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Property Value
Type: System::Booleantrue 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.
Note |
|---|
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; private: // Initialize the TreeView to blend with the form, giving it the // same color as the form and no border. void InitializeTreeView() { // Create a new TreeView control and set the location and size. this->TreeView1 = gcnew System::Windows::Forms::TreeView; this->TreeView1->Location = System::Drawing::Point( 72, 48 ); this->TreeView1->Size = 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. 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 ); }
Available since 1.1
