This documentation is archived and is not being maintained.

TextBoxBase.HideSelection Property

Gets or sets a value indicating whether the selected text in the text box control remains highlighted when the control loses focus.

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

public bool HideSelection { get; set; }
/** @property */
public boolean get_HideSelection ()

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

public function get HideSelection () : boolean

public function set HideSelection (value : boolean)

Not applicable.

Property Value

true if the selected text does not appear highlighted when the text box control loses focus; false, if the selected text remains highlighted when the text box control loses focus. The default is true.

You can use this property to keep text highlighted in a text box control while another form or a dialog box has focus, such as a spelling checker dialog box.

The following code example demonstrates how to use the HideSelection property. To run the example, paste the following code in a form. Call the InitializeTextBox method in the form's constructor or Load method.

//Declare a textbox called TextBox1.
internal System.Windows.Forms.TextBox TextBox1;

//Initialize TextBox1.
private void InitializeTextBox()
    this.TextBox1 = new TextBox();
    this.TextBox1.Location = new System.Drawing.Point(32, 24);
    this.TextBox1.Name = "TextBox1";
    this.TextBox1.Size = new System.Drawing.Size(136, 20);
    this.TextBox1.TabIndex = 1;
    this.TextBox1.Text = "Type and hit enter here...";

    //Keep the selection highlighted, even after textbox loses focus.
    TextBox1.HideSelection = false;

//Declare a textbox called TextBox1.
System.Windows.Forms.TextBox textBox1;

//Initialize TextBox1.
private void InitializeTextBox()
    this.textBox1 = new TextBox();
    this.textBox1.set_Location(new System.Drawing.Point(32, 24));
    this.textBox1.set_Size(new System.Drawing.Size(136, 20));
    this.textBox1.set_Text("Type and hit enter here...");
    //Keep the selection highlighted, even after textbox loses focus.
} //InitializeTextBox

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0