TextBoxBase.HideSelection Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TextBoxBase.cs

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

public:
 property bool HideSelection { bool get(); void set(bool value); };

public bool HideSelection { get; set; }

member this.HideSelection : bool with get, set

Public Property HideSelection As Boolean

Property Value

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.

Examples

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;

private:

   //Initialize TextBox1.
   void InitializeTextBox()
   {
      this->TextBox1 = gcnew TextBox;
      this->TextBox1->Location = System::Drawing::Point( 32, 24 );
      this->TextBox1->Name = "TextBox1";
      this->TextBox1->Size = 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;
      this->Controls->Add( TextBox1 );
   }

//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;
    this.Controls.Add(TextBox1);
}

'Declare a textbox called TextBox1.
Friend WithEvents TextBox1 As System.Windows.Forms.TextBox

'Initialize TextBox1.
Private Sub InitializeTextBox()
    Me.TextBox1 = New TextBox
    Me.TextBox1.Location = New System.Drawing.Point(32, 24)
    Me.TextBox1.Name = "TextBox1"
    Me.TextBox1.Size = New System.Drawing.Size(136, 20)
    Me.TextBox1.TabIndex = 1
    Me.TextBox1.Text = "Type and hit enter here..."

    'Keep the selection highlighted, even after textbox loses focus.
    TextBox1.HideSelection = False
    Me.Controls.Add(TextBox1)
End Sub

Remarks

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.