Export (0) Print
Expand All

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 version 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
            return tabStop;
            if (TabStop != value)
                tabStop = value;

    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, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

© 2015 Microsoft