TextBoxBase.HideSelection Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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;

.NET Framework
Available since 1.1
Return to top