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 System.Windows.Forms.dll)

public bool HideSelection { get; set; }

Property Value

Type: System.Boolean
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;
in a form. Call the InitializeTextBox method in the form's constructor or Load method.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0