SplitContainer.TabStop Property

Gets or sets a value indicating whether the user can give the focus to the splitter using the TAB key.

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

public bool TabStop { get; set; }

Property Value

Type: System.Boolean
true if the user can give the focus to the splitter using the TAB key; otherwise, false. The default is true.

When the user presses the TAB key, the input focus is set to the next control in the tab order of the form. Set TabStop to true to give input focus to a splitter so that it can be moved with the arrow keys as well as with the mouse. Starting in the .NET Framework 4, setting TabStop to false excludes the splitter and any of the controls that are contained in the SplitContainer from the collection of controls in the tab order. To enable controls to get focus by using the TAB key, create a control that inherits from SplitContainer. Create a new property named TabStop and override the ProcessTabKey method. The following example demonstrates how to accomplish this.

public class MySplitContainer : SplitContainer
{
    private bool tabStop = true;
    public new bool TabStop
    {
        get
        {
            return tabStop;
        }
        set
        {
            if (TabStop != value)
            {
                tabStop = value;
                OnTabStopChanged(EventArgs.Empty);
            }
        }
    }

    protected override bool ProcessTabKey(bool forward)
    {
        if (!tabStop)
        {
            if (SelectNextControl(ActiveControl, forward, true, true, false)) return true;
        }
        return base.ProcessTabKey(forward);
    }
}

You can manipulate the tab order by setting the control's TabIndex property value.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft