Export (0) Print
Expand All
Expand Minimize

ScrollBars Enumeration

Specifies which scroll bars will be visible on a control.

[Visual Basic]
<Serializable>
Public Enum ScrollBars
[C#]
[Serializable]
public enum ScrollBars
[C++]
[Serializable]
__value public enum ScrollBars
[JScript]
public
   Serializable
enum ScrollBars

Remarks

This enumeration is used by TextBox.ScrollBars.

Not all controls support scroll bars. Use this enumeration to specify which scroll bars will be visible on a control, either under some or all circumstances.

Members

Member name Description
Both

Supported by the .NET Compact Framework.

Both horizontal and vertical scroll bars are shown.
Horizontal

Supported by the .NET Compact Framework.

Only horizontal scroll bars are shown.
None

Supported by the .NET Compact Framework.

No scroll bars are shown.
Vertical

Supported by the .NET Compact Framework.

Only vertical scroll bars are shown.

Example

[Visual Basic, C#] The following code example demonstrates how to use the ScrollBars enumeration. To run the example, paste the following code in a form. Call the SetFourDifferentScrollBars method in the form's constructor or Load method.

[Visual Basic] 

    ' Declare four textboxes.
    Friend WithEvents vertical As System.Windows.Forms.TextBox
    Friend WithEvents horizontal As System.Windows.Forms.TextBox
    Friend WithEvents both As System.Windows.Forms.TextBox
    Friend WithEvents none As System.Windows.Forms.TextBox
        
    Private Sub SetFourDifferentScrollBars()

        Me.vertical = New System.Windows.Forms.TextBox
        Me.horizontal = New System.Windows.Forms.TextBox
        Me.both = New System.Windows.Forms.TextBox
        Me.none = New System.Windows.Forms.TextBox

        ' Create a string for the Text property.
        Dim startString As String = _
            "The scroll bar style for my textbox is: "

        ' Set the location of the four textboxes.
        horizontal.Location = New Point(10, 10)
        vertical.Location = New Point(10, 70)
        none.Location = New Point(10, 170)
        both.Location = New Point(10, 110)

        ' For horizonal scroll bars, the Multiline property must
        ' be true and the WordWrap property must be false.
        ' Increase the size of the Height property to ensure the 
        ' scroll bar is visible.
        horizontal.ScrollBars = ScrollBars.Horizontal
        horizontal.Multiline = True
        horizontal.WordWrap = False
        horizontal.Height = 40
        horizontal.Text = startString & ScrollBars.Horizontal.ToString()

        ' For the vertical scroll bar, Multiline must be true.
        vertical.ScrollBars = ScrollBars.Vertical
        vertical.Multiline = True
        vertical.Text = startString & ScrollBars.Vertical.ToString()

        ' For both scroll bars, the Multiline property 
        ' must be true, and the WordWrap property must be false.
        ' Increase the size of the Height property to ensure the 
        ' scroll bar is visible.
        both.ScrollBars = ScrollBars.Both
        both.Multiline = True
        both.WordWrap = False
        both.Height = 40
        both.AcceptsReturn = True
        both.Text = startString & ScrollBars.Both.ToString()

        ' The none scroll bar does not require specific 
        ' property settings.
        none.ScrollBars = ScrollBars.None
        none.Text = startString & ScrollBars.None.ToString()

        ' Add the textboxes to the form.
        Me.Controls.Add(Me.vertical)
        Me.Controls.Add(Me.horizontal)
        Me.Controls.Add(Me.both)
        Me.Controls.Add(Me.none)

    End Sub

[C#] 

    // Declare four textboxes.
    internal System.Windows.Forms.TextBox vertical;
    internal System.Windows.Forms.TextBox horizontal;
    internal System.Windows.Forms.TextBox both;
    internal System.Windows.Forms.TextBox none;

    private void SetFourDifferentScrollBars()
    {
        
        this.vertical = new System.Windows.Forms.TextBox();
        this.horizontal = new System.Windows.Forms.TextBox();
        this.both = new System.Windows.Forms.TextBox();
        this.none = new System.Windows.Forms.TextBox();

        // Create a string for the Text property.
        string startString = "The scroll bar style for my textbox is: ";

        // Set the location of the four textboxes.
        horizontal.Location = new Point(10, 10);
        vertical.Location = new Point(10, 70);
        none.Location = new Point(10, 170);
        both.Location = new Point(10, 110);

        // For horizonal scroll bars, the Multiline property must
        // be true and the WordWrap property must be false.
        // Increase the size of the Height property to ensure the 
        // scroll bar is visible.
        horizontal.ScrollBars = ScrollBars.Horizontal;
        horizontal.Multiline = true;
        horizontal.WordWrap = false;
        horizontal.Height = 40;
        horizontal.Text = startString + 
            ScrollBars.Horizontal.ToString();

        // For the vertical scroll bar, Multiline must be true.
        vertical.ScrollBars = ScrollBars.Vertical;
        vertical.Multiline = true;
        vertical.Text = startString + ScrollBars.Vertical.ToString();

        // For both scroll bars, the Multiline property 
        // must be true, and the WordWrap property must be false.
        // Increase the size of the Height property to ensure the 
        // scroll bar is visible.
        both.ScrollBars = ScrollBars.Both;
        both.Multiline = true;
        both.WordWrap = false;
        both.Height = 40;
        both.AcceptsReturn = true;
        both.Text = startString + ScrollBars.Both.ToString();

        // The none scroll bar does not require specific 
        // property settings.
        none.ScrollBars = ScrollBars.None;
        none.Text = startString + ScrollBars.None.ToString();

        // Add the textboxes to the form.
        this.Controls.Add(this.vertical);
        this.Controls.Add(this.horizontal);
        this.Controls.Add(this.both);
        this.Controls.Add(this.none);

    }

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Windows.Forms

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

See Also

System.Windows.Forms Namespace | TextBox

Show:
© 2014 Microsoft